@bitrix24/b24jssdk 1.2.0 → 1.3.0

package/dist/esm/core/http/limiters/manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"manager.mjs","sources":["../../../../../src/core/http/limiters/manager.ts"],"sourcesContent":["import type { RestrictionParams, RestrictionManagerStats } from '../../../types/limiters'\nimport type { LoggerInterface } from '../../../types/logger'\nimport { LoggerFactory } from '../../../logger'\nimport { RateLimiter } from './rate-limiter'\nimport { OperatingLimiter } from './operating-limiter'\nimport { AdaptiveDelayer } from './adaptive-delayer'\n\n/**\n * Delay Management Manager\n *\n * @todo docs\n */\nexport class RestrictionManager {\n  #rateLimiter: RateLimiter\n  #operatingLimiter: OperatingLimiter\n  #adaptiveDelayer: AdaptiveDelayer\n  #config: RestrictionParams\n  #stats: Pick<RestrictionManagerStats, 'retries' | 'consecutiveErrors' | 'limitHits'> = {\n    /** Retry attempts */\n    retries: 0,\n    /** Consecutive errors */\n    consecutiveErrors: 0,\n    /** Limit triggers */\n    limitHits: 0\n  }\n\n  #errorCounts = new Map<string, number>()\n\n  private _logger: LoggerInterface\n\n  constructor(params: RestrictionParams) {\n    this._logger = LoggerFactory.createNullLogger()\n    this.#config = params\n    this.#rateLimiter = new RateLimiter(params.rateLimit!)\n    this.#operatingLimiter = new OperatingLimiter(params.operatingLimit!)\n    this.#adaptiveDelayer = new AdaptiveDelayer(params.adaptiveConfig!, this.#operatingLimiter)\n  }\n\n  // region Logger ////\n  setLogger(logger: LoggerInterface): void {\n    this._logger = logger\n    this.#rateLimiter.setLogger(this._logger)\n    this.#operatingLimiter.setLogger(this._logger)\n    this.#adaptiveDelayer.setLogger(this._logger)\n  }\n\n  getLogger(): LoggerInterface {\n    return this._logger\n  }\n  // endregion ////\n\n  async applyOperatingLimits(requestId: string, method: string, params?: any): Promise<void> {\n    // 1. Check operating limit\n    const operatingWait = await this.#operatingLimiter.waitIfNeeded(requestId, method, params)\n    if (operatingWait > 0) {\n      this.incrementStats('limitHits')\n      this.#logMethodBlocked(this.#operatingLimiter.getTitle(), requestId, method, operatingWait)\n      await this.#delay(operatingWait)\n    } else {\n      // 2. Apply adaptive delay\n      const adaptiveDelay = await this.#adaptiveDelayer.waitIfNeeded(requestId, method, params)\n      if (adaptiveDelay > 0) {\n        this.incrementStats('limitHits')\n        this.#logMethodBlocked(this.#adaptiveDelayer.getTitle(), requestId, method, adaptiveDelay)\n        await this.#delay(adaptiveDelay)\n      }\n    }\n  }\n\n  /**\n   * Checks and waits for the rate limit\n   * The loop is needed for parallel requests (Promise.all())\n   */\n  async checkRateLimit(requestId: string, method: string): Promise<void> {\n    // 3. Apply rate limit\n    let waitTime\n    let times = 1\n    do {\n      waitTime = await this.#rateLimiter.waitIfNeeded(requestId, method)\n      if (waitTime > 0) {\n        this.incrementStats('limitHits')\n        this.#logMethodBlockedWithTimes(this.#rateLimiter.getTitle(), requestId, method, waitTime, times)\n        await this.#delay(waitTime)\n        times++\n      }\n    } while (waitTime > 0)\n  }\n\n  async updateStats(\n    requestId: string,\n    method: string,\n    timeData: any\n  ): Promise<void> {\n    await this.#operatingLimiter.updateStats(requestId, method, timeData)\n    await this.#adaptiveDelayer.updateStats(requestId, method, timeData)\n    await this.#rateLimiter.updateStats(requestId, method, timeData)\n  }\n\n  async handleError(\n    requestId: string,\n    method: string,\n    params: any,\n    error: any,\n    attempt: number\n  ): Promise<number> {\n    // Rate limit exceeded\n    if (this.#isRateLimitError(error)) {\n      // Since this is error handling, we take into account the number of attempts\n      const wait = (await this.#handleRateLimitExceeded(requestId)) * Math.pow(1.5, attempt)\n      this.#logError(this.#rateLimiter.getTitle(), requestId, 'QUERY_LIMIT_EXCEEDED', error.message, method, wait)\n      return wait\n    }\n\n    // Operating limit exceeded\n    if (this.#isOperatingLimitError(error)) {\n      // Since this is error handling, we will increase the minimum to 10 seconds.\n      const wait = Math.max(10_000, await this.#handleOperatingLimitError(requestId, method, params, error))\n      this.#logError(this.#operatingLimiter.getTitle(), requestId, 'OPERATION_TIME_LIMIT', error.message, method, wait)\n      return wait\n    }\n\n    // Client errors (HTTP 4xx) are deterministic — retrying cannot change the\n    // outcome, so fail fast regardless of whether the error code is enumerated.\n    // 429 (rate/operating limit) is handled above; 408 (timeout) stays retryable.\n    if (this.#isNonRetryableClientError(error)) {\n      this.#logNonRetryableClientError(requestId, error?.code ? `${error.code}` : '?', error?.message ?? '', method, Number(error?.status ?? 0))\n      return 0\n    }\n\n    // Other exceptions\n    if (!this.#isNeedThrowError(error)) {\n      // Since this is error handling, we take into account the number of attempts\n      const baseDelay = await this.#getErrorBackoff(requestId)\n      const maxDelay = Math.max(30_000, baseDelay)\n      const delay = Math.min(maxDelay, baseDelay * Math.pow(2, attempt))\n\n      // Add jitter to prevent thundering herd\n      const jitter = delay * 0.1 * (Math.random() * 2 - 1) // ±10% jitter\n      const wait = Math.max(100, delay + jitter)\n\n      this.#logSomeError(requestId, error?.code ? `${error.code}` : '?', error.message, method, wait)\n\n      return wait\n    }\n\n    return 0 // We don't repeat\n  }\n\n  /**\n   * Checks if the error is a rate limit\n   */\n  #isRateLimitError(error: any): boolean {\n    return error.status === 503\n      || error.code === 'QUERY_LIMIT_EXCEEDED'\n  }\n\n  /**\n   * Delay when exceeding the rate limit\n   */\n  async #handleRateLimitExceeded(requestId: string): Promise<number> {\n    return this.#rateLimiter.handleExceeded(requestId)\n  }\n\n  /**\n   * Checks if the error is an operating limit\n   *\n   * @memo `OPERATION_TIME_LIMIT` && `429` - obtained through practical means\n   * @memo This doesn't work for `batch` queries.\n   */\n  #isOperatingLimitError(error: any): boolean {\n    return error.status === 429\n      || error.code === 'OPERATION_TIME_LIMIT'\n  }\n\n  /**\n   * Operating limit error delay\n   *\n   * @memo Currently, the errors don't include timings for operations.\n   *       For this reason, we will take data from the previous request\n   */\n  async #handleOperatingLimitError(requestId: string, method: string, params?: any, _error?: any): Promise<number> {\n    return this.#operatingLimiter.getTimeToFree(requestId, method, params, _error)\n  }\n\n  /**\n   * Checks if the error is a non-retryable client error (HTTP 4xx).\n   *\n   * `429` is excluded — it is handled as a rate/operating limit and is retried\n   * with backoff. `408` (request timeout) is excluded — it is transient and is\n   * governed by `retryOnNetworkError`.\n   */\n  #isNonRetryableClientError(error: any): boolean {\n    const status = Number(error?.status ?? 0)\n    if (Number.isNaN(status)) {\n      return false\n    }\n    return status >= 400 && status < 500 && status !== 408 && status !== 429\n  }\n\n  /**\n   * Checks whether attempts should be stopped if errors are encountered that are unclear.\n   */\n  #isNeedThrowError(error: any): boolean {\n    const answerError = {\n      code: error?.code ?? '-1',\n      description: error?.message ?? ''\n    }\n\n    return [\n      ...this.exceptionCodeForHard,\n      ...this.exceptionCodeForSoft\n    ].includes(answerError.code)\n    || (answerError.description ?? '').includes('Could not find value for parameter')\n  }\n\n  /**\n   * Built-in hard error codes (always throw, never retry).\n   *\n   * Includes authorization and fatal codes that must never be silently retried.\n   * Use `RestrictionParams.hardErrorCodes` to extend this list with custom codes.\n   */\n  static readonly BUILT_IN_HARD_ERROR_CODES: readonly string[] = [\n    'ERR_BAD_REQUEST',\n    'JSSDK_UNKNOWN_ERROR',\n    '100',\n    'INTERNAL_SERVER_ERROR', 'ERROR_UNEXPECTED_ANSWER', 'PORTAL_DELETED',\n    'ERROR_BATCH_METHOD_NOT_ALLOWED', 'ERROR_BATCH_LENGTH_EXCEEDED',\n    'NO_AUTH_FOUND',\n    'INVALID_REQUEST',\n    'OVERLOAD_LIMIT', 'expired_token',\n    'ACCESS_DENIED', 'INVALID_CREDENTIALS', 'user_access_error', 'insufficient_scope',\n    'ERROR_MANIFEST_IS_NOT_AVAILABLE',\n    'allowed_only_intranet_user',\n    'NOT_FOUND',\n    'INVALID_ARG_VALUE'\n  ]\n\n  /**\n   * Built-in soft error codes (returned as `AjaxResult` with error, never thrown).\n   *\n   * Use `RestrictionParams.softErrorCodes` to extend this list with custom codes.\n   */\n  static readonly BUILT_IN_SOFT_ERROR_CODES: readonly string[] = [\n    'ERROR_ENTITY_NOT_FOUND',\n    'BITRIX_REST_V3_EXCEPTION_ACCESSDENIEDEXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_INVALIDJSONEXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_INVALIDFILTEREXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_INVALIDSELECTEXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_ENTITYNOTFOUNDEXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_METHODNOTFOUNDEXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_UNKNOWNDTOPROPERTYEXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_VALIDATION_DTOVALIDATIONEXCEPTION'\n  ]\n\n  /**\n   * Codes that cause the SDK to throw immediately.\n   *\n   * Composed of:\n   * - `BUILT_IN_HARD_ERROR_CODES` (always included)\n   * - `NETWORK_ERROR` and `REQUEST_TIMEOUT` when `retryOnNetworkError === false`\n   * - `RestrictionParams.hardErrorCodes` (user-provided extensions)\n   */\n  get exceptionCodeForHard(): string[] {\n    const codes = [...RestrictionManager.BUILT_IN_HARD_ERROR_CODES]\n\n    if (this.#config.retryOnNetworkError === false) {\n      codes.push('NETWORK_ERROR', 'REQUEST_TIMEOUT')\n    }\n\n    if (this.#config.hardErrorCodes && this.#config.hardErrorCodes.length > 0) {\n      codes.push(...this.#config.hardErrorCodes)\n    }\n\n    return codes\n  }\n\n  /**\n   * Codes returned as `AjaxResult` with an `AjaxError` payload instead of thrown.\n   *\n   * Composed of:\n   * - `BUILT_IN_SOFT_ERROR_CODES` (always included)\n   * - `RestrictionParams.softErrorCodes` (user-provided extensions)\n   */\n  get exceptionCodeForSoft(): string[] {\n    const codes = [...RestrictionManager.BUILT_IN_SOFT_ERROR_CODES]\n\n    if (this.#config.softErrorCodes && this.#config.softErrorCodes.length > 0) {\n      codes.push(...this.#config.softErrorCodes)\n    }\n\n    return codes\n  }\n\n  /**\n   * Delay due to unknown errors\n   */\n  async #getErrorBackoff(_requestId: string): Promise<number> {\n    return this.#config.retryDelay!\n  }\n\n  incrementError(method: string): void {\n    const current = this.#errorCounts.get(method) || 0\n    this.#errorCounts.set(method, current + 1)\n    this.incrementStats('consecutiveErrors')\n  }\n\n  resetErrors(method: string): void {\n    this.#errorCounts.delete(method)\n    this.#stats.consecutiveErrors = 0\n  }\n\n  incrementStats(stat: keyof Pick<RestrictionManagerStats, 'retries' | 'consecutiveErrors' | 'limitHits'>): void {\n    this.#stats[stat]++\n  }\n\n  /**\n   * Returns job statistics\n   */\n  getStats(): RestrictionManagerStats & {\n    adaptiveDelayAvg: number\n    errorCounts: Record<string, number>\n  } {\n    return {\n      ...this.#stats,\n      ...this.#rateLimiter.getStats(),\n      ...this.#adaptiveDelayer.getStats(),\n      ...this.#operatingLimiter.getStats(),\n      errorCounts: Object.fromEntries(this.#errorCounts)\n    }\n  }\n\n  /**\n   * Resets limiters and statistics\n   */\n  async reset(): Promise<void> {\n    await this.#rateLimiter.reset()\n    await this.#operatingLimiter.reset()\n    await this.#adaptiveDelayer.reset()\n    this.#errorCounts.clear()\n\n    this.#stats = {\n      retries: 0,\n      consecutiveErrors: 0,\n      limitHits: 0\n    }\n  }\n\n  async setConfig(params: RestrictionParams): Promise<void> {\n    this.#config = params\n    await this.#rateLimiter.setConfig(params.rateLimit!)\n    await this.#operatingLimiter.setConfig(params.operatingLimit!)\n    await this.#adaptiveDelayer.setConfig(params.adaptiveConfig!)\n  }\n\n  getParams(): RestrictionParams {\n    return { ...this.#config }\n  }\n\n  /**\n   * Delay function\n   */\n  async #delay(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms))\n  }\n\n  /**\n   * Public access to the delay function\n   */\n  async waiteDelay(ms: number): Promise<void> {\n    return this.#delay(ms)\n  }\n\n  // region Log ////\n  #logMethodBlocked(limiter: string, requestId: string, method: string, wait: number) {\n    this.getLogger().notice(`${limiter} blocked method ${method}`, {\n      requestId,\n      method,\n      wait,\n      limiter\n    })\n  }\n\n  #logMethodBlockedWithTimes(limiter: string, requestId: string, method: string, wait: number, times: number) {\n    this.getLogger().notice(`${limiter} blocked method ${method} | ${times} times`, {\n      requestId,\n      method,\n      times,\n      wait,\n      limiter\n    })\n  }\n\n  #logError(limiter: string, requestId: string, code: string, message: string, method: string, wait: number) {\n    this.getLogger().error(`${limiter} recognized the ${code} error for the ${method} method`, {\n      requestId,\n      method,\n      wait,\n      limiter,\n      error: {\n        code,\n        message\n      }\n    })\n  }\n\n  #logSomeError(requestId: string, code: string, message: string, method: string, wait: number) {\n    this.getLogger().error(`recognized the ${code} error for the ${method} method`, {\n      requestId,\n      method,\n      wait,\n      error: {\n        code,\n        message\n      }\n    })\n  }\n\n  #logNonRetryableClientError(requestId: string, code: string, message: string, method: string, status: number) {\n    this.getLogger().error(`client error ${status} (${code}) for the ${method} method is not retryable`, {\n      requestId,\n      method,\n      status,\n      error: {\n        code,\n        message\n      }\n    })\n  }\n  // endregion ////\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"manager.mjs","sources":["../../../../../src/core/http/limiters/manager.ts"],"sourcesContent":["import type { RestrictionParams, RestrictionManagerStats } from '../../../types/limiters'\nimport type { LoggerInterface } from '../../../types/logger'\nimport { LoggerFactory } from '../../../logger'\nimport { RateLimiter } from './rate-limiter'\nimport { OperatingLimiter } from './operating-limiter'\nimport { AdaptiveDelayer } from './adaptive-delayer'\n\n/**\n * Delay Management Manager\n *\n * @todo docs\n */\nexport class RestrictionManager {\n  #rateLimiter: RateLimiter\n  #operatingLimiter: OperatingLimiter\n  #adaptiveDelayer: AdaptiveDelayer\n  #config: RestrictionParams\n  #stats: Pick<RestrictionManagerStats, 'retries' | 'consecutiveErrors' | 'limitHits'> = {\n    /** Retry attempts */\n    retries: 0,\n    /** Consecutive errors */\n    consecutiveErrors: 0,\n    /** Limit triggers */\n    limitHits: 0\n  }\n\n  #errorCounts = new Map<string, number>()\n\n  private _logger: LoggerInterface\n\n  constructor(params: RestrictionParams) {\n    this._logger = LoggerFactory.createNullLogger()\n    this.#config = params\n    this.#rateLimiter = new RateLimiter(params.rateLimit!)\n    this.#operatingLimiter = new OperatingLimiter(params.operatingLimit!)\n    this.#adaptiveDelayer = new AdaptiveDelayer(params.adaptiveConfig!, this.#operatingLimiter)\n  }\n\n  // region Logger ////\n  setLogger(logger: LoggerInterface): void {\n    this._logger = logger\n    this.#rateLimiter.setLogger(this._logger)\n    this.#operatingLimiter.setLogger(this._logger)\n    this.#adaptiveDelayer.setLogger(this._logger)\n  }\n\n  getLogger(): LoggerInterface {\n    return this._logger\n  }\n  // endregion ////\n\n  async applyOperatingLimits(requestId: string, method: string, params?: any): Promise<void> {\n    // 1. Check operating limit\n    const operatingWait = await this.#operatingLimiter.waitIfNeeded(requestId, method, params)\n    if (operatingWait > 0) {\n      this.incrementStats('limitHits')\n      this.#logMethodBlocked(this.#operatingLimiter.getTitle(), requestId, method, operatingWait)\n      await this.#delay(operatingWait)\n    } else {\n      // 2. Apply adaptive delay\n      const adaptiveDelay = await this.#adaptiveDelayer.waitIfNeeded(requestId, method, params)\n      if (adaptiveDelay > 0) {\n        this.incrementStats('limitHits')\n        this.#logMethodBlocked(this.#adaptiveDelayer.getTitle(), requestId, method, adaptiveDelay)\n        await this.#delay(adaptiveDelay)\n      }\n    }\n  }\n\n  /**\n   * Checks and waits for the rate limit\n   * The loop is needed for parallel requests (Promise.all())\n   */\n  async checkRateLimit(requestId: string, method: string): Promise<void> {\n    // 3. Apply rate limit\n    let waitTime\n    let times = 1\n    do {\n      waitTime = await this.#rateLimiter.waitIfNeeded(requestId, method)\n      if (waitTime > 0) {\n        this.incrementStats('limitHits')\n        this.#logMethodBlockedWithTimes(this.#rateLimiter.getTitle(), requestId, method, waitTime, times)\n        await this.#delay(waitTime)\n        times++\n      }\n    } while (waitTime > 0)\n  }\n\n  async updateStats(\n    requestId: string,\n    method: string,\n    timeData: any\n  ): Promise<void> {\n    await this.#operatingLimiter.updateStats(requestId, method, timeData)\n    await this.#adaptiveDelayer.updateStats(requestId, method, timeData)\n    await this.#rateLimiter.updateStats(requestId, method, timeData)\n  }\n\n  async handleError(\n    requestId: string,\n    method: string,\n    params: any,\n    error: any,\n    attempt: number\n  ): Promise<number> {\n    // Rate limit exceeded\n    if (this.#isRateLimitError(error)) {\n      // Since this is error handling, we take into account the number of attempts\n      const wait = (await this.#handleRateLimitExceeded(requestId)) * Math.pow(1.5, attempt)\n      this.#logError(this.#rateLimiter.getTitle(), requestId, 'QUERY_LIMIT_EXCEEDED', error.message, method, wait)\n      return wait\n    }\n\n    // Operating limit exceeded\n    if (this.#isOperatingLimitError(error)) {\n      // Since this is error handling, we will increase the minimum to 10 seconds.\n      const wait = Math.max(10_000, await this.#handleOperatingLimitError(requestId, method, params, error))\n      this.#logError(this.#operatingLimiter.getTitle(), requestId, 'OPERATION_TIME_LIMIT', error.message, method, wait)\n      return wait\n    }\n\n    // Client errors (HTTP 4xx) are deterministic — retrying cannot change the\n    // outcome, so fail fast regardless of whether the error code is enumerated.\n    // 429 (rate/operating limit) is handled above; 408 (timeout) stays retryable.\n    if (this.#isNonRetryableClientError(error)) {\n      this.#logNonRetryableClientError(requestId, error?.code ? `${error.code}` : '?', error?.message ?? '', method, Number(error?.status ?? 0))\n      return 0\n    }\n\n    // Other exceptions\n    if (!this.#isNeedThrowError(error)) {\n      // Since this is error handling, we take into account the number of attempts\n      const baseDelay = await this.#getErrorBackoff(requestId)\n      const maxDelay = Math.max(30_000, baseDelay)\n      const delay = Math.min(maxDelay, baseDelay * Math.pow(2, attempt))\n\n      // Add jitter to prevent thundering herd\n      const jitter = delay * 0.1 * (Math.random() * 2 - 1) // ±10% jitter\n      const wait = Math.max(100, delay + jitter)\n\n      this.#logSomeError(requestId, error?.code ? `${error.code}` : '?', error.message, method, wait)\n\n      return wait\n    }\n\n    return 0 // We don't repeat\n  }\n\n  /**\n   * Checks if the error is a rate limit\n   */\n  #isRateLimitError(error: any): boolean {\n    return error.status === 503\n      || error.code === 'QUERY_LIMIT_EXCEEDED'\n  }\n\n  /**\n   * Delay when exceeding the rate limit\n   */\n  async #handleRateLimitExceeded(requestId: string): Promise<number> {\n    return this.#rateLimiter.handleExceeded(requestId)\n  }\n\n  /**\n   * Checks if the error is an operating limit\n   *\n   * @memo `OPERATION_TIME_LIMIT` && `429` - obtained through practical means\n   * @memo This doesn't work for `batch` queries.\n   */\n  #isOperatingLimitError(error: any): boolean {\n    return error.status === 429\n      || error.code === 'OPERATION_TIME_LIMIT'\n  }\n\n  /**\n   * Operating limit error delay\n   *\n   * @memo Currently, the errors don't include timings for operations.\n   *       For this reason, we will take data from the previous request\n   */\n  async #handleOperatingLimitError(requestId: string, method: string, params?: any, _error?: any): Promise<number> {\n    return this.#operatingLimiter.getTimeToFree(requestId, method, params, _error)\n  }\n\n  /**\n   * Checks if the error is a non-retryable client error (HTTP 4xx).\n   *\n   * `429` is excluded — it is handled as a rate/operating limit and is retried\n   * with backoff. `408` (request timeout) is excluded — it is transient and is\n   * governed by `retryOnNetworkError`.\n   */\n  #isNonRetryableClientError(error: any): boolean {\n    const status = Number(error?.status ?? 0)\n    if (Number.isNaN(status)) {\n      return false\n    }\n    return status >= 400 && status < 500 && status !== 408 && status !== 429\n  }\n\n  /**\n   * Checks whether attempts should be stopped if errors are encountered that are unclear.\n   */\n  #isNeedThrowError(error: any): boolean {\n    const answerError = {\n      code: error?.code ?? '-1',\n      description: error?.message ?? ''\n    }\n\n    return [\n      ...this.exceptionCodeForHard,\n      ...this.exceptionCodeForSoft\n    ].includes(answerError.code)\n    || (answerError.description ?? '').includes('Could not find value for parameter')\n  }\n\n  /**\n   * Built-in hard error codes (always throw, never retry).\n   *\n   * Includes authorization and fatal codes that must never be silently retried.\n   * Use `RestrictionParams.hardErrorCodes` to extend this list with custom codes.\n   */\n  static readonly BUILT_IN_HARD_ERROR_CODES: readonly string[] = [\n    'ERR_BAD_REQUEST',\n    'JSSDK_UNKNOWN_ERROR',\n    '100',\n    'INTERNAL_SERVER_ERROR', 'ERROR_UNEXPECTED_ANSWER', 'PORTAL_DELETED',\n    'ERROR_BATCH_METHOD_NOT_ALLOWED', 'ERROR_BATCH_LENGTH_EXCEEDED',\n    'NO_AUTH_FOUND',\n    'INVALID_REQUEST',\n    'OVERLOAD_LIMIT', 'expired_token', 'invalid_token',\n    'ACCESS_DENIED', 'INVALID_CREDENTIALS', 'user_access_error', 'insufficient_scope',\n    'ERROR_MANIFEST_IS_NOT_AVAILABLE',\n    'allowed_only_intranet_user',\n    'NOT_FOUND',\n    'INVALID_ARG_VALUE'\n  ]\n\n  /**\n   * Built-in soft error codes (returned as `AjaxResult` with error, never thrown).\n   *\n   * Use `RestrictionParams.softErrorCodes` to extend this list with custom codes.\n   */\n  static readonly BUILT_IN_SOFT_ERROR_CODES: readonly string[] = [\n    'ERROR_ENTITY_NOT_FOUND',\n    'BITRIX_REST_V3_EXCEPTION_ACCESSDENIEDEXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_INVALIDJSONEXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_INVALIDFILTEREXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_INVALIDSELECTEXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_ENTITYNOTFOUNDEXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_METHODNOTFOUNDEXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_UNKNOWNDTOPROPERTYEXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION',\n    'BITRIX_REST_V3_EXCEPTION_VALIDATION_DTOVALIDATIONEXCEPTION'\n  ]\n\n  /**\n   * Codes that cause the SDK to throw immediately.\n   *\n   * Composed of:\n   * - `BUILT_IN_HARD_ERROR_CODES` (always included)\n   * - `NETWORK_ERROR` and `REQUEST_TIMEOUT` when `retryOnNetworkError === false`\n   * - `RestrictionParams.hardErrorCodes` (user-provided extensions)\n   */\n  get exceptionCodeForHard(): string[] {\n    const codes = [...RestrictionManager.BUILT_IN_HARD_ERROR_CODES]\n\n    if (this.#config.retryOnNetworkError === false) {\n      codes.push('NETWORK_ERROR', 'REQUEST_TIMEOUT')\n    }\n\n    if (this.#config.hardErrorCodes && this.#config.hardErrorCodes.length > 0) {\n      codes.push(...this.#config.hardErrorCodes)\n    }\n\n    return codes\n  }\n\n  /**\n   * Codes returned as `AjaxResult` with an `AjaxError` payload instead of thrown.\n   *\n   * Composed of:\n   * - `BUILT_IN_SOFT_ERROR_CODES` (always included)\n   * - `RestrictionParams.softErrorCodes` (user-provided extensions)\n   */\n  get exceptionCodeForSoft(): string[] {\n    const codes = [...RestrictionManager.BUILT_IN_SOFT_ERROR_CODES]\n\n    if (this.#config.softErrorCodes && this.#config.softErrorCodes.length > 0) {\n      codes.push(...this.#config.softErrorCodes)\n    }\n\n    return codes\n  }\n\n  /**\n   * Delay due to unknown errors\n   */\n  async #getErrorBackoff(_requestId: string): Promise<number> {\n    return this.#config.retryDelay!\n  }\n\n  incrementError(method: string): void {\n    const current = this.#errorCounts.get(method) || 0\n    this.#errorCounts.set(method, current + 1)\n    this.incrementStats('consecutiveErrors')\n  }\n\n  resetErrors(method: string): void {\n    this.#errorCounts.delete(method)\n    this.#stats.consecutiveErrors = 0\n  }\n\n  incrementStats(stat: keyof Pick<RestrictionManagerStats, 'retries' | 'consecutiveErrors' | 'limitHits'>): void {\n    this.#stats[stat]++\n  }\n\n  /**\n   * Returns job statistics\n   */\n  getStats(): RestrictionManagerStats & {\n    adaptiveDelayAvg: number\n    errorCounts: Record<string, number>\n  } {\n    return {\n      ...this.#stats,\n      ...this.#rateLimiter.getStats(),\n      ...this.#adaptiveDelayer.getStats(),\n      ...this.#operatingLimiter.getStats(),\n      errorCounts: Object.fromEntries(this.#errorCounts)\n    }\n  }\n\n  /**\n   * Resets limiters and statistics\n   */\n  async reset(): Promise<void> {\n    await this.#rateLimiter.reset()\n    await this.#operatingLimiter.reset()\n    await this.#adaptiveDelayer.reset()\n    this.#errorCounts.clear()\n\n    this.#stats = {\n      retries: 0,\n      consecutiveErrors: 0,\n      limitHits: 0\n    }\n  }\n\n  async setConfig(params: RestrictionParams): Promise<void> {\n    this.#config = params\n    await this.#rateLimiter.setConfig(params.rateLimit!)\n    await this.#operatingLimiter.setConfig(params.operatingLimit!)\n    await this.#adaptiveDelayer.setConfig(params.adaptiveConfig!)\n  }\n\n  getParams(): RestrictionParams {\n    return { ...this.#config }\n  }\n\n  /**\n   * Delay function\n   */\n  async #delay(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms))\n  }\n\n  /**\n   * Public access to the delay function\n   */\n  async waiteDelay(ms: number): Promise<void> {\n    return this.#delay(ms)\n  }\n\n  // region Log ////\n  #logMethodBlocked(limiter: string, requestId: string, method: string, wait: number) {\n    this.getLogger().notice(`${limiter} blocked method ${method}`, {\n      requestId,\n      method,\n      wait,\n      limiter\n    })\n  }\n\n  #logMethodBlockedWithTimes(limiter: string, requestId: string, method: string, wait: number, times: number) {\n    this.getLogger().notice(`${limiter} blocked method ${method} | ${times} times`, {\n      requestId,\n      method,\n      times,\n      wait,\n      limiter\n    })\n  }\n\n  #logError(limiter: string, requestId: string, code: string, message: string, method: string, wait: number) {\n    this.getLogger().error(`${limiter} recognized the ${code} error for the ${method} method`, {\n      requestId,\n      method,\n      wait,\n      limiter,\n      error: {\n        code,\n        message\n      }\n    })\n  }\n\n  #logSomeError(requestId: string, code: string, message: string, method: string, wait: number) {\n    this.getLogger().error(`recognized the ${code} error for the ${method} method`, {\n      requestId,\n      method,\n      wait,\n      error: {\n        code,\n        message\n      }\n    })\n  }\n\n  #logNonRetryableClientError(requestId: string, code: string, message: string, method: string, status: number) {\n    this.getLogger().error(`client error ${status} (${code}) for the ${method} method is not retryable`, {\n      requestId,\n      method,\n      status,\n      error: {\n        code,\n        message\n      }\n    })\n  }\n  // endregion ////\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/core/http/limiters/operating-limiter.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/http/limiters/params-factory.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/http/limiters/rate-limiter.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/http/redact.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/http/v2.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk
@@ -88,7 +88,7 @@ class HttpV2 extends AbstractHttp {
     }
     const queryParams = new URLSearchParams({
       [this._requestIdGenerator.getQueryStringParameterName()]: requestId,
-      [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.2.0",
+      [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.3.0",
       [this._requestIdGenerator.getQueryStringSdkTypeParameterName()]: "b24-js-sdk"
     });
     return `${baseUrl}${methodUrl}?${queryParams.toString()}`;

package/dist/esm/core/http/v3.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk
@@ -82,7 +82,7 @@ class HttpV3 extends AbstractHttp {
     const methodUrl = `/${encodeURIComponent(method)}`;
     const queryParams = new URLSearchParams({
       [this._requestIdGenerator.getQueryStringParameterName()]: requestId,
-      [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.2.0",
+      [this._requestIdGenerator.getQueryStringSdkParameterName()]: "1.3.0",
       [this._requestIdGenerator.getQueryStringSdkTypeParameterName()]: "b24-js-sdk"
     });
     return `${baseUrl}${methodUrl}?${queryParams.toString()}`;

package/dist/esm/core/interaction/batch/abstract-interaction-batch.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/interaction/batch/parse-row.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/interaction/batch/processing/interface-strategy.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/interaction/batch/processing/v2/abstract-processing.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/interaction/batch/processing/v2/as-array.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/interaction/batch/processing/v2/as-object.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/interaction/batch/processing/v3/abstract-processing.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/interaction/batch/processing/v3/as-array.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/interaction/batch/processing/v3/as-object.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/interaction/batch/v2.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

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

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/language/list.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/request-id-generator.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/result.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk
@@ -60,6 +60,33 @@ class Result {
   getErrorMessages() {
     return Array.from(this._errors.values(), (e) => e.message);
   }
+  /**
+   * Retrieves all errors as a plain object (a snapshot copy) keyed by their
+   * identifier, preserving which request produced each error. Unlike
+   * {@link Result.getErrors}, the keys are not discarded — useful for batch
+   * calls with `isHaltOnError: false`.
+   *
+   * Keys are meaningful only when the error was added with an explicit key
+   * (e.g. an object / named-command batch). Array-mode batches and
+   * {@link Result.addErrors} fall back to generated UUID keys.
+   *
+   * @returns {Record<string, Error>} A map of error key to Error object.
+   */
+  getErrorsByKey() {
+    return Object.fromEntries(this._errors);
+  }
+  /**
+   * Retrieves all error messages as a plain object (a snapshot copy) keyed by
+   * their identifier. Unlike {@link Result.getErrorMessages}, the keys are
+   * preserved. See {@link Result.getErrorsByKey} for when keys are meaningful.
+   *
+   * @returns {Record<string, string>} A map of error key to error message.
+   */
+  getErrorMessagesByKey() {
+    return Object.fromEntries(
+      Array.from(this._errors, ([key, error]) => [key, error.message])
+    );
+  }
   /**
    * Converts the Result object to a string.
    *

package/dist/esm/core/result.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"result.mjs","sources":["../../../src/core/result.ts"],"sourcesContent":["import { Text } from '../tools/text'\n\n/**\n * Interface defining the structure and methods of a Result object.\n */\nexport interface IResult<T = any> {\n  /**\n   * Indicates whether the operation resulted in success (no errors).\n   */\n  readonly isSuccess: boolean\n  /**\n   * Collection of errors\n   */\n  readonly errors: Map<string, Error>\n\n  /**\n   * Sets the data associated with the result.\n   *\n   * @param data The data to be stored in the result.\n   * @returns The current Result object for chaining methods.\n   */\n  setData: (data: T) => IResult<T>\n  /**\n   * Retrieves the data associated with the result.\n   *\n   * @returns The data stored in the result, if any.\n   */\n  getData: () => T | null | undefined\n\n  /**\n   * Adds an error message or Error object to the result.\n   * @param error The error message or Error object to be added.\n   * @param key Error key. You can leave it blank. Then it will be generated automatically.\n   * @returns {IResult} The current Result object for chaining methods.\n   */\n  addError: (error: Error | string, key?: string) => IResult\n  /**\n   * Adds multiple errors to the result in a single call.\n   *\n   * @param errors An array of errors or strings that will be converted to errors.\n   * @returns {IResult} The current Result object for chaining methods.\n   */\n  addErrors: (errors: (Error | string)[]) => IResult\n  /**\n   * Retrieves an iterator for the errors collected in the result.\n   *\n   * @returns {IterableIterator<Error>} An iterator over the stored Error objects.\n   */\n  getErrors: () => IterableIterator<Error>\n\n  /**\n   * Retrieves an array of error messages from the collected errors.\n   *\n   * @returns {string[]} An array of strings representing the error messages.\n   */\n  getErrorMessages: () => string[]\n  /**\n   * Checks for an error in a collection by key\n   * @param key - Error key\n   */\n  hasError(key: string): boolean\n  /**\n   * Converts the Result object to a string.\n   *\n   * @returns {string} Returns a string representation of the result operation\n   */\n  toString: () => string\n}\n\n/**\n * A class representing an operation result with success/failure status, data, and errors.\n * Similar to \\Bitrix\\Main\\Result from Bitrix Framework.\n * @link https://dev.1c-bitrix.ru/api_d7/bitrix/main/result/index.php\n */\nexport class Result<T = any> implements IResult<T> {\n  protected _errors: Map<string, Error>\n  protected _data: T | null | undefined\n\n  constructor(data?: T) {\n    this._errors = new Map()\n    this._data = data ?? null\n  }\n\n  get isSuccess(): boolean {\n    return this._errors.size === 0\n  }\n\n  get errors(): Map<string, Error> {\n    return this._errors\n  }\n\n  setData(data: T | null | undefined): Result<T> {\n    this._data = data\n\n    return this\n  }\n\n  getData(): T | null | undefined {\n    return this._data\n  }\n\n  addError(error: Error | string, key?: string): Result<T> {\n    const errorKey = key ?? Text.getUuidRfc4122()\n    const errorObj = typeof error === 'string' ? new Error(error) : error\n\n    this._errors.set(errorKey, errorObj)\n\n    return this\n  }\n\n  addErrors(errors: (Error | string)[]): Result<T> {\n    for (const error of errors) {\n      this.addError(error)\n    }\n\n    return this\n  }\n\n  getErrors(): IterableIterator<Error> {\n    return this._errors.values()\n  }\n\n  hasError(key: string): boolean {\n    return this._errors.has(key)\n  }\n\n  /**\n   * Retrieves an array of error messages from the collected errors.\n   *\n   * @returns An array of strings representing the error messages. Each string\n   *          contains the message of a corresponding error object.\n   */\n  getErrorMessages(): string[] {\n    return Array.from(this._errors.values(), e => e.message)\n  }\n\n  /**\n   * Converts the Result object to a string.\n   *\n   * @returns {string} Returns a string representation of the result operation\n   */\n  toString(): string {\n    const status = this.isSuccess ? 'success' : 'failure'\n    const data = this.safeStringify(this._data)\n\n    return this.isSuccess\n      ? `Result(${status}): ${data}`\n      : `Result(${status}): ${data}\\nErrors: ${this.getErrorMessages().join(', ')}`\n  }\n\n  private safeStringify(data: unknown): string {\n    try {\n      return JSON.stringify(data, this.replacer, 2)\n    } catch {\n      return '[Unable to serialize data]'\n    }\n  }\n\n  private replacer(_: string, value: unknown) {\n    if (value instanceof Error) {\n      return {\n        name: value.name,\n        message: value.message,\n        stack: value.stack\n      }\n    }\n    return value\n  }\n\n  // Static constructors\n  static ok<U>(data?: U): Result<U> {\n    return new Result<U>(data)\n  }\n\n  static fail<U>(error: Error | string, key?: string): Result<U> {\n    return new Result<U>().addError(error, key)\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"result.mjs","sources":["../../../src/core/result.ts"],"sourcesContent":["import { Text } from '../tools/text'\n\n/**\n * Interface defining the structure and methods of a Result object.\n */\nexport interface IResult<T = any> {\n  /**\n   * Indicates whether the operation resulted in success (no errors).\n   */\n  readonly isSuccess: boolean\n  /**\n   * Collection of errors\n   */\n  readonly errors: Map<string, Error>\n\n  /**\n   * Sets the data associated with the result.\n   *\n   * @param data The data to be stored in the result.\n   * @returns The current Result object for chaining methods.\n   */\n  setData: (data: T) => IResult<T>\n  /**\n   * Retrieves the data associated with the result.\n   *\n   * @returns The data stored in the result, if any.\n   */\n  getData: () => T | null | undefined\n\n  /**\n   * Adds an error message or Error object to the result.\n   * @param error The error message or Error object to be added.\n   * @param key Error key. You can leave it blank. Then it will be generated automatically.\n   * @returns {IResult} The current Result object for chaining methods.\n   */\n  addError: (error: Error | string, key?: string) => IResult\n  /**\n   * Adds multiple errors to the result in a single call.\n   *\n   * @param errors An array of errors or strings that will be converted to errors.\n   * @returns {IResult} The current Result object for chaining methods.\n   */\n  addErrors: (errors: (Error | string)[]) => IResult\n  /**\n   * Retrieves an iterator for the errors collected in the result.\n   *\n   * @returns {IterableIterator<Error>} An iterator over the stored Error objects.\n   * @see {@link IResult.getErrorsByKey} — keeps the request keys.\n   */\n  getErrors: () => IterableIterator<Error>\n\n  /**\n   * Retrieves an array of error messages from the collected errors.\n   *\n   * @returns {string[]} An array of strings representing the error messages.\n   */\n  getErrorMessages: () => string[]\n\n  /**\n   * Retrieves all errors keyed by their identifier (e.g. the batch request key),\n   * preserving which request produced each error. Unlike {@link getErrors}, the\n   * keys are not discarded — useful for batch calls with `isHaltOnError: false`.\n   *\n   * @returns {Record<string, Error>} A map of error key to Error object.\n   */\n  getErrorsByKey: () => Record<string, Error>\n\n  /**\n   * Retrieves all error messages keyed by their identifier (e.g. the batch\n   * request key). Unlike {@link getErrorMessages}, the keys are preserved.\n   *\n   * @returns {Record<string, string>} A map of error key to error message.\n   */\n  getErrorMessagesByKey: () => Record<string, string>\n\n  /**\n   * Checks for an error in a collection by key\n   * @param key - Error key\n   */\n  hasError(key: string): boolean\n  /**\n   * Converts the Result object to a string.\n   *\n   * @returns {string} Returns a string representation of the result operation\n   */\n  toString: () => string\n}\n\n/**\n * A class representing an operation result with success/failure status, data, and errors.\n * Similar to \\Bitrix\\Main\\Result from Bitrix Framework.\n * @link https://dev.1c-bitrix.ru/api_d7/bitrix/main/result/index.php\n */\nexport class Result<T = any> implements IResult<T> {\n  protected _errors: Map<string, Error>\n  protected _data: T | null | undefined\n\n  constructor(data?: T) {\n    this._errors = new Map()\n    this._data = data ?? null\n  }\n\n  get isSuccess(): boolean {\n    return this._errors.size === 0\n  }\n\n  get errors(): Map<string, Error> {\n    return this._errors\n  }\n\n  setData(data: T | null | undefined): Result<T> {\n    this._data = data\n\n    return this\n  }\n\n  getData(): T | null | undefined {\n    return this._data\n  }\n\n  addError(error: Error | string, key?: string): Result<T> {\n    const errorKey = key ?? Text.getUuidRfc4122()\n    const errorObj = typeof error === 'string' ? new Error(error) : error\n\n    this._errors.set(errorKey, errorObj)\n\n    return this\n  }\n\n  addErrors(errors: (Error | string)[]): Result<T> {\n    for (const error of errors) {\n      this.addError(error)\n    }\n\n    return this\n  }\n\n  getErrors(): IterableIterator<Error> {\n    return this._errors.values()\n  }\n\n  hasError(key: string): boolean {\n    return this._errors.has(key)\n  }\n\n  /**\n   * Retrieves an array of error messages from the collected errors.\n   *\n   * @returns An array of strings representing the error messages. Each string\n   *          contains the message of a corresponding error object.\n   */\n  getErrorMessages(): string[] {\n    return Array.from(this._errors.values(), e => e.message)\n  }\n\n  /**\n   * Retrieves all errors as a plain object (a snapshot copy) keyed by their\n   * identifier, preserving which request produced each error. Unlike\n   * {@link Result.getErrors}, the keys are not discarded — useful for batch\n   * calls with `isHaltOnError: false`.\n   *\n   * Keys are meaningful only when the error was added with an explicit key\n   * (e.g. an object / named-command batch). Array-mode batches and\n   * {@link Result.addErrors} fall back to generated UUID keys.\n   *\n   * @returns {Record<string, Error>} A map of error key to Error object.\n   */\n  getErrorsByKey(): Record<string, Error> {\n    return Object.fromEntries(this._errors)\n  }\n\n  /**\n   * Retrieves all error messages as a plain object (a snapshot copy) keyed by\n   * their identifier. Unlike {@link Result.getErrorMessages}, the keys are\n   * preserved. See {@link Result.getErrorsByKey} for when keys are meaningful.\n   *\n   * @returns {Record<string, string>} A map of error key to error message.\n   */\n  getErrorMessagesByKey(): Record<string, string> {\n    // `Object.fromEntries` (like getErrorsByKey) is prototype-safe: a literal\n    // `__proto__` key becomes an own property instead of being silently dropped.\n    return Object.fromEntries(\n      Array.from(this._errors, ([key, error]): [string, string] => [key, error.message])\n    )\n  }\n\n  /**\n   * Converts the Result object to a string.\n   *\n   * @returns {string} Returns a string representation of the result operation\n   */\n  toString(): string {\n    const status = this.isSuccess ? 'success' : 'failure'\n    const data = this.safeStringify(this._data)\n\n    return this.isSuccess\n      ? `Result(${status}): ${data}`\n      : `Result(${status}): ${data}\\nErrors: ${this.getErrorMessages().join(', ')}`\n  }\n\n  private safeStringify(data: unknown): string {\n    try {\n      return JSON.stringify(data, this.replacer, 2)\n    } catch {\n      return '[Unable to serialize data]'\n    }\n  }\n\n  private replacer(_: string, value: unknown) {\n    if (value instanceof Error) {\n      return {\n        name: value.name,\n        message: value.message,\n        stack: value.stack\n      }\n    }\n    return value\n  }\n\n  // Static constructors\n  static ok<U>(data?: U): Result<U> {\n    return new Result<U>(data)\n  }\n\n  static fail<U>(error: Error | string, key?: string): Result<U> {\n    return new Result<U>().addError(error, key)\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/core/sdk-error.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/tools/abstract-tool.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/tools/healthcheck.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/tools/manager.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk
@@ -12,8 +12,8 @@ import { LoggerFactory } from '../../logger/logger-factory.mjs';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-const pingName = Symbol("ping");
-const healthCheckName = Symbol("healthCheck");
+const pingName = /* @__PURE__ */ Symbol("ping");
+const healthCheckName = /* @__PURE__ */ Symbol("healthCheck");
 class ToolsManager {
   static {
     __name(this, "ToolsManager");

package/dist/esm/core/tools/manager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"manager.mjs","sources":["../../../../src/core/tools/manager.ts"],"sourcesContent":["import type { TypeB24 } from '../../types/b24'\nimport type { LoggerInterface } from '../../types/logger'\nimport type { AbstractTool } from './abstract-tool'\nimport { LoggerFactory } from '../../logger'\nimport { Ping } from './ping'\nimport { HealthCheck } from './healthcheck'\n\nconst pingName = Symbol('ping')\nconst healthCheckName = Symbol('healthCheck')\n/**\n * Some tools for TypeB24\n * @todo add docs\n */\nexport class ToolsManager {\n  protected _b24: TypeB24\n  protected _logger: LoggerInterface\n\n  protected _mapTools: Map<symbol, AbstractTool>\n\n  constructor(b24: TypeB24) {\n    this._b24 = b24\n    this._logger = LoggerFactory.createNullLogger()\n\n    this._mapTools = 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 ping(): Ping {\n    if (!this._mapTools.has(pingName)) {\n      this._mapTools.set(pingName, new Ping(this._b24, this._logger))\n    }\n    return this._mapTools.get(pingName)! as Ping\n  }\n\n  get healthCheck(): HealthCheck {\n    if (!this._mapTools.has(healthCheckName)) {\n      this._mapTools.set(healthCheckName, new HealthCheck(this._b24, this._logger))\n    }\n    return this._mapTools.get(healthCheckName)! as HealthCheck\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;AAOA,MAAM,QAAA,GAAW,OAAO,MAAM,CAAA;AAC9B,MAAM,eAAA,GAAkB,OAAO,aAAa,CAAA;AAKrC,MAAM,YAAA,CAAa;AAAA,EAb1B;AAa0B,IAAA,MAAA,CAAA,IAAA,EAAA,cAAA,CAAA;AAAA;AAAA,EACd,IAAA;AAAA,EACA,OAAA;AAAA,EAEA,SAAA;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,SAAA,uBAAgB,GAAA,EAAI;AAAA,EAC3B;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,GAAa;AACf,IAAA,IAAI,CAAC,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,QAAQ,CAAA,EAAG;AACjC,MAAA,IAAA,CAAK,SAAA,CAAU,IAAI,QAAA,EAAU,IAAI,KAAK,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,OAAO,CAAC,CAAA;AAAA,IAChE;AACA,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,QAAQ,CAAA;AAAA,EACpC;AAAA,EAEA,IAAI,WAAA,GAA2B;AAC7B,IAAA,IAAI,CAAC,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,eAAe,CAAA,EAAG;AACxC,MAAA,IAAA,CAAK,SAAA,CAAU,IAAI,eAAA,EAAiB,IAAI,YAAY,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,OAAO,CAAC,CAAA;AAAA,IAC9E;AACA,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,eAAe,CAAA;AAAA,EAC3C;AACF;;;;"}
+{"version":3,"file":"manager.mjs","sources":["../../../../src/core/tools/manager.ts"],"sourcesContent":["import type { TypeB24 } from '../../types/b24'\nimport type { LoggerInterface } from '../../types/logger'\nimport type { AbstractTool } from './abstract-tool'\nimport { LoggerFactory } from '../../logger'\nimport { Ping } from './ping'\nimport { HealthCheck } from './healthcheck'\n\nconst pingName = Symbol('ping')\nconst healthCheckName = Symbol('healthCheck')\n/**\n * Some tools for TypeB24\n * @todo add docs\n */\nexport class ToolsManager {\n  protected _b24: TypeB24\n  protected _logger: LoggerInterface\n\n  protected _mapTools: Map<symbol, AbstractTool>\n\n  constructor(b24: TypeB24) {\n    this._b24 = b24\n    this._logger = LoggerFactory.createNullLogger()\n\n    this._mapTools = 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 ping(): Ping {\n    if (!this._mapTools.has(pingName)) {\n      this._mapTools.set(pingName, new Ping(this._b24, this._logger))\n    }\n    return this._mapTools.get(pingName)! as Ping\n  }\n\n  get healthCheck(): HealthCheck {\n    if (!this._mapTools.has(healthCheckName)) {\n      this._mapTools.set(healthCheckName, new HealthCheck(this._b24, this._logger))\n    }\n    return this._mapTools.get(healthCheckName)! as HealthCheck\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;AAOA,MAAM,QAAA,0BAAkB,MAAM,CAAA;AAC9B,MAAM,eAAA,0BAAyB,aAAa,CAAA;AAKrC,MAAM,YAAA,CAAa;AAAA,EAb1B;AAa0B,IAAA,MAAA,CAAA,IAAA,EAAA,cAAA,CAAA;AAAA;AAAA,EACd,IAAA;AAAA,EACA,OAAA;AAAA,EAEA,SAAA;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,SAAA,uBAAgB,GAAA,EAAI;AAAA,EAC3B;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,GAAa;AACf,IAAA,IAAI,CAAC,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,QAAQ,CAAA,EAAG;AACjC,MAAA,IAAA,CAAK,SAAA,CAAU,IAAI,QAAA,EAAU,IAAI,KAAK,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,OAAO,CAAC,CAAA;AAAA,IAChE;AACA,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,QAAQ,CAAA;AAAA,EACpC;AAAA,EAEA,IAAI,WAAA,GAA2B;AAC7B,IAAA,IAAI,CAAC,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,eAAe,CAAA,EAAG;AACxC,MAAA,IAAA,CAAK,SAAA,CAAU,IAAI,eAAA,EAAiB,IAAI,YAAY,IAAA,CAAK,IAAA,EAAM,IAAA,CAAK,OAAO,CAAC,CAAA;AAAA,IAC9E;AACA,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,eAAe,CAAA;AAAA,EAC3C;AACF;;;;"}

package/dist/esm/core/tools/ping.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk

package/dist/esm/core/version-manager.mjs

@@ -1,6 +1,6 @@
 /**
  * @package @bitrix24/b24jssdk
- * @version 1.2.0
+ * @version 1.3.0
  * @copyright (c) 2026 Bitrix24
  * @license MIT
  * @see https://github.com/bitrix24/b24jssdk
@@ -19,6 +19,7 @@ class VersionManager {
   #supportMethods;
   constructor() {
     this.#supportMethods = [
+      // --- infrastructure ---
       "/batch",
       // done
       "/scopes",
@@ -27,6 +28,7 @@ class VersionManager {
       // done
       "/rest.documentation.openapi",
       "/documentation",
+      // --- main ---
       /** @see /settings/configs/event_log.php */
       "/main.eventlog.list",
       // done
@@ -34,21 +36,96 @@ class VersionManager {
       // done
       "/main.eventlog.tail",
       // done
-      "/tasks.task.chat.message.send",
-      "/tasks.task.access.get",
-      "/tasks.task.file.attach",
+      "/main.eventlog.field.list",
+      "/main.eventlog.field.get",
+      // --- mail (rest-v3) ---
+      "/mail.mailbox.list",
+      "/mail.mailbox.get",
+      "/mail.mailbox.senders",
+      "/mail.mailbox.field.list",
+      "/mail.mailbox.field.get",
+      "/mail.message.list",
+      "/mail.message.get",
+      "/mail.message.thread",
+      "/mail.message.send",
+      "/mail.message.reply",
+      "/mail.message.forward",
+      "/mail.message.movetofolder",
+      "/mail.message.createcrmactivity",
+      "/mail.message.removecrmactivity",
+      "/mail.message.createtask",
+      "/mail.message.createcalendarevent",
+      "/mail.message.createchat",
+      "/mail.message.createfeedpost",
+      "/mail.message.field.list",
+      "/mail.message.field.get",
+      "/mail.recipient.listcontacts",
+      "/mail.recipient.listemployees",
+      "/mail.recipient.field.list",
+      "/mail.recipient.field.get",
+      // --- humanresources (rest-v3) ---
+      "/humanresources.node.add",
+      "/humanresources.node.edit",
+      "/humanresources.node.get",
+      "/humanresources.node.list",
+      "/humanresources.node.search",
+      "/humanresources.node.children",
+      "/humanresources.node.count",
+      "/humanresources.node.move",
+      "/humanresources.node.field.list",
+      "/humanresources.node.field.get",
+      "/humanresources.node.member.add",
+      "/humanresources.node.member.set",
+      "/humanresources.node.member.move",
+      "/humanresources.node.member.remove",
+      "/humanresources.node.communication.edit",
+      "/humanresources.node.communication.list",
+      "/humanresources.employee.search",
+      "/humanresources.employee.subordinates",
+      "/humanresources.employee.count",
+      "/humanresources.employee.multidepartment",
+      "/humanresources.employee.field.list",
+      "/humanresources.employee.field.get",
+      // --- tasks (rest-v3) ---
+      "/tasks.task.add",
+      "/tasks.task.get",
+      // done
       "/tasks.task.update",
       // done
       "/tasks.task.delete",
-      "/tasks.task.add",
-      "/tasks.task.get"
-      // done
+      "/tasks.task.access.get",
+      "/tasks.task.file.attach",
+      "/tasks.task.chat.message.send",
+      "/tasks.task.result.add",
+      "/tasks.task.result.addfromchatmessage",
+      "/tasks.task.result.update",
+      "/tasks.task.result.list",
+      "/tasks.task.result.delete",
+      "/tasks.task.field.list",
+      "/tasks.task.field.get",
+      "/tasks.task.access.field.list",
+      "/tasks.task.access.field.get",
+      "/tasks.task.file.field.list",
+      "/tasks.task.file.field.get",
+      "/tasks.task.chat.message.field.list",
+      "/tasks.task.chat.message.field.get",
+      // --- timeman (rest-v3) — read-only in v3 (no record.get / add / update / delete) ---
+      "/timeman.record.list",
+      "/timeman.record.field.list",
+      "/timeman.record.field.get"
+      // Cross-module methods are cross-referenced from the rest-v3 pages above but
+      // belong to modules not actualized here — add them when those modules land:
+      //   user.get                                          — user module (seen on humanresources + timeman)
+      //   im.message.update / im.message.delete / im.dialog.messages.get  — im module (seen on tasks)
+      //   disk.storage.uploadfile / disk.folder.uploadfile /
+      //   disk.storage.getchildren / disk.folder.getchildren            — disk module (seen on tasks)
+      //
       // @todo When API.v3 arrives - change in AuthOAuthManager.initIsAdmin()
-      // '/profile' // waite
-      // '/main.message.get' // waite
-      // '/main.chat.update' // waite
-      // '/main.chat.list' // waite
-      // '/main.user.list' // waite
+      // '/profile' // wait
+      // '/main.message.get' // wait
+      // '/main.chat.update' // wait
+      // '/main.chat.list' // wait
+      // '/main.user.list' // wait
     ];
   }
   static create() {