@bitrix24/b24jssdk 0.5.1 → 1.0.2

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

@@ -0,0 +1,56 @@
+/**
+ * @package @bitrix24/b24jssdk
+ * @version 1.0.2
+ * @copyright (c) 2026 Bitrix24
+ * @license MIT
+ * @see https://github.com/bitrix24/b24jssdk
+ * @see https://bitrix24.github.io/b24jssdk/
+ */
+import { AbstractTool } from './abstract-tool.mjs';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class Ping extends 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;
+    }
+  }
+}
+
+export { Ping };
+//# sourceMappingURL=ping.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ping.mjs","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":[],"mappings":";;;;;;;;;;;;AAQO,MAAM,aAAa,YAAA,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/esm/core/version-manager.mjs

@@ -0,0 +1,116 @@
+/**
+ * @package @bitrix24/b24jssdk
+ * @version 1.0.2
+ * @copyright (c) 2026 Bitrix24
+ * @license MIT
+ * @see https://github.com/bitrix24/b24jssdk
+ * @see https://bitrix24.github.io/b24jssdk/
+ */
+import { ApiVersion } from '../types/b24.mjs';
+import { ParseRow } from './interaction/batch/parse-row.mjs';
+import { SdkError } from './sdk-error.mjs';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class VersionManager {
+  static {
+    __name(this, "VersionManager");
+  }
+  #supportMethods;
+  constructor() {
+    this.#supportMethods = [
+      "/batch",
+      // done
+      "/scopes",
+      // done
+      "/rest.scope.list",
+      // done
+      "/rest.documentation.openapi",
+      "/documentation",
+      /** @see /settings/configs/event_log.php */
+      "/main.eventlog.list",
+      // done
+      "/main.eventlog.get",
+      // done
+      "/main.eventlog.tail",
+      // done
+      "/tasks.task.chat.message.send",
+      "/tasks.task.access.get",
+      "/tasks.task.file.attach",
+      "/tasks.task.update",
+      // done
+      "/tasks.task.delete",
+      "/tasks.task.add",
+      "/tasks.task.get"
+      // done
+      // @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
+    ];
+  }
+  static create() {
+    return new VersionManager();
+  }
+  /**
+   * List of supported API versions
+   * The highest version must be first
+   */
+  getAllApiVersions() {
+    return [ApiVersion.v3, ApiVersion.v2];
+  }
+  isSupport(version, method) {
+    switch (version) {
+      case ApiVersion.v3:
+        return this.#v3Support(method);
+      case ApiVersion.v2:
+        return true;
+    }
+    return false;
+  }
+  #v3Support(method) {
+    return this.#supportMethods.includes(`/${method}`);
+  }
+  /**
+   * Automatically obtain the API version
+   */
+  automaticallyObtainApiVersion(method) {
+    const version = this.getAllApiVersions().find((version2) => versionManager.isSupport(version2, method));
+    if (!version) {
+      throw new SdkError({
+        code: "JSSDK_VERSION_MANAGER_NOT_DETECT_FOR_METHOD",
+        description: `No API version found that supports method ${method}.`,
+        status: 500
+      });
+    }
+    return version;
+  }
+  /**
+   * Automatically obtain the API version for Batch
+   *
+   * @todo test methods
+   *   `[['crm.item.get', { entityTypeId: 3, id: 1 }]]`
+   *   `[{ method: 'crm.item.get', params: { entityTypeId: 3, id: 1 } }]`
+   *   `{ cmd1: { method: 'crm.item.get', params: { entityTypeId: 3, id: 1 } }, cmd2: ['crm.item.get', { entityTypeId: 2, id: 2 }] }`
+   */
+  automaticallyObtainApiVersionForBatch(calls) {
+    const commands = ParseRow.getMethodsFromCommands(calls);
+    let isAllSupportV3 = true;
+    for (const [_, method] of commands.entries()) {
+      if (!this.isSupport(ApiVersion.v3, method)) {
+        isAllSupportV3 = false;
+        break;
+      }
+    }
+    if (isAllSupportV3) {
+      return ApiVersion.v3;
+    }
+    return ApiVersion.v2;
+  }
+}
+const versionManager = VersionManager.create();
+
+export { versionManager };
+//# sourceMappingURL=version-manager.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version-manager.mjs","sources":["../../../src/core/version-manager.ts"],"sourcesContent":["import { ApiVersion } from '../types/b24'\nimport type {\n  BatchCommandsArrayUniversal,\n  BatchCommandsObjectUniversal,\n  BatchNamedCommandsUniversal\n} from '../types/http'\nimport { ParseRow } from './interaction/batch/parse-row'\nimport { SdkError } from './sdk-error'\n\n/**\n * @todo add docs ??\n */\nclass VersionManager {\n  #supportMethods: string[]\n\n  constructor() {\n    /**\n     * get from https://{portal}/rest/api/{user_id}/{webhook}/documentation\n     * @see https://apidocs.bitrix24.com/api-reference/rest-v3/index.html#openapi\n     */\n    this.#supportMethods = [\n      '/batch', // done\n      '/scopes', // done\n      '/rest.scope.list', // done\n      '/rest.documentation.openapi',\n      '/documentation',\n      /** @see /settings/configs/event_log.php */\n      '/main.eventlog.list', // done\n      '/main.eventlog.get', // done\n      '/main.eventlog.tail', // done\n      '/tasks.task.chat.message.send',\n      '/tasks.task.access.get',\n      '/tasks.task.file.attach',\n      '/tasks.task.update', // done\n      '/tasks.task.delete',\n      '/tasks.task.add',\n      '/tasks.task.get' // done\n      // @todo When API.v3 arrives - change in AuthOAuthManager.initIsAdmin()\n      // '/profile' // waite\n      // '/main.message.get' // waite\n      // '/main.chat.update' // waite\n      // '/main.chat.list' // waite\n      // '/main.user.list' // waite\n    ]\n  }\n\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  public isSupport(version: ApiVersion, method: string): boolean {\n    switch (version) {\n      case ApiVersion.v3:\n        return this.#v3Support(method)\n      case ApiVersion.v2:\n        return true\n    }\n\n    return false\n  }\n\n  #v3Support(method: string): boolean {\n    return this.#supportMethods.includes(`/${method}`)\n  }\n\n  /**\n   * Automatically obtain the API version\n   */\n  public automaticallyObtainApiVersion(method: string): ApiVersion {\n    const version = this.getAllApiVersions().find(version => versionManager.isSupport(version, method))\n    if (!version) {\n      throw new SdkError({\n        code: 'JSSDK_VERSION_MANAGER_NOT_DETECT_FOR_METHOD',\n        description: `No API version found that supports method ${method}.`,\n        status: 500\n      })\n    }\n\n    return version\n  }\n\n  /**\n   * Automatically obtain the API version for Batch\n   *\n   * @todo test methods\n   *   `[['crm.item.get', { entityTypeId: 3, id: 1 }]]`\n   *   `[{ method: 'crm.item.get', params: { entityTypeId: 3, id: 1 } }]`\n   *   `{ cmd1: { method: 'crm.item.get', params: { entityTypeId: 3, id: 1 } }, cmd2: ['crm.item.get', { entityTypeId: 2, id: 2 }] }`\n   */\n  public automaticallyObtainApiVersionForBatch(\n    calls: BatchCommandsArrayUniversal | BatchCommandsObjectUniversal | BatchNamedCommandsUniversal\n  ): ApiVersion {\n    const commands = ParseRow.getMethodsFromCommands(calls)\n\n    let isAllSupportV3 = true\n    for (const [_, method] of commands.entries()) {\n      if (!this.isSupport(ApiVersion.v3, method)) {\n        isAllSupportV3 = false\n        break\n      }\n    }\n\n    if (isAllSupportV3) {\n      return ApiVersion.v3\n    }\n    return ApiVersion.v2\n  }\n}\n\nexport const versionManager = VersionManager.create()\n"],"names":["version"],"mappings":";;;;;;;;;;;;;;AAYA,MAAM,cAAA,CAAe;AAAA,EAZrB;AAYqB,IAAA,MAAA,CAAA,IAAA,EAAA,gBAAA,CAAA;AAAA;AAAA,EACnB,eAAA;AAAA,EAEA,WAAA,GAAc;AAKZ,IAAA,IAAA,CAAK,eAAA,GAAkB;AAAA,MACrB,QAAA;AAAA;AAAA,MACA,SAAA;AAAA;AAAA,MACA,kBAAA;AAAA;AAAA,MACA,6BAAA;AAAA,MACA,gBAAA;AAAA;AAAA,MAEA,qBAAA;AAAA;AAAA,MACA,oBAAA;AAAA;AAAA,MACA,qBAAA;AAAA;AAAA,MACA,+BAAA;AAAA,MACA,wBAAA;AAAA,MACA,yBAAA;AAAA,MACA,oBAAA;AAAA;AAAA,MACA,oBAAA;AAAA,MACA,iBAAA;AAAA,MACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,KAOF;AAAA,EACF;AAAA,EAEA,OAAO,MAAA,GAAyB;AAC9B,IAAA,OAAO,IAAI,cAAA,EAAe;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,iBAAA,GAAkC;AACvC,IAAA,OAAO,CAAC,UAAA,CAAW,EAAA,EAAI,UAAA,CAAW,EAAE,CAAA;AAAA,EACtC;AAAA,EAEO,SAAA,CAAU,SAAqB,MAAA,EAAyB;AAC7D,IAAA,QAAQ,OAAA;AAAS,MACf,KAAK,UAAA,CAAW,EAAA;AACd,QAAA,OAAO,IAAA,CAAK,WAAW,MAAM,CAAA;AAAA,MAC/B,KAAK,UAAA,CAAW,EAAA;AACd,QAAA,OAAO,IAAA;AAAA;AAGX,IAAA,OAAO,KAAA;AAAA,EACT;AAAA,EAEA,WAAW,MAAA,EAAyB;AAClC,IAAA,OAAO,IAAA,CAAK,eAAA,CAAgB,QAAA,CAAS,CAAA,CAAA,EAAI,MAAM,CAAA,CAAE,CAAA;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA,EAKO,8BAA8B,MAAA,EAA4B;AAC/D,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,iBAAA,EAAkB,CAAE,IAAA,CAAK,CAAAA,QAAAA,KAAW,cAAA,CAAe,SAAA,CAAUA,QAAAA,EAAS,MAAM,CAAC,CAAA;AAClG,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,MAAM,IAAI,QAAA,CAAS;AAAA,QACjB,IAAA,EAAM,6CAAA;AAAA,QACN,WAAA,EAAa,6CAA6C,MAAM,CAAA,CAAA,CAAA;AAAA,QAChE,MAAA,EAAQ;AAAA,OACT,CAAA;AAAA,IACH;AAEA,IAAA,OAAO,OAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUO,sCACL,KAAA,EACY;AACZ,IAAA,MAAM,QAAA,GAAW,QAAA,CAAS,sBAAA,CAAuB,KAAK,CAAA;AAEtD,IAAA,IAAI,cAAA,GAAiB,IAAA;AACrB,IAAA,KAAA,MAAW,CAAC,CAAA,EAAG,MAAM,CAAA,IAAK,QAAA,CAAS,SAAQ,EAAG;AAC5C,MAAA,IAAI,CAAC,IAAA,CAAK,SAAA,CAAU,UAAA,CAAW,EAAA,EAAI,MAAM,CAAA,EAAG;AAC1C,QAAA,cAAA,GAAiB,KAAA;AACjB,QAAA;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAI,cAAA,EAAgB;AAClB,MAAA,OAAO,UAAA,CAAW,EAAA;AAAA,IACpB;AACA,IAAA,OAAO,UAAA,CAAW,EAAA;AAAA,EACpB;AACF;AAEO,MAAM,cAAA,GAAiB,eAAe,MAAA;;;;"}

