@bitrix24/b24jssdk 1.2.0 → 2.0.0

package/dist/cjs/frame/message/controller.cjs

@@ -0,0 +1,191 @@
+/**
+ * @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 type = require('../../tools/type.cjs');
+const text = require('../../tools/text.cjs');
+const index = require('../../tools/index.cjs');
+const loggerFactory = require('../../logger/logger-factory.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class MessageManager {
+  static {
+    __name(this, "MessageManager");
+  }
+  #appFrame;
+  #callbackPromises;
+  #callbackSingletone;
+  // origins already warned about (#244) — dedup so a peer spamming postMessage
+  // from a foreign origin can't flood a wired logger sink
+  #rejectedOrigins = /* @__PURE__ */ new Set();
+  _logger;
+  runCallbackHandler;
+  constructor(appFrame) {
+    this._logger = loggerFactory.LoggerFactory.createNullLogger();
+    this.#appFrame = appFrame;
+    this.#callbackPromises = /* @__PURE__ */ new Map();
+    this.#callbackSingletone = /* @__PURE__ */ new Map();
+    this.runCallbackHandler = this._runCallback.bind(this);
+  }
+  setLogger(logger) {
+    this._logger = logger;
+  }
+  getLogger() {
+    return this._logger;
+  }
+  // region Events ////
+  /**
+   * Subscribe to the onMessage event of the parent window
+   */
+  subscribe() {
+    window.addEventListener("message", this.runCallbackHandler);
+  }
+  /**
+   * Unsubscribe from the onMessage event of the parent window
+   */
+  unsubscribe() {
+    window.removeEventListener("message", this.runCallbackHandler);
+  }
+  // endregion ////
+  /**
+   * Send message to parent window
+   * The answer (if) we will get in _runCallback
+   *
+   * @param command
+   * @param params
+   */
+  async send(command, params = null) {
+    return new Promise((resolve, reject) => {
+      let cmd;
+      const promiseHandler = {
+        resolve,
+        reject,
+        timeoutId: null
+      };
+      const keyPromise = this.#setCallbackPromise(promiseHandler);
+      let paramsSend = null;
+      const optionsSend = index.omit(params || {}, ["singleOption", "callBack", "isSafely", "safelyTime", "requestId"]);
+      const { callBack, singleOption, requestId } = params || {};
+      if (callBack) {
+        this.#callbackSingletone.set(keyPromise, callBack);
+      }
+      if (singleOption) {
+        paramsSend = singleOption;
+      } else if (Object.keys(optionsSend).length > 0) {
+        paramsSend = { ...optionsSend };
+      }
+      if (command.toString().includes(":")) {
+        cmd = {
+          method: command.toString(),
+          params: paramsSend || "",
+          callback: keyPromise,
+          appSid: this.#appFrame.getAppSid(),
+          requestId
+        };
+      } else {
+        cmd = command.toString();
+        if (params?.isRawValue !== true && paramsSend) {
+          paramsSend = JSON.stringify(paramsSend);
+        } else if (params?.isRawValue === true && paramsSend && type.Type.isPlainObject(paramsSend) && paramsSend["value"]) {
+          paramsSend = paramsSend["value"];
+        }
+        const listParams = [
+          paramsSend || "",
+          keyPromise,
+          this.#appFrame.getAppSid()
+        ];
+        cmd += ":" + listParams.filter(Boolean).join(":");
+      }
+      this.getLogger().debug(`send to ${this.#appFrame.getTargetOrigin()}`, {
+        command: command.toString(),
+        callbackKey: keyPromise,
+        origin: this.#appFrame.getTargetOrigin()
+      });
+      parent.postMessage(cmd, this.#appFrame.getTargetOrigin());
+      if (params?.isSafely) {
+        const safelyTime = Number.parseInt(String(params?.safelyTime || 900));
+        this.#callbackPromises.get(keyPromise).timeoutId = window.setTimeout(
+          () => {
+            if (this.#callbackPromises.has(keyPromise)) {
+              this.getLogger().warning(`action ${command.toString()} stop by timeout`, {
+                command: command.toString(),
+                safelyTime
+              });
+              this.#callbackPromises.delete(keyPromise);
+              resolve({ isSafely: true });
+            }
+          },
+          safelyTime
+        );
+      }
+    });
+  }
+  /**
+   * Fulfilling a promise based on messages from the parent window
+   *
+   * @param event
+   * @private
+   */
+  _runCallback(event) {
+    if (event.origin !== this.#appFrame.getTargetOrigin()) {
+      if (!this.#rejectedOrigins.has(event.origin)) {
+        this.#rejectedOrigins.add(event.origin);
+        this.getLogger().warning("message rejected: unexpected origin", {
+          origin: event.origin,
+          expected: this.#appFrame.getTargetOrigin()
+        });
+      }
+      return;
+    }
+    if (event.data) {
+      const tmp = event.data.split(":");
+      const cmd = {
+        id: tmp[0],
+        args: tmp.slice(1).join(":")
+      };
+      this.getLogger().debug(`get from ${event.origin}`, {
+        id: cmd.id,
+        origin: event.origin
+      });
+      if (cmd.args) {
+        cmd.args = JSON.parse(cmd.args);
+      }
+      if (this.#callbackPromises.has(cmd.id)) {
+        const promise = this.#callbackPromises.get(cmd.id);
+        if (promise.timeoutId) {
+          clearTimeout(promise.timeoutId);
+        }
+        this.#callbackPromises.delete(cmd.id);
+        promise.resolve(cmd.args);
+      } else if (this.#callbackSingletone.has(cmd.id)) {
+        const callBack = this.#callbackSingletone.get(cmd.id);
+        if (callBack) {
+          callBack.apply(globalThis, [cmd.args]);
+        }
+      }
+    }
+  }
+  /**
+   * Storing a promise for a message from the parent window
+   *
+   * @param promiseHandler
+   * @private
+   *
+   * @memo We don't use Symbol here, because we need to pass it to the parent and then find and restore it.
+   */
+  #setCallbackPromise(promiseHandler) {
+    const key = text.Text.getUniqId();
+    this.#callbackPromises.set(key, promiseHandler);
+    return key;
+  }
+}
+
+exports.MessageManager = MessageManager;
+//# sourceMappingURL=controller.cjs.map

