@bitrix24/b24jssdk 1.3.0 → 2.0.0

package/dist/cjs/core/result.cjs

@@ -0,0 +1,137 @@
+/**
+ * @package @bitrix24/b24jssdk
+ * @version 2.0.0
+ * @copyright (c) 2026 Bitrix24
+ * @license MIT
+ * @see https://github.com/bitrix24/b24jssdk
+ * @see https://bitrix24.github.io/b24jssdk/
+ */
+'use strict';
+
+const text = require('../tools/text.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class Result {
+  static {
+    __name(this, "Result");
+  }
+  _errors;
+  _data;
+  constructor(data) {
+    this._errors = /* @__PURE__ */ new Map();
+    this._data = data ?? null;
+  }
+  get isSuccess() {
+    return this._errors.size === 0;
+  }
+  get errors() {
+    return this._errors;
+  }
+  setData(data) {
+    this._data = data;
+    return this;
+  }
+  getData() {
+    return this._data;
+  }
+  addError(error, key) {
+    const errorKey = key ?? text.Text.getUuidRfc4122();
+    const errorObj = typeof error === "string" ? new Error(error) : error;
+    this._errors.set(errorKey, errorObj);
+    return this;
+  }
+  addErrors(errors) {
+    for (const error of errors) {
+      this.addError(error);
+    }
+    return this;
+  }
+  getErrors() {
+    return this._errors.values();
+  }
+  hasError(key) {
+    return this._errors.has(key);
+  }
+  /**
+   * Retrieves an array of error messages from the collected errors.
+   *
+   * @returns An array of strings representing the error messages. Each string
+   *          contains the message of a corresponding error object.
+   */
+  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`.
+   *
+   * For batch calls the key tells you *which* command failed:
+   * - an **object / named-command batch** keys each error by the command label;
+   * - an **array-mode batch** keys each per-command error by its **numeric
+   *   position** (`'0'`, `'1'`, … as a string), matching the command order you
+   *   passed in. (#255 — previously these fell back to a random UUID.)
+   *
+   * An envelope-level soft error (not tied to one command) lands under the
+   * internal `'base-error'` key, and {@link Result.addErrors} (no explicit key)
+   * still uses generated UUIDs — for those, prefer {@link Result.getErrors} /
+   * {@link Result.getErrorMessages}. (#230)
+   *
+   * @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.
+   *
+   * @returns {string} Returns a string representation of the result operation
+   */
+  toString() {
+    const status = this.isSuccess ? "success" : "failure";
+    const data = this.safeStringify(this._data);
+    return this.isSuccess ? `Result(${status}): ${data}` : `Result(${status}): ${data}
+Errors: ${this.getErrorMessages().join(", ")}`;
+  }
+  safeStringify(data) {
+    try {
+      return JSON.stringify(data, this.replacer, 2);
+    } catch {
+      return "[Unable to serialize data]";
+    }
+  }
+  replacer(_, value) {
+    if (value instanceof Error) {
+      return {
+        name: value.name,
+        message: value.message,
+        stack: value.stack
+      };
+    }
+    return value;
+  }
+  // Static constructors
+  static ok(data) {
+    return new Result(data);
+  }
+  static fail(error, key) {
+    return new Result().addError(error, key);
+  }
+}
+
+exports.Result = Result;
+//# sourceMappingURL=result.cjs.map

package/dist/cjs/core/result.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.cjs","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   * For batch calls the key tells you *which* command failed:\n   * - an **object / named-command batch** keys each error by the command label;\n   * - an **array-mode batch** keys each per-command error by its **numeric\n   *   position** (`'0'`, `'1'`, … as a string), matching the command order you\n   *   passed in. (#255 — previously these fell back to a random UUID.)\n   *\n   * An envelope-level soft error (not tied to one command) lands under the\n   * internal `'base-error'` key, and {@link Result.addErrors} (no explicit key)\n   * still uses generated UUIDs — for those, prefer {@link Result.getErrors} /\n   * {@link Result.getErrorMessages}. (#230)\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":["Text"],"mappings":"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"}

package/dist/cjs/core/sdk-error.cjs

@@ -0,0 +1,85 @@
+/**
+ * @package @bitrix24/b24jssdk
+ * @version 2.0.0
+ * @copyright (c) 2026 Bitrix24
+ * @license MIT
+ * @see https://github.com/bitrix24/b24jssdk
+ * @see https://bitrix24.github.io/b24jssdk/
+ */
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class SdkError extends Error {
+  static {
+    __name(this, "SdkError");
+  }
+  code;
+  _status;
+  timestamp;
+  originalError;
+  constructor(params) {
+    const message = SdkError.formatErrorMessage(params);
+    super(message);
+    this.name = "SdkError";
+    this.code = params.code;
+    this._status = params.status;
+    this.originalError = params.originalError;
+    this.timestamp = /* @__PURE__ */ new Date();
+    this.cleanErrorStack();
+  }
+  get status() {
+    return this._status;
+  }
+  /**
+   * Creates SdkError from exception
+   */
+  static fromException(error, context) {
+    if (error instanceof SdkError) return error;
+    return new SdkError({
+      code: context?.code || "JSSDK_INTERNAL_ERROR",
+      status: context?.status || 500,
+      description: error instanceof Error ? error.message : `${error}`,
+      originalError: error
+    });
+  }
+  /**
+   * Serializes error for logging and debugging
+   */
+  toJSON() {
+    return {
+      name: this.name,
+      code: this.code,
+      message: this.message,
+      status: this._status,
+      timestamp: this.timestamp.toISOString(),
+      stack: this.stack
+    };
+  }
+  /**
+   * Formats error information for human-readable output
+   */
+  toString() {
+    let output = `[${this.name}] ${this.code} (${this._status}): ${this.message}`;
+    if (this.stack) {
+      output += `
+Stack trace:
+${this.stack}`;
+    }
+    return output;
+  }
+  static formatErrorMessage(params) {
+    if (!params?.description) {
+      return `Internal error`;
+    }
+    return `${params.description}`;
+  }
+  cleanErrorStack() {
+    if (typeof this.stack === "string") {
+      this.stack = this.stack.split("\n").filter((line) => !line.includes("SdkError.constructor")).join("\n");
+    }
+  }
+}
+
+exports.SdkError = SdkError;
+//# sourceMappingURL=sdk-error.cjs.map

package/dist/cjs/core/sdk-error.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-error.cjs","sources":["../../../src/core/sdk-error.ts"],"sourcesContent":["export type SdkErrorDetails = {\n  code: string\n  description?: string\n  status: number\n  originalError?: unknown\n}\n\n/**\n * Error in Sdk\n */\nexport class SdkError extends Error {\n  public readonly code: string\n  protected _status: number\n  public readonly timestamp: Date\n  public readonly originalError?: unknown\n\n  constructor(params: SdkErrorDetails) {\n    const message = SdkError.formatErrorMessage(params)\n    super(message)\n\n    this.name = 'SdkError' as const\n    this.code = params.code\n\n    this._status = params.status\n    this.originalError = params.originalError\n    this.timestamp = new Date()\n\n    this.cleanErrorStack()\n  }\n\n  get status(): number {\n    return this._status\n  }\n\n  /**\n   * Creates SdkError from exception\n   */\n  static fromException(error: unknown, context?: {\n    code?: string\n    status?: number\n  }): SdkError {\n    if (error instanceof SdkError) return error\n\n    return new SdkError({\n      code: context?.code || 'JSSDK_INTERNAL_ERROR',\n      status: context?.status || 500,\n      description: error instanceof Error ? error.message : `${error}`,\n      originalError: error\n    })\n  }\n\n  /**\n   * Serializes error for logging and debugging\n   */\n  toJSON() {\n    return {\n      name: this.name,\n      code: this.code,\n      message: this.message,\n      status: this._status,\n      timestamp: this.timestamp.toISOString(),\n      stack: this.stack\n    }\n  }\n\n  /**\n   * Formats error information for human-readable output\n   */\n  override toString(): string {\n    let output = `[${this.name}] ${this.code} (${this._status}): ${this.message}`\n\n    if (this.stack) {\n      output += `\\nStack trace:\\n${this.stack}`\n    }\n\n    return output\n  }\n\n  protected static formatErrorMessage(params: SdkErrorDetails): string {\n    if (!params?.description) {\n      return `Internal error`\n    }\n\n    return `${params.description}`\n  }\n\n  protected cleanErrorStack() {\n    if (typeof this.stack === 'string') {\n      this.stack = this.stack\n        .split('\\n')\n        .filter(line => !line.includes('SdkError.constructor'))\n        .join('\\n')\n    }\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;AAUO,MAAM,iBAAiB,KAAA,CAAM;AAAA,EAVpC;AAUoC,IAAA,MAAA,CAAA,IAAA,EAAA,UAAA,CAAA;AAAA;AAAA,EAClB,IAAA;AAAA,EACN,OAAA;AAAA,EACM,SAAA;AAAA,EACA,aAAA;AAAA,EAEhB,YAAY,MAAA,EAAyB;AACnC,IAAA,MAAM,OAAA,GAAU,QAAA,CAAS,kBAAA,CAAmB,MAAM,CAAA;AAClD,IAAA,KAAA,CAAM,OAAO,CAAA;AAEb,IAAA,IAAA,CAAK,IAAA,GAAO,UAAA;AACZ,IAAA,IAAA,CAAK,OAAO,MAAA,CAAO,IAAA;AAEnB,IAAA,IAAA,CAAK,UAAU,MAAA,CAAO,MAAA;AACtB,IAAA,IAAA,CAAK,gBAAgB,MAAA,CAAO,aAAA;AAC5B,IAAA,IAAA,CAAK,SAAA,uBAAgB,IAAA,EAAK;AAE1B,IAAA,IAAA,CAAK,eAAA,EAAgB;AAAA,EACvB;AAAA,EAEA,IAAI,MAAA,GAAiB;AACnB,IAAA,OAAO,IAAA,CAAK,OAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,aAAA,CAAc,KAAA,EAAgB,OAAA,EAGxB;AACX,IAAA,IAAI,KAAA,YAAiB,UAAU,OAAO,KAAA;AAEtC,IAAA,OAAO,IAAI,QAAA,CAAS;AAAA,MAClB,IAAA,EAAM,SAAS,IAAA,IAAQ,sBAAA;AAAA,MACvB,MAAA,EAAQ,SAAS,MAAA,IAAU,GAAA;AAAA,MAC3B,aAAa,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,GAAG,KAAK,CAAA,CAAA;AAAA,MAC9D,aAAA,EAAe;AAAA,KAChB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAA,GAAS;AACP,IAAA,OAAO;AAAA,MACL,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,QAAQ,IAAA,CAAK,OAAA;AAAA,MACb,SAAA,EAAW,IAAA,CAAK,SAAA,CAAU,WAAA,EAAY;AAAA,MACtC,OAAO,IAAA,CAAK;AAAA,KACd;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKS,QAAA,GAAmB;AAC1B,IAAA,IAAI,MAAA,GAAS,CAAA,CAAA,EAAI,IAAA,CAAK,IAAI,CAAA,EAAA,EAAK,IAAA,CAAK,IAAI,CAAA,EAAA,EAAK,IAAA,CAAK,OAAO,CAAA,GAAA,EAAM,IAAA,CAAK,OAAO,CAAA,CAAA;AAE3E,IAAA,IAAI,KAAK,KAAA,EAAO;AACd,MAAA,MAAA,IAAU;AAAA;AAAA,EAAmB,KAAK,KAAK,CAAA,CAAA;AAAA,IACzC;AAEA,IAAA,OAAO,MAAA;AAAA,EACT;AAAA,EAEA,OAAiB,mBAAmB,MAAA,EAAiC;AACnE,IAAA,IAAI,CAAC,QAAQ,WAAA,EAAa;AACxB,MAAA,OAAO,CAAA,cAAA,CAAA;AAAA,IACT;AAEA,IAAA,OAAO,CAAA,EAAG,OAAO,WAAW,CAAA,CAAA;AAAA,EAC9B;AAAA,EAEU,eAAA,GAAkB;AAC1B,IAAA,IAAI,OAAO,IAAA,CAAK,KAAA,KAAU,QAAA,EAAU;AAClC,MAAA,IAAA,CAAK,KAAA,GAAQ,IAAA,CAAK,KAAA,CACf,KAAA,CAAM,IAAI,CAAA,CACV,MAAA,CAAO,CAAA,IAAA,KAAQ,CAAC,KAAK,QAAA,CAAS,sBAAsB,CAAC,CAAA,CACrD,KAAK,IAAI,CAAA;AAAA,IACd;AAAA,EACF;AACF;;;;"}

package/dist/cjs/core/tools/abstract-tool.cjs

@@ -0,0 +1,26 @@
+/**
+ * @package @bitrix24/b24jssdk
+ * @version 2.0.0
+ * @copyright (c) 2026 Bitrix24
+ * @license MIT
+ * @see https://github.com/bitrix24/b24jssdk
+ * @see https://bitrix24.github.io/b24jssdk/
+ */
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class AbstractTool {
+  static {
+    __name(this, "AbstractTool");
+  }
+  _b24;
+  _logger;
+  constructor(b24, logger) {
+    this._b24 = b24;
+    this._logger = logger;
+  }
+}
+
+exports.AbstractTool = AbstractTool;
+//# sourceMappingURL=abstract-tool.cjs.map

package/dist/cjs/core/tools/abstract-tool.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-tool.cjs","sources":["../../../../src/core/tools/abstract-tool.ts"],"sourcesContent":["import type { TypeB24 } from '../../types/b24'\nimport type { LoggerInterface } from '../../types/logger'\n\n/**\n * Abstract Class for working with tools\n */\n\nexport type ToolOptions = {\n  [key: string]: any\n}\n\nexport abstract class AbstractTool {\n  protected _b24: TypeB24\n  protected _logger: LoggerInterface\n\n  constructor(b24: TypeB24, logger: LoggerInterface) {\n    this._b24 = b24\n    this._logger = logger\n  }\n\n  public abstract make(options?: ToolOptions): Promise<unknown>\n}\n"],"names":[],"mappings":";;;;;;;;;;;;AAWO,MAAe,YAAA,CAAa;AAAA,EAXnC;AAWmC,IAAA,MAAA,CAAA,IAAA,EAAA,cAAA,CAAA;AAAA;AAAA,EACvB,IAAA;AAAA,EACA,OAAA;AAAA,EAEV,WAAA,CAAY,KAAc,MAAA,EAAyB;AACjD,IAAA,IAAA,CAAK,IAAA,GAAO,GAAA;AACZ,IAAA,IAAA,CAAK,OAAA,GAAU,MAAA;AAAA,EACjB;AAGF;;;;"}

package/dist/cjs/core/tools/healthcheck.cjs

@@ -0,0 +1,50 @@
+/**
+ * @package @bitrix24/b24jssdk
+ * @version 2.0.0
+ * @copyright (c) 2026 Bitrix24
+ * @license MIT
+ * @see https://github.com/bitrix24/b24jssdk
+ * @see https://bitrix24.github.io/b24jssdk/
+ */
+'use strict';
+
+const abstractTool = require('./abstract-tool.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class HealthCheck extends abstractTool.AbstractTool {
+  static {
+    __name(this, "HealthCheck");
+  }
+  /**
+   * Checks the availability of the Bitrix24 REST API.
+   * Performs a simple request to the API to verify the service is operational and that the required access rights are present.
+   *
+   * @note The method uses a minimal API request (`server.time`) to check availability.
+   *   Does not overload the server with large amounts of data.
+   *
+   * @param options Some options for executing
+   *   - `requestId?: string` - Unique request identifier for tracking. Used for query deduplication and debugging (default: undefined)
+   *
+   * @returns {Promise<false>} Promise that resolves to a Boolean value:
+   *   - `true`: the API is available and responding
+   *   - `false`: the API is unavailable, an error occurred, or the required access rights are missing
+   *
+   * @see {@link Ping} To measure API response speed
+   */
+  async make(options) {
+    try {
+      const response = await this._b24.actions.v2.call.make({
+        method: "server.time",
+        params: {},
+        requestId: options?.requestId
+      });
+      return response.isSuccess;
+    } catch {
+      return false;
+    }
+  }
+}
+
+exports.HealthCheck = HealthCheck;
+//# sourceMappingURL=healthcheck.cjs.map

package/dist/cjs/core/tools/healthcheck.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthcheck.cjs","sources":["../../../../src/core/tools/healthcheck.ts"],"sourcesContent":["import type { ToolOptions } from './abstract-tool'\nimport { AbstractTool } from './abstract-tool'\n\n/**\n * HealthCheck `restApi:v2`\n *\n * @todo use apiVer3\n */\nexport class HealthCheck extends AbstractTool {\n  /**\n   * Checks the availability of the Bitrix24 REST API.\n   * Performs a simple request to the API to verify the service is operational and that the required access rights are present.\n   *\n   * @note The method uses a minimal API request (`server.time`) to check availability.\n   *   Does not overload the server with large amounts of data.\n   *\n   * @param options Some options for executing\n   *   - `requestId?: string` - Unique request identifier for tracking. Used for query deduplication and debugging (default: undefined)\n   *\n   * @returns {Promise<false>} Promise that resolves to a Boolean value:\n   *   - `true`: the API is available and responding\n   *   - `false`: the API is unavailable, an error occurred, or the required access rights are missing\n   *\n   * @see {@link Ping} To measure API response speed\n   */\n  public override async make(options?: ToolOptions & { requestId?: string }): Promise<boolean> {\n    try {\n      const response = await this._b24.actions.v2.call.make({\n        method: 'server.time',\n        params: {},\n        requestId: options?.requestId\n      })\n      return response.isSuccess\n    } catch {\n      return false\n    }\n  }\n}\n"],"names":["AbstractTool"],"mappings":";;;;;;;;;;;;;;AAQO,MAAM,oBAAoBA,yBAAA,CAAa;AAAA,EAR9C;AAQ8C,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,EAiB5C,MAAsB,KAAK,OAAA,EAAkE;AAC3F,IAAA,IAAI;AACF,MAAA,MAAM,WAAW,MAAM,IAAA,CAAK,KAAK,OAAA,CAAQ,EAAA,CAAG,KAAK,IAAA,CAAK;AAAA,QACpD,MAAA,EAAQ,aAAA;AAAA,QACR,QAAQ,EAAC;AAAA,QACT,WAAW,OAAA,EAAS;AAAA,OACrB,CAAA;AACD,MAAA,OAAO,QAAA,CAAS,SAAA;AAAA,IAClB,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AACF;;;;"}

package/dist/cjs/core/tools/manager.cjs

@@ -0,0 +1,52 @@
+/**
+ * @package @bitrix24/b24jssdk
+ * @version 2.0.0
+ * @copyright (c) 2026 Bitrix24
+ * @license MIT
+ * @see https://github.com/bitrix24/b24jssdk
+ * @see https://bitrix24.github.io/b24jssdk/
+ */
+'use strict';
+
+const ping = require('./ping.cjs');
+const healthcheck = require('./healthcheck.cjs');
+const loggerFactory = require('../../logger/logger-factory.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+const pingName = /* @__PURE__ */ Symbol("ping");
+const healthCheckName = /* @__PURE__ */ Symbol("healthCheck");
+class ToolsManager {
+  static {
+    __name(this, "ToolsManager");
+  }
+  _b24;
+  _logger;
+  _mapTools;
+  constructor(b24) {
+    this._b24 = b24;
+    this._logger = loggerFactory.LoggerFactory.createNullLogger();
+    this._mapTools = /* @__PURE__ */ new Map();
+  }
+  setLogger(logger) {
+    this._logger = logger;
+  }
+  getLogger() {
+    return this._logger;
+  }
+  get ping() {
+    if (!this._mapTools.has(pingName)) {
+      this._mapTools.set(pingName, new ping.Ping(this._b24, this._logger));
+    }
+    return this._mapTools.get(pingName);
+  }
+  get healthCheck() {
+    if (!this._mapTools.has(healthCheckName)) {
+      this._mapTools.set(healthCheckName, new healthcheck.HealthCheck(this._b24, this._logger));
+    }
+    return this._mapTools.get(healthCheckName);
+  }
+}
+
+exports.ToolsManager = ToolsManager;
+//# sourceMappingURL=manager.cjs.map

package/dist/cjs/core/tools/manager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.cjs","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":["LoggerFactory","Ping","HealthCheck"],"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,GAAUA,4BAAc,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,IAAIC,UAAK,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,IAAIC,wBAAY,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/cjs/core/tools/ping.cjs

@@ -0,0 +1,58 @@
+/**
+ * @package @bitrix24/b24jssdk
+ * @version 2.0.0
+ * @copyright (c) 2026 Bitrix24
+ * @license MIT
+ * @see https://github.com/bitrix24/b24jssdk
+ * @see https://bitrix24.github.io/b24jssdk/
+ */
+'use strict';
+
+const abstractTool = require('./abstract-tool.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class Ping extends abstractTool.AbstractTool {
+  static {
+    __name(this, "Ping");
+  }
+  /**
+   * Measures the response speed of the Bitrix24 REST API.
+   * Performs a test request and returns the response time in milliseconds.
+   * Useful for performance monitoring and diagnosing latency issues.
+   *
+   * @note The method uses a minimal API request (`server.time`) to check availability.
+   *   Does not overload the server with large amounts of data.
+   *
+   * @warning Response time may vary depending on server load, network conditions
+   *     and HTTP client settings (timeouts, retries).
+   *
+   * @tip For consistent results, it is recommended to perform multiple measurements
+   *     and use the median value.
+   *
+   * @param options Some options for executing
+   *   - `requestId?: string` - Unique request identifier for tracking. Used for query deduplication and debugging (default: undefined)
+   *
+   * @returns {Promise<number>} Promise that resolves to a response time in milliseconds:
+   *   - Positive number: time from sending the request to receiving the response
+   *   - In case of an error or timeout: `-1`
+   *
+   * @see {@link HealthCheck} To check API availability
+   */
+  async make(options) {
+    const startTime = Date.now();
+    try {
+      await this._b24.actions.v2.call.make({
+        method: "server.time",
+        params: {},
+        requestId: options?.requestId
+      });
+      return Date.now() - startTime;
+    } catch {
+      return -1;
+    }
+  }
+}
+
+exports.Ping = Ping;
+//# sourceMappingURL=ping.cjs.map

package/dist/cjs/core/tools/ping.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.cjs","sources":["../../../../src/core/tools/ping.ts"],"sourcesContent":["import type { ToolOptions } from './abstract-tool'\nimport { AbstractTool } from './abstract-tool'\n\n/**\n * Ping `restApi:v2`\n *\n * @todo use apiVer3\n */\nexport class Ping extends AbstractTool {\n  /**\n   * Measures the response speed of the Bitrix24 REST API.\n   * Performs a test request and returns the response time in milliseconds.\n   * Useful for performance monitoring and diagnosing latency issues.\n   *\n   * @note The method uses a minimal API request (`server.time`) to check availability.\n   *   Does not overload the server with large amounts of data.\n   *\n   * @warning Response time may vary depending on server load, network conditions\n   *     and HTTP client settings (timeouts, retries).\n   *\n   * @tip For consistent results, it is recommended to perform multiple measurements\n   *     and use the median value.\n   *\n   * @param options Some options for executing\n   *   - `requestId?: string` - Unique request identifier for tracking. Used for query deduplication and debugging (default: undefined)\n   *\n   * @returns {Promise<number>} Promise that resolves to a response time in milliseconds:\n   *   - Positive number: time from sending the request to receiving the response\n   *   - In case of an error or timeout: `-1`\n   *\n   * @see {@link HealthCheck} To check API availability\n   */\n  public override async make(options?: ToolOptions & { requestId?: string }): Promise<number> {\n    const startTime = Date.now()\n    try {\n      await this._b24.actions.v2.call.make({\n        method: 'server.time',\n        params: {},\n        requestId: options?.requestId\n      })\n      return Date.now() - startTime\n    } catch {\n      return -1\n    }\n  }\n}\n"],"names":["AbstractTool"],"mappings":";;;;;;;;;;;;;;AAQO,MAAM,aAAaA,yBAAA,CAAa;AAAA,EARvC;AAQuC,IAAA,MAAA,CAAA,IAAA,EAAA,MAAA,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,EAwBrC,MAAsB,KAAK,OAAA,EAAiE;AAC1F,IAAA,MAAM,SAAA,GAAY,KAAK,GAAA,EAAI;AAC3B,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,CAAK,IAAA,CAAK,OAAA,CAAQ,EAAA,CAAG,KAAK,IAAA,CAAK;AAAA,QACnC,MAAA,EAAQ,aAAA;AAAA,QACR,QAAQ,EAAC;AAAA,QACT,WAAW,OAAA,EAAS;AAAA,OACrB,CAAA;AACD,MAAA,OAAO,IAAA,CAAK,KAAI,GAAI,SAAA;AAAA,IACtB,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,EAAA;AAAA,IACT;AAAA,EACF;AACF;;;;"}

package/dist/cjs/core/version-manager.cjs

@@ -0,0 +1,57 @@
+/**
+ * @package @bitrix24/b24jssdk
+ * @version 2.0.0
+ * @copyright (c) 2026 Bitrix24
+ * @license MIT
+ * @see https://github.com/bitrix24/b24jssdk
+ * @see https://bitrix24.github.io/b24jssdk/
+ */
+'use strict';
+
+const b24 = require('../types/b24.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class VersionManager {
+  static {
+    __name(this, "VersionManager");
+  }
+  static create() {
+    return new VersionManager();
+  }
+  /**
+   * List of supported API versions.
+   * The highest version must be first.
+   */
+  getAllApiVersions() {
+    return [b24.ApiVersion.v3, b24.ApiVersion.v2];
+  }
+  /**
+   * Retained for backward compatibility. The SDK no longer keeps a v3 method
+   * allowlist, so support is not decided client-side any more — always returns
+   * `true`. Method existence is validated by the server.
+   */
+  isSupport(_version, _method) {
+    return true;
+  }
+  /**
+   * Returns the API version to use when the caller did not specify one. With the
+   * allowlist removed there is no client-side signal that a method is a v3
+   * method, so this defaults to v2 (the universal endpoint). Use the explicit
+   * `actions.v3.*` surface to call a method on v3.
+   */
+  automaticallyObtainApiVersion(_method) {
+    return b24.ApiVersion.v2;
+  }
+  /**
+   * Batch counterpart of {@link automaticallyObtainApiVersion}. Defaults to v2;
+   * call `actions.v3.batch.make` explicitly to run a batch on v3.
+   */
+  automaticallyObtainApiVersionForBatch(_calls) {
+    return b24.ApiVersion.v2;
+  }
+}
+const versionManager = VersionManager.create();
+
+exports.versionManager = versionManager;
+//# sourceMappingURL=version-manager.cjs.map

package/dist/cjs/core/version-manager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-manager.cjs","sources":["../../../src/core/version-manager.ts"],"sourcesContent":["import { ApiVersion } from '../types/b24'\nimport type {\n  BatchCommandsArrayUniversal,\n  BatchCommandsObjectUniversal,\n  BatchNamedCommandsUniversal\n} from '../types/http'\n\n/**\n * Decides which REST API version a method is routed through.\n *\n * The SDK no longer maintains a hardcoded v3 method allowlist. A portal's set of\n * v3 methods is large and version/edition-dependent (the authoritative list is\n * the portal's own OpenAPI document, `rest.documentation.openapi`), so gating on\n * a static list both lagged behind the server and blocked valid methods. The\n * server is now the single source of truth: an unknown v3 method simply comes\n * back as `METHODNOTFOUNDEXCEPTION`.\n *\n * Consequences:\n * - `actions.v3.*` no longer pre-flight-rejects a method — it is sent to the v3\n *   endpoint and the server validates it.\n * - v3 is opt-in only via the explicit `actions.v3.*` surface; version\n *   auto-detection therefore defaults to v2 (the universal endpoint).\n */\nclass VersionManager {\n  static create(): VersionManager {\n    return new VersionManager()\n  }\n\n  /**\n   * List of supported API versions.\n   * The highest version must be first.\n   */\n  public getAllApiVersions(): ApiVersion[] {\n    return [ApiVersion.v3, ApiVersion.v2]\n  }\n\n  /**\n   * Retained for backward compatibility. The SDK no longer keeps a v3 method\n   * allowlist, so support is not decided client-side any more — always returns\n   * `true`. Method existence is validated by the server.\n   */\n  public isSupport(_version: ApiVersion, _method: string): boolean {\n    return true\n  }\n\n  /**\n   * Returns the API version to use when the caller did not specify one. With the\n   * allowlist removed there is no client-side signal that a method is a v3\n   * method, so this defaults to v2 (the universal endpoint). Use the explicit\n   * `actions.v3.*` surface to call a method on v3.\n   */\n  public automaticallyObtainApiVersion(_method: string): ApiVersion {\n    return ApiVersion.v2\n  }\n\n  /**\n   * Batch counterpart of {@link automaticallyObtainApiVersion}. Defaults to v2;\n   * call `actions.v3.batch.make` explicitly to run a batch on v3.\n   */\n  public automaticallyObtainApiVersionForBatch(\n    _calls: BatchCommandsArrayUniversal | BatchCommandsObjectUniversal | BatchNamedCommandsUniversal\n  ): ApiVersion {\n    return ApiVersion.v2\n  }\n}\n\nexport const versionManager = VersionManager.create()\n"],"names":["ApiVersion"],"mappings":";;;;;;;;;;;;;;AAuBA,MAAM,cAAA,CAAe;AAAA,EAvBrB;AAuBqB,IAAA,MAAA,CAAA,IAAA,EAAA,gBAAA,CAAA;AAAA;AAAA,EACnB,OAAO,MAAA,GAAyB;AAC9B,IAAA,OAAO,IAAI,cAAA,EAAe;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,iBAAA,GAAkC;AACvC,IAAA,OAAO,CAACA,cAAA,CAAW,EAAA,EAAIA,cAAA,CAAW,EAAE,CAAA;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOO,SAAA,CAAU,UAAsB,OAAA,EAA0B;AAC/D,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQO,8BAA8B,OAAA,EAA6B;AAChE,IAAA,OAAOA,cAAA,CAAW,EAAA;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,sCACL,MAAA,EACY;AACZ,IAAA,OAAOA,cAAA,CAAW,EAAA;AAAA,EACpB;AACF;AAEO,MAAM,cAAA,GAAiB,eAAe,MAAA;;;;"}

package/dist/cjs/frame/auth.cjs

@@ -0,0 +1,100 @@
+/**
+ * @package @bitrix24/b24jssdk
+ * @version 2.0.0
+ * @copyright (c) 2026 Bitrix24
+ * @license MIT
+ * @see https://github.com/bitrix24/b24jssdk
+ * @see https://bitrix24.github.io/b24jssdk/
+ */
+'use strict';
+
+const commands = require('./message/commands.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class AuthManager {
+  static {
+    __name(this, "AuthManager");
+  }
+  #accessToken = null;
+  #refreshId = null;
+  #authExpires = 0;
+  #authExpiresIn = 0;
+  #memberId = null;
+  #isAdmin = false;
+  #appFrame;
+  #messageManager;
+  constructor(appFrame, messageManager) {
+    this.#appFrame = appFrame;
+    this.#messageManager = messageManager;
+  }
+  /**
+   * Initializes the data received from the parent window message.
+   * @param data
+   */
+  initData(data) {
+    if (data.AUTH_ID) {
+      this.#accessToken = data.AUTH_ID;
+      this.#refreshId = data.REFRESH_ID;
+      this.#authExpiresIn = Number.parseInt(data.AUTH_EXPIRES);
+      this.#authExpires = Date.now() + this.#authExpiresIn * 1e3;
+      this.#isAdmin = data.IS_ADMIN;
+      this.#memberId = data.MEMBER_ID || "";
+    }
+    return this;
+  }
+  /**
+   * Returns authorization data
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-functions/bx24-get-auth.html
+   */
+  getAuthData() {
+    return this.#authExpires > Date.now() ? {
+      access_token: this.#accessToken,
+      refresh_token: this.#refreshId,
+      expires: this.#authExpires / 1e3,
+      expires_in: this.#authExpiresIn,
+      domain: this.#appFrame.getTargetOrigin(),
+      member_id: this.#memberId
+    } : false;
+  }
+  /**
+   * Updates authorization data through the parent window
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-functions/bx24-refresh-auth.html
+   */
+  async refreshAuth() {
+    return this.#messageManager.send(commands.MessageCommands.refreshAuth, {}).then((data) => {
+      this.#accessToken = data.AUTH_ID;
+      this.#refreshId = data.REFRESH_ID;
+      this.#authExpires = Date.now() + Number.parseInt(data.AUTH_EXPIRES) * 1e3;
+      return Promise.resolve(this.getAuthData());
+    });
+  }
+  getUniq(prefix) {
+    return [prefix, this.#memberId || ""].join("_");
+  }
+  /**
+   * Determines whether the current user has administrator rights
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-is-admin.html
+   */
+  get isAdmin() {
+    return this.#isAdmin;
+  }
+  /**
+   * @inheritDoc
+   */
+  getTargetOrigin() {
+    return this.#appFrame.getTargetOrigin();
+  }
+  /**
+   * @inheritDoc
+   */
+  getTargetOriginWithPath() {
+    return this.#appFrame.getTargetOriginWithPath();
+  }
+}
+
+exports.AuthManager = AuthManager;
+//# sourceMappingURL=auth.cjs.map

package/dist/cjs/frame/auth.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.cjs","sources":["../../../src/frame/auth.ts"],"sourcesContent":["import type { AppFrame } from './frame'\nimport type { MessageManager } from './message'\nimport type { AuthActions, AuthData, RefreshAuthData, MessageInitData } from '../types/auth'\nimport type { ApiVersion } from '../types/b24'\nimport { MessageCommands } from './message'\n\n/**\n * Authorization Manager\n */\nexport class AuthManager implements AuthActions {\n  #accessToken: null | string = null\n  #refreshId: null | string = null\n  #authExpires: number = 0\n  #authExpiresIn: number = 0\n  #memberId: null | string = null\n\n  #isAdmin: boolean = false\n\n  #appFrame: AppFrame\n  #messageManager: MessageManager\n\n  constructor(\n    appFrame: AppFrame,\n    messageManager: MessageManager\n  ) {\n    this.#appFrame = appFrame\n    this.#messageManager = messageManager\n  }\n\n  /**\n   * Initializes the data received from the parent window message.\n   * @param data\n   */\n  public initData(data: MessageInitData): AuthManager {\n    if (data.AUTH_ID) {\n      this.#accessToken = data.AUTH_ID\n      this.#refreshId = data.REFRESH_ID\n      this.#authExpiresIn = Number.parseInt(data.AUTH_EXPIRES)\n      this.#authExpires = Date.now() + this.#authExpiresIn * 1_000\n\n      this.#isAdmin = data.IS_ADMIN\n      this.#memberId = data.MEMBER_ID || ''\n    }\n\n    return this\n  }\n\n  /**\n   * Returns authorization data\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-functions/bx24-get-auth.html\n   */\n  public getAuthData(): false | AuthData {\n    return this.#authExpires > Date.now()\n      ? ({\n          access_token: this.#accessToken,\n          refresh_token: this.#refreshId,\n          expires: this.#authExpires / 1_000,\n          expires_in: this.#authExpiresIn,\n          domain: this.#appFrame.getTargetOrigin(),\n          member_id: this.#memberId\n        } as AuthData)\n      : false\n  }\n\n  /**\n   * Updates authorization data through the parent window\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-functions/bx24-refresh-auth.html\n   */\n  public async refreshAuth(): Promise<AuthData> {\n    return this.#messageManager\n      .send(MessageCommands.refreshAuth, {})\n      .then((data: RefreshAuthData) => {\n        this.#accessToken = data.AUTH_ID\n        this.#refreshId = data.REFRESH_ID\n        this.#authExpires = Date.now() + Number.parseInt(data.AUTH_EXPIRES) * 1_000\n\n        return Promise.resolve(this.getAuthData() as AuthData)\n      })\n  }\n\n  public getUniq(prefix: string): string {\n    return [prefix, this.#memberId || ''].join('_')\n  }\n\n  /**\n   * Determines whether the current user has administrator rights\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-is-admin.html\n   */\n  get isAdmin(): boolean {\n    return this.#isAdmin\n  }\n\n  /**\n   * @inheritDoc\n   */\n  public getTargetOrigin(): string {\n    return this.#appFrame.getTargetOrigin()\n  }\n\n  /**\n   * @inheritDoc\n   */\n  public getTargetOriginWithPath(): Map<ApiVersion, string> {\n    return this.#appFrame.getTargetOriginWithPath()\n  }\n}\n"],"names":["MessageCommands"],"mappings":"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"}