package/dist/esm/frame/auth.mjs

@@ -0,0 +1,98 @@
+/**
+ * @package @bitrix24/b24jssdk
+ * @version 1.0.2
+ * @copyright (c) 2026 Bitrix24
+ * @license MIT
+ * @see https://github.com/bitrix24/b24jssdk
+ * @see https://bitrix24.github.io/b24jssdk/
+ */
+import { MessageCommands } from './message/commands.mjs';
+
+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(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();
+  }
+}
+
+export { AuthManager };
+//# sourceMappingURL=auth.mjs.map

package/dist/esm/frame/auth.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.mjs","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":[],"mappings":"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"}

package/dist/esm/frame/b24.mjs

@@ -0,0 +1,170 @@
+/**
+ * @package @bitrix24/b24jssdk
+ * @version 1.0.2
+ * @copyright (c) 2026 Bitrix24
+ * @license MIT
+ * @see https://github.com/bitrix24/b24jssdk
+ * @see https://bitrix24.github.io/b24jssdk/
+ */
+import { AbstractB24 } from '../core/abstract-b24.mjs';
+import { HttpV2 } from '../core/http/v2.mjs';
+import { HttpV3 } from '../core/http/v3.mjs';
+import { AppFrame } from './frame.mjs';
+import { AuthManager } from './auth.mjs';
+import { ParentManager } from './parent.mjs';
+import { OptionsManager } from './options.mjs';
+import { DialogManager } from './dialog.mjs';
+import { SliderManager } from './slider.mjs';
+import { PlacementManager } from './placement.mjs';
+import { MessageManager } from './message/controller.mjs';
+import { MessageCommands } from './message/commands.mjs';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class B24Frame extends AbstractB24 {
+  static {
+    __name(this, "B24Frame");
+  }
+  #isInstallMode = false;
+  #isFirstRun = false;
+  #appFrame;
+  #messageManager;
+  #authManager;
+  #parentManager;
+  #optionsManager;
+  #dialogManager;
+  #sliderManager;
+  #placementManager;
+  #restrictionParams;
+  // region Init ////
+  constructor(queryParams, options) {
+    super();
+    this.#restrictionParams = options?.restrictionParams;
+    this.#appFrame = new AppFrame(queryParams);
+    this.#messageManager = new MessageManager(this.#appFrame);
+    this.#messageManager.subscribe();
+    this.#authManager = new AuthManager(
+      this.#appFrame,
+      this.#messageManager
+    );
+    this.#parentManager = new ParentManager(this.#messageManager);
+    this.#optionsManager = new OptionsManager(this.#messageManager);
+    this.#dialogManager = new DialogManager(this.#messageManager);
+    this.#sliderManager = new SliderManager(
+      this.#appFrame,
+      this.#messageManager
+    );
+    this.#placementManager = new PlacementManager(this.#messageManager);
+    this._isInit = false;
+  }
+  setLogger(logger) {
+    super.setLogger(logger);
+    this.#messageManager.setLogger(this.getLogger());
+  }
+  get isFirstRun() {
+    this._ensureInitialized();
+    return this.#isFirstRun;
+  }
+  get isInstallMode() {
+    this._ensureInitialized();
+    return this.#isInstallMode;
+  }
+  get parent() {
+    this._ensureInitialized();
+    return this.#parentManager;
+  }
+  get auth() {
+    this._ensureInitialized();
+    return this.#authManager;
+  }
+  get slider() {
+    this._ensureInitialized();
+    return this.#sliderManager;
+  }
+  get placement() {
+    this._ensureInitialized();
+    return this.#placementManager;
+  }
+  get options() {
+    this._ensureInitialized();
+    return this.#optionsManager;
+  }
+  get dialog() {
+    this._ensureInitialized();
+    return this.#dialogManager;
+  }
+  async init() {
+    const data = await this.#messageManager.send(MessageCommands.getInitData, {});
+    this.getLogger().debug("init data", { data });
+    this.#appFrame.initData(data);
+    this.#authManager.initData(data);
+    this.#placementManager.initData(data);
+    this.#optionsManager.initData(data);
+    this.#isInstallMode = data.INSTALL;
+    this.#isFirstRun = data.FIRST_RUN;
+    this._httpV2 = new HttpV2(this.#authManager, this._getHttpOptions(), this.#restrictionParams);
+    this._httpV3 = new HttpV3(this.#authManager, this._getHttpOptions(), this.#restrictionParams);
+    this._isInit = true;
+    if (this.#isFirstRun) {
+      return this.#messageManager.send(MessageCommands.setInstall, { install: true });
+    }
+    return Promise.resolve();
+  }
+  /**
+   * Destructor.
+   * Removes an event subscription
+   */
+  destroy() {
+    this.#messageManager.unsubscribe();
+    super.destroy();
+  }
+  // endregion ////
+  // region Core ////
+  /**
+   * Signals that the installer or application setup has finished running.
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-functions/bx24-install-finish.html
+   */
+  async installFinish() {
+    if (!this.isInstallMode) {
+      return Promise.reject(new Error("Application was previously installed. You cannot call installFinish"));
+    }
+    return this.#messageManager.send(MessageCommands.setInstallFinish, {});
+  }
+  // endregion ////
+  // region Get ////
+  /**
+   * @inheritDoc
+   */
+  getTargetOrigin() {
+    this._ensureInitialized();
+    return this.#authManager.getTargetOrigin();
+  }
+  /**
+   * @inheritDoc
+   */
+  getTargetOriginWithPath() {
+    this._ensureInitialized();
+    return this.#authManager.getTargetOriginWithPath();
+  }
+  /**
+   * Returns the sid of the application relative to the parent window like this `9c33468728e1d2c8c97562475edfd96`
+   */
+  getAppSid() {
+    this._ensureInitialized();
+    return this.#appFrame.getAppSid();
+  }
+  /**
+   * Returns the localization of the B24 interface
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-get-lang.html
+   */
+  getLang() {
+    this._ensureInitialized();
+    return this.#appFrame.getLang();
+  }
+  // endregion ////
+}
+
+export { B24Frame };
+//# sourceMappingURL=b24.mjs.map

package/dist/esm/frame/b24.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"b24.mjs","sources":["../../../src/frame/b24.ts"],"sourcesContent":["import type { LoggerInterface } from '../logger'\nimport type { B24LangList } from '../core/language/list'\nimport type { AuthActions, MessageInitData, B24FrameQueryParams } from '../types/auth'\nimport type { RestrictionParams } from '../types/limiters'\nimport type { TypeB24, ApiVersion } from '../types/b24'\nimport { AbstractB24 } from '../core/abstract-b24'\nimport { HttpV2 } from '../core/http/v2'\nimport { HttpV3 } from '../core/http/v3'\nimport { AppFrame } from './frame'\nimport { MessageManager, MessageCommands } from './message'\nimport { AuthManager } from './auth'\nimport { ParentManager } from './parent'\nimport { OptionsManager } from './options'\nimport { DialogManager } from './dialog'\nimport { SliderManager } from './slider'\nimport { PlacementManager } from './placement'\n\n/**\n * B24 Manager. Replacement api.bitrix24.com\n *\n * @link https://api.bitrix24.com/api/v1/\n * @link https://bitrix24.github.io/b24jssdk/docs/frame/\n * @see /bitrix/js/rest/applayout.js\n *\n * @todo add docs\n */\nexport class B24Frame extends AbstractB24 implements TypeB24 {\n  #isInstallMode: boolean = false\n  #isFirstRun: boolean = false\n\n  readonly #appFrame: AppFrame\n  readonly #messageManager: MessageManager\n  readonly #authManager: AuthManager\n  readonly #parentManager: ParentManager\n  readonly #optionsManager: OptionsManager\n  readonly #dialogManager: DialogManager\n  readonly #sliderManager: SliderManager\n  readonly #placementManager: PlacementManager\n\n  readonly #restrictionParams: undefined | Partial<RestrictionParams>\n\n  // region Init ////\n  constructor(\n    queryParams: B24FrameQueryParams,\n    options?: {\n      restrictionParams?: Partial<RestrictionParams>\n    }\n  ) {\n    super()\n\n    this.#restrictionParams = options?.restrictionParams\n\n    this.#appFrame = new AppFrame(queryParams)\n\n    this.#messageManager = new MessageManager(this.#appFrame)\n    this.#messageManager.subscribe()\n\n    this.#authManager = new AuthManager(\n      this.#appFrame,\n      this.#messageManager\n    )\n    this.#parentManager = new ParentManager(this.#messageManager)\n    this.#optionsManager = new OptionsManager(this.#messageManager)\n    this.#dialogManager = new DialogManager(this.#messageManager)\n    this.#sliderManager = new SliderManager(\n      this.#appFrame,\n      this.#messageManager\n    )\n    this.#placementManager = new PlacementManager(this.#messageManager)\n\n    this._isInit = false\n  }\n\n  public override setLogger(logger: LoggerInterface): void {\n    super.setLogger(logger)\n    this.#messageManager.setLogger(this.getLogger())\n  }\n\n  get isFirstRun(): boolean {\n    this._ensureInitialized()\n    return this.#isFirstRun\n  }\n\n  get isInstallMode(): boolean {\n    this._ensureInitialized()\n    return this.#isInstallMode\n  }\n\n  get parent(): ParentManager {\n    this._ensureInitialized()\n    return this.#parentManager\n  }\n\n  override get auth(): AuthActions {\n    this._ensureInitialized()\n    return this.#authManager\n  }\n\n  get slider(): SliderManager {\n    this._ensureInitialized()\n    return this.#sliderManager\n  }\n\n  get placement(): PlacementManager {\n    this._ensureInitialized()\n    return this.#placementManager\n  }\n\n  get options(): OptionsManager {\n    this._ensureInitialized()\n    return this.#optionsManager\n  }\n\n  get dialog(): DialogManager {\n    this._ensureInitialized()\n    return this.#dialogManager\n  }\n\n  public override async init(): Promise<void> {\n    const data: MessageInitData = await this.#messageManager.send(MessageCommands.getInitData, {})\n\n    this.getLogger().debug('init data', { data })\n\n    this.#appFrame.initData(data)\n    this.#authManager.initData(data)\n    this.#placementManager.initData(data)\n    this.#optionsManager.initData(data)\n\n    this.#isInstallMode = data.INSTALL\n    this.#isFirstRun = data.FIRST_RUN\n\n    this._httpV2 = new HttpV2(this.#authManager, this._getHttpOptions(), this.#restrictionParams)\n    this._httpV3 = new HttpV3(this.#authManager, this._getHttpOptions(), this.#restrictionParams)\n\n    this._isInit = true\n\n    /**\n     * @memo Writes the fact of the 1st launch to `app_options`\n     */\n    if (this.#isFirstRun) {\n      return this.#messageManager.send(MessageCommands.setInstall, { install: true })\n    }\n\n    return Promise.resolve()\n  }\n\n  /**\n   * Destructor.\n   * Removes an event subscription\n   */\n  public override destroy() {\n    this.#messageManager.unsubscribe()\n    super.destroy()\n  }\n  // endregion ////\n\n  // region Core ////\n  /**\n   * Signals that the installer or application setup has finished running.\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-functions/bx24-install-finish.html\n   */\n  public async installFinish(): Promise<any> {\n    if (!this.isInstallMode) {\n      return Promise.reject(new Error('Application was previously installed. You cannot call installFinish'))\n    }\n\n    return this.#messageManager.send(MessageCommands.setInstallFinish, {})\n  }\n  // endregion ////\n\n  // region Get ////\n  /**\n   * @inheritDoc\n   */\n  public override getTargetOrigin(): string {\n    this._ensureInitialized()\n    return this.#authManager.getTargetOrigin()\n  }\n\n  /**\n   * @inheritDoc\n   */\n  public override getTargetOriginWithPath(): Map<ApiVersion, string> {\n    this._ensureInitialized()\n    return this.#authManager.getTargetOriginWithPath()\n  }\n\n  /**\n   * Returns the sid of the application relative to the parent window like this `9c33468728e1d2c8c97562475edfd96`\n   */\n  public getAppSid(): string {\n    this._ensureInitialized()\n    return this.#appFrame.getAppSid()\n  }\n\n  /**\n   * Returns the localization of the B24 interface\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-get-lang.html\n   */\n  public getLang(): B24LangList {\n    this._ensureInitialized()\n    return this.#appFrame.getLang()\n  }\n  // endregion ////\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/frame/dialog.mjs

@@ -0,0 +1,78 @@
+/**
+ * @package @bitrix24/b24jssdk
+ * @version 1.0.2
+ * @copyright (c) 2026 Bitrix24
+ * @license MIT
+ * @see https://github.com/bitrix24/b24jssdk
+ * @see https://bitrix24.github.io/b24jssdk/
+ */
+import { MessageCommands } from './message/commands.mjs';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class DialogManager {
+  static {
+    __name(this, "DialogManager");
+  }
+  #messageManager;
+  constructor(messageManager) {
+    this.#messageManager = messageManager;
+  }
+  /**
+   * Method displays the standard single user selection dialog
+   * It only shows company employees
+   *
+   * @return {Promise<null|SelectedUser>}
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-user.html
+   */
+  async selectUser() {
+    return this.#messageManager.send(MessageCommands.selectUser, {
+      mult: false
+    });
+  }
+  /**
+   * Method displays the standard multiple user selection dialog
+   * It only shows company employees
+   *
+   * @return {Promise<SelectedUser[]>}
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-users.html
+   */
+  async selectUsers() {
+    return this.#messageManager.send(MessageCommands.selectUser, {
+      mult: true
+    });
+  }
+  /**
+   * Method displays a standard access permission selection dialog
+   *
+   * @param {string[]} blockedAccessPermissions
+   * @return {Promise<SelectedAccess[]>}
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-access.html
+   */
+  async selectAccess(blockedAccessPermissions = []) {
+    return this.#messageManager.send(MessageCommands.selectAccess, {
+      value: blockedAccessPermissions
+    });
+  }
+  /**
+   * Method invokes the system dialog for selecting a CRM entity
+   *
+   * @param {SelectCRMParams} params
+   * @return {Promise<SelectedCRM>}
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-crm.html
+   */
+  async selectCRM(params) {
+    return this.#messageManager.send(MessageCommands.selectCRM, {
+      entityType: params?.entityType,
+      multiple: params?.multiple,
+      value: params?.value
+    });
+  }
+}
+
+export { DialogManager };
+//# sourceMappingURL=dialog.mjs.map