package/dist/cjs/frame/message/controller.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.cjs","sources":["../../../../src/frame/message/controller.ts"],"sourcesContent":["import type { MessageCommands } from './commands'\nimport type { AppFrame } from '../frame'\nimport type { LoggerInterface } from '../../logger'\nimport { LoggerFactory } from '../../logger'\nimport { Type } from '../../tools/type'\nimport { Text } from '../../tools/text'\nimport { omit } from '../../tools'\n\ninterface PromiseHandlers {\n  resolve: (value: any) => void\n  reject: (reason?: any) => void\n  timeoutId: any\n}\n\n/**\n * Parent Window Request Parameters\n * - `isRawValue?: boolean` if true then JSON.stringify will not be executed\n * - `isSafely?: boolean` auto completion mode Promise.resolve()\n * - `safelyTime?: number` after what time (900 ms) should it be automatically resolved Promise\n * - `callBack?: () => void` for placement event\n * - `requestId?: string` Unique request identifier for tracking. Used for query deduplication and debugging.\n */\nexport interface SendParams {\n  isRawValue?: boolean\n  isSafely?: boolean\n  safelyTime?: number\n  callBack?: (...args: any[]) => void\n  requestId?: string\n  // @todo add this\n  // singleOption: any\n  [index: string]: any\n}\n\n/**\n * Parent Window Communication Manager at B24\n */\nexport class MessageManager {\n  #appFrame: AppFrame\n  #callbackPromises: Map<string, PromiseHandlers>\n  #callbackSingletone: Map<string, (...args: any[]) => void>\n  // origins already warned about (#244) — dedup so a peer spamming postMessage\n  // from a foreign origin can't flood a wired logger sink\n  #rejectedOrigins: Set<string> = new Set()\n\n  protected _logger: LoggerInterface\n\n  private readonly runCallbackHandler: OmitThisParameter<(event: MessageEvent) => void>\n\n  constructor(appFrame: AppFrame) {\n    this._logger = LoggerFactory.createNullLogger()\n    this.#appFrame = appFrame\n\n    this.#callbackPromises = new Map()\n    this.#callbackSingletone = new Map()\n\n    this.runCallbackHandler = this._runCallback.bind(this)\n  }\n\n  setLogger(logger: LoggerInterface): void {\n    this._logger = logger\n  }\n\n  getLogger(): LoggerInterface {\n    return this._logger\n  }\n\n  // region Events ////\n  /**\n   * Subscribe to the onMessage event of the parent window\n   */\n  subscribe() {\n    window.addEventListener('message', this.runCallbackHandler)\n  }\n\n  /**\n   * Unsubscribe from the onMessage event of the parent window\n   */\n  unsubscribe(): void {\n    window.removeEventListener('message', this.runCallbackHandler)\n  }\n\n  // endregion ////\n\n  /**\n   * Send message to parent window\n   * The answer (if) we will get in _runCallback\n   *\n   * @param command\n   * @param params\n   */\n  async send(\n    command: string | MessageCommands,\n    params: null | SendParams = null\n  ): Promise<any> {\n    return new Promise((resolve, reject) => {\n      let cmd: string | object\n      const promiseHandler: PromiseHandlers = {\n        resolve,\n        reject,\n        timeoutId: null\n      }\n\n      const keyPromise = this.#setCallbackPromise(promiseHandler)\n      let paramsSend: null | string | Record<string, any> = null\n\n      const optionsSend = omit(params || {}, ['singleOption', 'callBack', 'isSafely', 'safelyTime', 'requestId'])\n      const { callBack, singleOption, requestId } = params || {}\n      if (callBack) {\n        this.#callbackSingletone.set(keyPromise, callBack)\n      }\n\n      if (singleOption) {\n        paramsSend = singleOption\n      } else if (Object.keys(optionsSend).length > 0) {\n        paramsSend = { ...optionsSend }\n      }\n\n      if (command.toString().includes(':')) {\n        cmd = {\n          method: command.toString(),\n          params: paramsSend || '',\n          callback: keyPromise,\n          appSid: this.#appFrame.getAppSid(),\n          requestId\n        }\n      } else {\n        cmd = command.toString()\n\n        if (\n          params?.isRawValue !== true\n          && paramsSend\n        ) {\n          paramsSend = JSON.stringify(paramsSend)\n        } else if (\n          params?.isRawValue === true\n          && paramsSend\n          && Type.isPlainObject(paramsSend)\n          && paramsSend['value']\n        ) {\n          paramsSend = paramsSend['value']\n        }\n\n        const listParams = [\n          paramsSend || '',\n          keyPromise,\n          this.#appFrame.getAppSid()\n        ]\n\n        cmd += ':' + listParams.filter(Boolean).join(':')\n      }\n\n      // Log only the command + callback key, never the assembled `cmd` string:\n      // for setAppOption / setUserOption it carries the serialised option\n      // `value`, which an app may use to store a credential (#43).\n      this.getLogger().debug(`send to ${this.#appFrame.getTargetOrigin()}`, {\n        command: command.toString(),\n        callbackKey: keyPromise,\n        origin: this.#appFrame.getTargetOrigin()\n      })\n\n      parent.postMessage(cmd, this.#appFrame.getTargetOrigin())\n\n      if (params?.isSafely) {\n        const safelyTime = Number.parseInt(String(params?.safelyTime || 900))\n        this.#callbackPromises.get(keyPromise)!.timeoutId = window.setTimeout(\n          () => {\n            if (this.#callbackPromises.has(keyPromise)) {\n              this.getLogger().warning(`action ${command.toString()} stop by timeout`, {\n                command: command.toString(),\n                safelyTime\n              })\n\n              this.#callbackPromises.delete(keyPromise)\n              resolve({ isSafely: true })\n            }\n          },\n          safelyTime\n        )\n      }\n    })\n  }\n\n  /**\n   * Fulfilling a promise based on messages from the parent window\n   *\n   * @param event\n   * @private\n   */\n  public _runCallback(event: MessageEvent): void {\n    if (event.origin !== this.#appFrame.getTargetOrigin()) {\n      // Surface a message from an unexpected origin (a probe, or a misconfigured\n      // parent) — log the origins only, never event.data, which may carry the\n      // AUTH_ID / REFRESH_ID a foreign sender must not have echoed back (#244).\n      // Log once per distinct origin so a spamming peer can't flood the sink.\n      if (!this.#rejectedOrigins.has(event.origin)) {\n        this.#rejectedOrigins.add(event.origin)\n        this.getLogger().warning('message rejected: unexpected origin', {\n          origin: event.origin,\n          expected: this.#appFrame.getTargetOrigin()\n        })\n      }\n\n      return\n    }\n\n    if (event.data) {\n      const tmp = event.data.split(':')\n\n      const cmd: { id: string, args: any } = {\n        id: tmp[0],\n        args: tmp.slice(1).join(':')\n      }\n\n      // Log only the callback id and origin — never `event.data` / `cmd.args`.\n      // The inbound message carries the auth tokens (AUTH_ID / REFRESH_ID) for\n      // refreshAuth / getInitData responses, embedded in the colon-joined\n      // payload as an opaque substring a redactor can't see (#43).\n      this.getLogger().debug(`get from ${event.origin}`, {\n        id: cmd.id,\n        origin: event.origin\n      })\n\n      if (cmd.args) {\n        cmd.args = JSON.parse(cmd.args)\n      }\n\n      if (this.#callbackPromises.has(cmd.id)) {\n        const promise = this.#callbackPromises.get(cmd.id) as PromiseHandlers\n        if (promise.timeoutId) {\n          clearTimeout(promise.timeoutId)\n        }\n\n        this.#callbackPromises.delete(cmd.id)\n\n        promise.resolve(cmd.args)\n        // promise.reject(cmd.args) ////\n      } else if (this.#callbackSingletone.has(cmd.id)) {\n        const callBack = this.#callbackSingletone.get(cmd.id) as (...args: any[]) => void\n        if (callBack) {\n          callBack.apply(globalThis, [cmd.args])\n        }\n      }\n    }\n  }\n\n  /**\n   * Storing a promise for a message from the parent window\n   *\n   * @param promiseHandler\n   * @private\n   *\n   * @memo We don't use Symbol here, because we need to pass it to the parent and then find and restore it.\n   */\n  #setCallbackPromise(promiseHandler: PromiseHandlers): string {\n    const key = Text.getUniqId()\n    this.#callbackPromises.set(key, promiseHandler)\n    return key\n  }\n}\n"],"names":["LoggerFactory","omit","Type","Text"],"mappings":"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"}

package/dist/cjs/frame/options.cjs

@@ -0,0 +1,108 @@
+/**
+ * @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 OptionsManager {
+  static {
+    __name(this, "OptionsManager");
+  }
+  #messageManager;
+  #appOptions = null;
+  #userOptions = null;
+  constructor(messageManager) {
+    this.#messageManager = messageManager;
+  }
+  /**
+   * Initializes the data received from the parent window message.
+   * @param data
+   */
+  initData(data) {
+    if (data.APP_OPTIONS) {
+      this.#appOptions = data.APP_OPTIONS;
+    }
+    if (data.USER_OPTIONS) {
+      this.#userOptions = data.USER_OPTIONS;
+    }
+    return this;
+  }
+  /**
+   * Getting application option
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/options/bx24-app-option-get.html
+   */
+  appGet(option) {
+    if (this.#appOptions && !!this.#appOptions[option]) {
+      return this.#appOptions[option];
+    }
+    throw new Error(`app.option.${option} not set`);
+  }
+  /**
+   * Updates application data through the parent window
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/options/bx24-app-option-set.html
+   */
+  async appSet(option, value) {
+    if (!this.#appOptions) {
+      this.#appOptions = [];
+    }
+    this.#appOptions[option] = value;
+    return this.#sendParentMessage(
+      commands.MessageCommands.setAppOption,
+      option,
+      this.#appOptions[option]
+    );
+  }
+  /**
+   * Getting user option
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/options/bx24-user-option-get.html
+   */
+  userGet(option) {
+    if (this.#userOptions && !!this.#userOptions[option]) {
+      return this.#userOptions[option];
+    }
+    throw new Error(`user.option.${option} not set`);
+  }
+  /**
+   * Updates user data through the parent window
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/options/bx24-user-option-set.html
+   */
+  async userSet(option, value) {
+    if (!this.#appOptions) {
+      this.#appOptions = [];
+    }
+    if (!this.#appOptions[option]) {
+      this.#appOptions[option] = null;
+    }
+    this.#userOptions[option] = value;
+    return this.#sendParentMessage(
+      commands.MessageCommands.setUserOption,
+      option,
+      // @ts-expect-error this code work success
+      this.#userOptions[option]
+    );
+  }
+  async #sendParentMessage(command, option, value) {
+    return this.#messageManager.send(command, {
+      name: option,
+      value,
+      isSafely: true
+    }).then(() => {
+      return Promise.resolve();
+    });
+  }
+}
+
+exports.OptionsManager = OptionsManager;
+//# sourceMappingURL=options.cjs.map

package/dist/cjs/frame/options.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.cjs","sources":["../../../src/frame/options.ts"],"sourcesContent":["import type { MessageManager } from './message'\nimport { MessageCommands } from './message'\nimport type { MessageInitData } from '../types/auth'\n\n/**\n * Manager for working with application settings via communication with the parent window\n *\n * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/options/index.html\n */\nexport class OptionsManager {\n  #messageManager: MessageManager\n  #appOptions: null | Record<string, any> = null\n  #userOptions: null | Record<string, any> = null\n\n  constructor(messageManager: MessageManager) {\n    this.#messageManager = messageManager\n  }\n\n  /**\n   * Initializes the data received from the parent window message.\n   * @param data\n   */\n  initData(data: MessageInitData): OptionsManager {\n    if (data.APP_OPTIONS) {\n      this.#appOptions = data.APP_OPTIONS as Record<string, any>\n    }\n\n    if (data.USER_OPTIONS) {\n      this.#userOptions = data.USER_OPTIONS as Record<string, any>\n    }\n\n    return this\n  }\n\n  /**\n   * Getting application option\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/options/bx24-app-option-get.html\n   */\n  appGet(option: string): any {\n    if (this.#appOptions && !!this.#appOptions[option]) {\n      return this.#appOptions[option]\n    }\n\n    throw new Error(`app.option.${option} not set`)\n  }\n\n  /**\n   * Updates application data through the parent window\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/options/bx24-app-option-set.html\n   */\n  async appSet(option: string, value: any): Promise<void> {\n    if (!this.#appOptions) {\n      this.#appOptions = []\n    }\n\n    this.#appOptions[option] = value\n\n    return this.#sendParentMessage(\n      MessageCommands.setAppOption,\n      option,\n      this.#appOptions[option]\n    )\n  }\n\n  /**\n   * Getting user option\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/options/bx24-user-option-get.html\n   */\n  userGet(option: string): any {\n    if (this.#userOptions && !!this.#userOptions[option]) {\n      return this.#userOptions[option]\n    }\n\n    throw new Error(`user.option.${option} not set`)\n  }\n\n  /**\n   * Updates user data through the parent window\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/options/bx24-user-option-set.html\n   */\n  async userSet(option: string, value: any): Promise<void> {\n    if (!this.#appOptions) {\n      this.#appOptions = []\n    }\n\n    if (!this.#appOptions[option]) {\n      this.#appOptions[option] = null\n    }\n\n    // @ts-expect-error this code work success\n    this.#userOptions[option] = value\n\n    return this.#sendParentMessage(\n      MessageCommands.setUserOption,\n      option,\n      // @ts-expect-error this code work success\n      this.#userOptions[option]\n    )\n  }\n\n  async #sendParentMessage(\n    command: string,\n    option: string,\n    value: any\n  ): Promise<void> {\n    return this.#messageManager\n      .send(command, {\n        name: option,\n        value: value,\n        isSafely: true\n      })\n      .then(() => {\n        return Promise.resolve()\n      })\n  }\n}\n"],"names":["MessageCommands"],"mappings":"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"}

package/dist/cjs/frame/parent.cjs

@@ -0,0 +1,259 @@
+/**
+ * @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 scrollSize = require('../tools/scroll-size.cjs');
+const commands = require('./message/commands.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class ParentManager {
+  static {
+    __name(this, "ParentManager");
+  }
+  #messageManager;
+  constructor(messageManager) {
+    this.#messageManager = messageManager;
+  }
+  get message() {
+    return this.#messageManager;
+  }
+  /**
+   * The method closes the open modal window with the application
+   *
+   * @return {Promise<void>}
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-close-application.html
+   */
+  async closeApplication() {
+    return this.#messageManager.send(commands.MessageCommands.closeApplication, {
+      /**
+       * @memo There is no point - everything will be closed, and timeout will not be able to do anything
+       */
+      isSafely: false
+    });
+  }
+  /**
+   * Sets the size of the frame containing the application to the size of the frame's content.
+   *
+   * @return {Promise<void>}
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-fit-window.html
+   *
+   * @memo in certain situations it may not be executed (placement of the main window after installing the application), in this case isSafely mode will work
+   */
+  async fitWindow() {
+    const width = "100%";
+    const height = this.getScrollSize().scrollHeight;
+    return this.#messageManager.send(commands.MessageCommands.resizeWindow, {
+      width,
+      height,
+      isSafely: true
+    });
+  }
+  /**
+   * Sets the size of the frame containing the application to the size of the frame's content.
+   *
+   * @param {number} width
+   * @param {number} height
+   *
+   * @return {Promise<void>}
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-resize-window.html
+   *
+   * @memo in certain situations it may not be executed, in this case isSafely mode will be triggered
+   */
+  async resizeWindow(width, height) {
+    if (width > 0 && height > 0) {
+      return this.#messageManager.send(commands.MessageCommands.resizeWindow, {
+        width,
+        height,
+        isSafely: true
+      });
+    }
+    return Promise.reject(
+      new Error(`Wrong width:number = ${width} or height:number = ${height}`)
+    );
+  }
+  /**
+   * Automatically resize `document.body` of frame with application according to frame content dimensions
+   * If you pass appNode, the height will be calculated relative to it
+   *
+   * @param {HTMLElement|null} appNode
+   * @param {number} minHeight
+   * @param {number} minWidth
+   *
+   * @return {Promise<void>}
+   */
+  async resizeWindowAuto(appNode = null, minHeight = 0, minWidth = 0) {
+    const body = document.body;
+    let width = Math.max(
+      body.scrollWidth,
+      body.offsetWidth
+      // html.clientWidth,
+      // html.scrollWidth,
+      // html.offsetWidth
+    );
+    if (minWidth > 0) {
+      width = Math.max(minWidth, width);
+    }
+    let height = Math.max(
+      body.scrollHeight,
+      body.offsetHeight
+      // html.clientHeight,
+      // html.scrollHeight,
+      // html.offsetHeight
+    );
+    if (appNode) {
+      height = Math.max(appNode.scrollHeight, appNode.offsetHeight);
+    }
+    if (minHeight > 0) {
+      height = Math.max(minHeight, height);
+    }
+    return this.resizeWindow(width, height);
+  }
+  /**
+   * This function returns the inner dimensions of the application frame
+   *
+   * @return {Promise<{scrollWidth: number; scrollHeight: number}>}
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-get-scroll-size.html
+   */
+  getScrollSize() {
+    return scrollSize.default();
+  }
+  /**
+   * Scrolls the parent window
+   *
+   * @param {number} scroll should specify the vertical scrollbar position (0 - scroll to the very top)
+   * @return {Promise<void>}
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-scroll-parent-window.html
+   */
+  async scrollParentWindow(scroll) {
+    if (!Number.isInteger(scroll)) {
+      return Promise.reject(new Error("Wrong scroll number"));
+    }
+    if (scroll < 0) {
+      scroll = 0;
+    }
+    return this.#messageManager.send(commands.MessageCommands.setScroll, {
+      scroll,
+      isSafely: true
+    });
+  }
+  /**
+   * Reload the page with the application (the whole page, not just the frame).
+   *
+   * @return {Promise<void>}
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-reload-window.html
+   */
+  async reloadWindow() {
+    return this.#messageManager.send(commands.MessageCommands.reloadWindow, {
+      isSafely: true
+    });
+  }
+  /**
+   * Sets the in-layout page title (the `#pagetitle` element the portal renders around the app).
+   *
+   * Does NOT change the browser tab title (`document.title`): the portal applies this command to
+   * `#pagetitle`, never to the tab. To set the browser tab title, open the view as a slider via
+   * `SliderManager.openSliderAppPage` with a `bx24_title` option.
+   *
+   * @param {string} title
+   *
+   * @return {Promise<void>}
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-set-title.html
+   */
+  async setTitle(title) {
+    return this.#messageManager.send(commands.MessageCommands.setTitle, {
+      title: title.toString(),
+      isSafely: true
+    });
+  }
+  /**
+   * Initiates a call via internal communication
+   *
+   * @param {number} userId The identifier of the account user
+   * @param {boolean} isVideo true - video call, false - audio call. Optional parameter.
+   *
+   * @return {Promise<void>}
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-call-to.html
+   */
+  async imCallTo(userId, isVideo = true) {
+    return this.#messageManager.send(commands.MessageCommands.imCallTo, {
+      userId,
+      video: isVideo,
+      isSafely: true
+    });
+  }
+  /**
+   * Makes a call to the phone number
+   *
+   * @param {string} phone Phone number. The number can be in the format: `+44 20 1234 5678` or `x (xxx) xxx-xx-xx`
+   *
+   * @return {Promise<void>}
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-phone-to.html
+   */
+  async imPhoneTo(phone) {
+    return this.#messageManager.send(commands.MessageCommands.imPhoneTo, {
+      phone,
+      isSafely: true
+    });
+  }
+  /**
+   * Opens the messenger window
+   * userId or chatXXX - chat, where XXX is the chat identifier, which can simply be a number.
+   * sgXXX - group chat, where XXX is the social network group number (the chat must be enabled in this group).
+   *
+   * XXXX** - open line, where XXX is the code obtained via the Rest method imopenlines.network.join.
+   *
+   * If nothing is passed, the chat interface will open with the last opened dialog.
+   *
+   * @param {number|`chat${number}`|`sg${number}`|`imol|${number}`|undefined} dialogId
+   *
+   * @return {Promise<void>}
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-open-messenger.html
+   * @link https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=93&LESSON_ID=20152&LESSON_PATH=7657.7883.8025.20150.20152
+   *
+   */
+  async imOpenMessenger(dialogId) {
+    return this.#messageManager.send(commands.MessageCommands.imOpenMessenger, {
+      dialogId,
+      isSafely: true
+    });
+  }
+  /**
+   * Opens the history window
+   * Identifier of the dialog:
+   *
+   * userId or chatXXX - chat, where XXX is the chat identifier, which can simply be a number.
+   * imol|XXXX - open line, where XXX is the session number of the open line.
+   *
+   * @param {number|`chat${number}`|`imol|${number}`} dialogId
+   *
+   * @return {Promise<void>}
+   *
+   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-open-history.html
+   */
+  async imOpenHistory(dialogId) {
+    return this.#messageManager.send(commands.MessageCommands.imOpenHistory, {
+      dialogId,
+      isSafely: true
+    });
+  }
+}
+
+exports.ParentManager = ParentManager;
+//# sourceMappingURL=parent.cjs.map