package/dist/esm/frame/dialog.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.mjs","sources":["../../../src/frame/dialog.ts"],"sourcesContent":["import type { MessageManager } from './message'\nimport { MessageCommands } from './message'\nimport type { NumberString } from '../types/common'\n\nexport type SelectedUser = {\n  /**\n   * user identifier\n   */\n  id: NumberString\n\n  /**\n   * formatted username\n   */\n  name: string\n\n  photo: string\n\n  position: string\n\n  url: string\n\n  /**\n   * The flag indicates that the selected user is a subordinate of the current user\n   */\n  sub: boolean\n\n  /**\n   * The flag indicates that the selected user is the manager of the current user\n   */\n  sup: boolean\n}\n\nexport type SelectedAccess = {\n  /**\n   * access permission identifier. Examples of identifiers:\n   * - U1 — user with identifier 1\n   * - IU1 — employees with identifier 1\n   * - DR2 — all department and subdepartment employees with identifier 2\n   * - D6 — all department employees with identifier 6\n   * - G2 — group with identifier 2 (all visitors)\n   * - SG4 — social network group with identifier 4\n   * - AU — all authorized users\n   * - CR — current user\n   */\n  id:\n    | `AU`\n    | `CR`\n    | `U${number}`\n    | `IU${number}`\n    | `DR${number}`\n    | `D${number}`\n    | `G${number}`\n    | `SG${number}`\n\n  /**\n   * name of the access permission\n   */\n  name: string\n}\n\nexport type SelectCRMParamsEntityType\n  = | 'lead'\n    | 'contact'\n    | 'company'\n    | 'deal'\n    | 'quote'\n\nexport type SelectCRMParamsValue = {\n  lead?: number[]\n  contact?: number[]\n  company?: number[]\n  deal?: number[]\n  quote?: number[]\n}\n\nexport type SelectCRMParams = {\n  /**\n   * Which types of objects to display in the dialog. Possible values:\n   * - lead — Leads\n   * - contact — Contacts\n   * - company — Companies\n   * - deal — Deals\n   * - quote — Estimates\n   */\n  entityType: SelectCRMParamsEntityType[]\n\n  /**\n   * Whether multiple objects can be selected. Default is `false`\n   */\n  multiple: boolean\n\n  /**\n   * Which objects to initially add to the selected in the dialog. Works only if `multiple = true`\n   */\n  value?: SelectCRMParamsValue\n}\n\nexport type SelectedCRMEntity = {\n  id: string\n  type: SelectCRMParamsEntityType\n  place: string\n  title: string\n  desc: string\n  url: string\n}\n\nexport type SelectedCRM = {\n  lead?: (SelectedCRMEntity & { id: `L_${number}` })[]\n  contact?: (SelectedCRMEntity & { id: `C_${number}`, image: string })[]\n  company?: (SelectedCRMEntity & { id: `CO_${number}`, image: string })[]\n  deal?: (SelectedCRMEntity & { id: `D_${number}` })[]\n  quote?: (SelectedCRMEntity & { id: `Q_${number}` })[]\n}\n\n/**\n * Select dialog manager\n *\n * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/index.html\n */\nexport class DialogManager {\n  #messageManager: MessageManager\n\n  constructor(messageManager: MessageManager) {\n    this.#messageManager = messageManager\n  }\n\n  /**\n   * Method displays the standard single user selection dialog\n   * It only shows company employees\n   *\n   * @return {Promise<null|SelectedUser>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-user.html\n   */\n  async selectUser(): Promise<null | SelectedUser> {\n    return this.#messageManager.send(MessageCommands.selectUser, {\n      mult: false\n    })\n  }\n\n  /**\n   * Method displays the standard multiple user selection dialog\n   * It only shows company employees\n   *\n   * @return {Promise<SelectedUser[]>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-users.html\n   */\n  async selectUsers(): Promise<SelectedUser[]> {\n    return this.#messageManager.send(MessageCommands.selectUser, {\n      mult: true\n    })\n  }\n\n  /**\n   * Method displays a standard access permission selection dialog\n   *\n   * @param {string[]} blockedAccessPermissions\n   * @return {Promise<SelectedAccess[]>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-access.html\n   */\n  async selectAccess(\n    blockedAccessPermissions: string[] = []\n  ): Promise<SelectedAccess[]> {\n    return this.#messageManager.send(MessageCommands.selectAccess, {\n      value: blockedAccessPermissions\n    })\n  }\n\n  /**\n   * Method invokes the system dialog for selecting a CRM entity\n   *\n   * @param {SelectCRMParams} params\n   * @return {Promise<SelectedCRM>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/system-dialogues/bx24-select-crm.html\n   */\n  async selectCRM(params?: SelectCRMParams): Promise<SelectedCRM> {\n    return this.#messageManager.send(MessageCommands.selectCRM, {\n      entityType: params?.entityType,\n      multiple: params?.multiple,\n      value: params?.value\n    })\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;AAuHO,MAAM,aAAA,CAAc;AAAA,EAvH3B;AAuH2B,IAAA,MAAA,CAAA,IAAA,EAAA,eAAA,CAAA;AAAA;AAAA,EACzB,eAAA;AAAA,EAEA,YAAY,cAAA,EAAgC;AAC1C,IAAA,IAAA,CAAK,eAAA,GAAkB,cAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,UAAA,GAA2C;AAC/C,IAAA,OAAO,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,eAAA,CAAgB,UAAA,EAAY;AAAA,MAC3D,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,WAAA,GAAuC;AAC3C,IAAA,OAAO,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,eAAA,CAAgB,UAAA,EAAY;AAAA,MAC3D,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,YAAA,CACJ,wBAAA,GAAqC,EAAC,EACX;AAC3B,IAAA,OAAO,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,eAAA,CAAgB,YAAA,EAAc;AAAA,MAC7D,KAAA,EAAO;AAAA,KACR,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,UAAU,MAAA,EAAgD;AAC9D,IAAA,OAAO,IAAA,CAAK,eAAA,CAAgB,IAAA,CAAK,eAAA,CAAgB,SAAA,EAAW;AAAA,MAC1D,YAAY,MAAA,EAAQ,UAAA;AAAA,MACpB,UAAU,MAAA,EAAQ,QAAA;AAAA,MAClB,OAAO,MAAA,EAAQ;AAAA,KAChB,CAAA;AAAA,EACH;AACF;;;;"}