package/dist/cjs/frame/parent.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent.cjs","sources":["../../../src/frame/parent.ts"],"sourcesContent":["import type { MessageManager } from './message'\nimport { MessageCommands } from './message'\nimport useScrollSize from '../tools/scroll-size'\n\n/**\n * Parent window manager\n *\n * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/\n */\nexport class ParentManager {\n  #messageManager: MessageManager\n\n  constructor(messageManager: MessageManager) {\n    this.#messageManager = messageManager\n  }\n\n  get message(): MessageManager {\n    return this.#messageManager\n  }\n\n  /**\n   * The method closes the open modal window with the application\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-close-application.html\n   */\n  async closeApplication(): Promise<void> {\n    return this.#messageManager.send(MessageCommands.closeApplication, {\n      /**\n       * @memo There is no point - everything will be closed, and timeout will not be able to do anything\n       */\n      isSafely: false\n    })\n  }\n\n  /**\n   * Sets the size of the frame containing the application to the size of the frame's content.\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-fit-window.html\n   *\n   * @memo in certain situations it may not be executed (placement of the main window after installing the application), in this case isSafely mode will work\n   */\n  async fitWindow(): Promise<any> {\n    const width = '100%'\n    const height = this.getScrollSize().scrollHeight\n\n    return this.#messageManager.send(MessageCommands.resizeWindow, {\n      width,\n      height,\n      isSafely: true\n    })\n  }\n\n  /**\n   * Sets the size of the frame containing the application to the size of the frame's content.\n   *\n   * @param {number} width\n   * @param {number} height\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-resize-window.html\n   *\n   * @memo in certain situations it may not be executed, in this case isSafely mode will be triggered\n   */\n  async resizeWindow(width: number, height: number): Promise<void> {\n    if (width > 0 && height > 0) {\n      return this.#messageManager.send(MessageCommands.resizeWindow, {\n        width,\n        height,\n        isSafely: true\n      })\n    }\n\n    return Promise.reject(\n      new Error(`Wrong width:number = ${width} or height:number = ${height}`)\n    )\n  }\n\n  /**\n   * Automatically resize `document.body` of frame with application according to frame content dimensions\n   * If you pass appNode, the height will be calculated relative to it\n   *\n   * @param {HTMLElement|null} appNode\n   * @param {number} minHeight\n   * @param {number} minWidth\n   *\n   * @return {Promise<void>}\n   */\n  async resizeWindowAuto(\n    appNode: null | HTMLElement = null,\n    minHeight: number = 0,\n    minWidth: number = 0\n  ): Promise<void> {\n    const body = document.body\n    // const html = document.documentElement\n\n    let width = Math.max(\n      body.scrollWidth,\n      body.offsetWidth\n\n      // html.clientWidth,\n      // html.scrollWidth,\n      // html.offsetWidth\n    )\n\n    if (minWidth > 0) {\n      width = Math.max(minWidth, width)\n    }\n\n    let height = Math.max(\n      body.scrollHeight,\n      body.offsetHeight\n\n      // html.clientHeight,\n      // html.scrollHeight,\n      // html.offsetHeight\n    )\n\n    if (appNode) {\n      height = Math.max(appNode.scrollHeight, appNode.offsetHeight)\n    }\n\n    if (minHeight > 0) {\n      height = Math.max(minHeight, height)\n    }\n\n    return this.resizeWindow(width, height)\n  }\n\n  /**\n   * This function returns the inner dimensions of the application frame\n   *\n   * @return {Promise<{scrollWidth: number; scrollHeight: number}>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-get-scroll-size.html\n   */\n  getScrollSize(): {\n    scrollWidth: number\n    scrollHeight: number\n  } {\n    return useScrollSize()\n  }\n\n  /**\n   * Scrolls the parent window\n   *\n   * @param {number} scroll should specify the vertical scrollbar position (0 - scroll to the very top)\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-scroll-parent-window.html\n   */\n  async scrollParentWindow(scroll: number): Promise<void> {\n    if (!Number.isInteger(scroll)) {\n      return Promise.reject(new Error('Wrong scroll number'))\n    }\n\n    if (scroll < 0) {\n      scroll = 0\n    }\n\n    return this.#messageManager.send(MessageCommands.setScroll, {\n      scroll,\n      isSafely: true\n    })\n  }\n\n  /**\n   * Reload the page with the application (the whole page, not just the frame).\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-reload-window.html\n   */\n  async reloadWindow(): Promise<void> {\n    return this.#messageManager.send(MessageCommands.reloadWindow, {\n      isSafely: true\n    })\n  }\n\n  /**\n   * Sets the in-layout page title (the `#pagetitle` element the portal renders around the app).\n   *\n   * Does NOT change the browser tab title (`document.title`): the portal applies this command to\n   * `#pagetitle`, never to the tab. To set the browser tab title, open the view as a slider via\n   * `SliderManager.openSliderAppPage` with a `bx24_title` option.\n   *\n   * @param {string} title\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-set-title.html\n   */\n  async setTitle(title: string): Promise<void> {\n    return this.#messageManager.send(MessageCommands.setTitle, {\n      title: title.toString(),\n      isSafely: true\n    })\n  }\n\n  /**\n   * Initiates a call via internal communication\n   *\n   * @param {number} userId The identifier of the account user\n   * @param {boolean} isVideo true - video call, false - audio call. Optional parameter.\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-call-to.html\n   */\n  async imCallTo(userId: number, isVideo: boolean = true): Promise<void> {\n    return this.#messageManager.send(MessageCommands.imCallTo, {\n      userId,\n      video: isVideo,\n      isSafely: true\n    })\n  }\n\n  /**\n   * Makes a call to the phone number\n   *\n   * @param {string} phone Phone number. The number can be in the format: `+44 20 1234 5678` or `x (xxx) xxx-xx-xx`\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-phone-to.html\n   */\n  async imPhoneTo(phone: string): Promise<void> {\n    return this.#messageManager.send(MessageCommands.imPhoneTo, {\n      phone,\n      isSafely: true\n    })\n  }\n\n  /**\n   * Opens the messenger window\n   * userId or chatXXX - chat, where XXX is the chat identifier, which can simply be a number.\n   * sgXXX - group chat, where XXX is the social network group number (the chat must be enabled in this group).\n   *\n   * XXXX** - open line, where XXX is the code obtained via the Rest method imopenlines.network.join.\n   *\n   * If nothing is passed, the chat interface will open with the last opened dialog.\n   *\n   * @param {number|`chat${number}`|`sg${number}`|`imol|${number}`|undefined} dialogId\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-open-messenger.html\n   * @link https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=93&LESSON_ID=20152&LESSON_PATH=7657.7883.8025.20150.20152\n   *\n   */\n  async imOpenMessenger(\n    dialogId:\n      | number\n      | `chat${number}`\n      | `sg${number}`\n      | `imol|${number}`\n      | undefined\n  ): Promise<void> {\n    return this.#messageManager.send(MessageCommands.imOpenMessenger, {\n      dialogId: dialogId,\n      isSafely: true\n    })\n  }\n\n  /**\n   * Opens the history window\n   * Identifier of the dialog:\n   *\n   * userId or chatXXX - chat, where XXX is the chat identifier, which can simply be a number.\n   * imol|XXXX - open line, where XXX is the session number of the open line.\n   *\n   * @param {number|`chat${number}`|`imol|${number}`} dialogId\n   *\n   * @return {Promise<void>}\n   *\n   * @link https://apidocs.bitrix24.com/sdk/bx24-js-sdk/additional-functions/bx24-im-open-history.html\n   */\n  async imOpenHistory(\n    dialogId: number | `chat${number}` | `imol|${number}`\n  ): Promise<void> {\n    return this.#messageManager.send(MessageCommands.imOpenHistory, {\n      dialogId: dialogId,\n      isSafely: true\n    })\n  }\n}\n"],"names":["MessageCommands","useScrollSize"],"mappings":"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"}