@bitrix24/b24jssdk 0.2.2 → 0.3.0

package/dist/commonjs/index.d.cts

@@ -2505,6 +2505,15 @@ declare class PlacementManager {
      * @link https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/bx24-placement-call.html
      */
     call(command: string, parameters?: Record<string, any>): Promise<any>;
+    /**
+     * Set Up the Interface Event Handler
+     * @param {string} command
+     * @param {null | string | Record<string, any>} parameters
+     * @param {(...args: any[]) => void} callBack
+     *
+     * @return {Promise<any>}
+     */
+    callCustomBind(command: string, parameters: (null | string | Record<string, any>) | undefined, callBack: (...args: any[]) => void): Promise<any>;
 }
 
 /**

package/dist/commonjs/index.d.mts

@@ -2505,6 +2505,15 @@ declare class PlacementManager {
      * @link https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/bx24-placement-call.html
      */
     call(command: string, parameters?: Record<string, any>): Promise<any>;
+    /**
+     * Set Up the Interface Event Handler
+     * @param {string} command
+     * @param {null | string | Record<string, any>} parameters
+     * @param {(...args: any[]) => void} callBack
+     *
+     * @return {Promise<any>}
+     */
+    callCustomBind(command: string, parameters: (null | string | Record<string, any>) | undefined, callBack: (...args: any[]) => void): Promise<any>;
 }
 
 /**

package/dist/commonjs/index.d.ts

@@ -2505,6 +2505,15 @@ declare class PlacementManager {
      * @link https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/bx24-placement-call.html
      */
     call(command: string, parameters?: Record<string, any>): Promise<any>;
+    /**
+     * Set Up the Interface Event Handler
+     * @param {string} command
+     * @param {null | string | Record<string, any>} parameters
+     * @param {(...args: any[]) => void} callBack
+     *
+     * @return {Promise<any>}
+     */
+    callCustomBind(command: string, parameters: (null | string | Record<string, any>) | undefined, callBack: (...args: any[]) => void): Promise<any>;
 }
 
 /**

package/dist/esm/index.d.mts

@@ -2505,6 +2505,15 @@ declare class PlacementManager {
      * @link https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/bx24-placement-call.html
      */
     call(command: string, parameters?: Record<string, any>): Promise<any>;
+    /**
+     * Set Up the Interface Event Handler
+     * @param {string} command
+     * @param {null | string | Record<string, any>} parameters
+     * @param {(...args: any[]) => void} callBack
+     *
+     * @return {Promise<any>}
+     */
+    callCustomBind(command: string, parameters: (null | string | Record<string, any>) | undefined, callBack: (...args: any[]) => void): Promise<any>;
 }
 
 /**

package/dist/esm/index.d.ts

@@ -2505,6 +2505,15 @@ declare class PlacementManager {
      * @link https://apidocs.bitrix24.com/api-reference/widgets/ui-interaction/bx24-placement-call.html
      */
     call(command: string, parameters?: Record<string, any>): Promise<any>;
+    /**
+     * Set Up the Interface Event Handler
+     * @param {string} command
+     * @param {null | string | Record<string, any>} parameters
+     * @param {(...args: any[]) => void} callBack
+     *
+     * @return {Promise<any>}
+     */
+    callCustomBind(command: string, parameters: (null | string | Record<string, any>) | undefined, callBack: (...args: any[]) => void): Promise<any>;
 }
 
 /**

package/dist/esm/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @version @bitrix24/b24jssdk v0.2.2
+ * @version @bitrix24/b24jssdk v0.3.0
  * @copyright (c) 2025 Bitrix24
  * @licence MIT
  * @links https://github.com/bitrix24/b24jssdk - GitHub
@@ -1498,13 +1498,17 @@ class RestrictionManager {
 
 const DEFAULT_REQUEST_ID_HEADER_FIELD_NAME = "X-Request-ID";
 const DEFAULT_QUERY_STRING_PARAMETER_NAME = "bx24_request_id";
-const DEFAULT_QUERY_STRING_SDK_PARAMETER_NAME = "bx24_sdk_ver";
+const DEFAULT_QUERY_STRING_SDK_VER_PARAMETER_NAME = "bx24_sdk_ver";
+const DEFAULT_QUERY_STRING_SDK_TYPE_PARAMETER_NAME = "bx24_sdk_type";
 class DefaultRequestIdGenerator {
   getQueryStringParameterName() {
     return DEFAULT_QUERY_STRING_PARAMETER_NAME;
   }
   getQueryStringSdkParameterName() {
-    return DEFAULT_QUERY_STRING_SDK_PARAMETER_NAME;
+    return DEFAULT_QUERY_STRING_SDK_VER_PARAMETER_NAME;
+  }
+  getQueryStringSdkTypeParameterName() {
+    return DEFAULT_QUERY_STRING_SDK_TYPE_PARAMETER_NAME;
   }
   generate() {
     return Text.getUuidRfc4122();
@@ -1529,7 +1533,7 @@ class Http {
   #clientSideWarningMessage = "";
   constructor(baseURL, authActions, options) {
     const defaultHeaders = {
-      // 'X-Sdk': 'b24-js-sdk-v-0.2.2'
+      // 'X-Sdk': 'b24-js-sdk-v-0.3.0'
     };
     this.#clientAxios = axios.create({
       baseURL,
@@ -1938,8 +1942,6 @@ class Http {
     if (this.#logTag.length > 0) {
       result.logTag = this.#logTag;
     }
-    result[this.#requestIdGenerator.getQueryStringParameterName()] = this.#requestIdGenerator.getRequestId();
-    result[this.#requestIdGenerator.getQueryStringSdkParameterName()] = "0.2.2";
     if (!!result.data && !!result.data.start) {
       delete result.data.start;
     }
@@ -1956,7 +1958,13 @@ class Http {
    * @private
    */
   #prepareMethod(method) {
-    return `${encodeURIComponent(method)}.json`;
+    const baseUrl = `${encodeURIComponent(method)}.json`;
+    const queryParams = new URLSearchParams({
+      [this.#requestIdGenerator.getQueryStringParameterName()]: this.#requestIdGenerator.getRequestId(),
+      [this.#requestIdGenerator.getQueryStringSdkParameterName()]: "0.3.0",
+      [this.#requestIdGenerator.getQueryStringSdkTypeParameterName()]: "b24-js-sdk"
+    });
+    return `${baseUrl}?${queryParams.toString()}`;
   }
   /**
    * @inheritDoc
@@ -3157,22 +3165,28 @@ class MessageManager {
         timeoutId: null
       };
       const keyPromise = this.#setCallbackPromise(promiseHandler);
-      const paramsSend = omit(params || {}, ["callBack", "isSafely", "safelyTime"]);
-      const { callBack } = params || {};
+      let paramsSend = null;
+      const optionsSend = omit(params || {}, ["singleOption", "callBack", "isSafely", "safelyTime"]);
+      const { callBack, singleOption } = 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 ?? "",
+          params: paramsSend || "",
           callback: keyPromise,
           appSid: this.#appFrame.getAppSid()
         };
       } else {
         cmd = command.toString();
         const listParams = [
-          params ? JSON.stringify(paramsSend) : null,
+          paramsSend ? JSON.stringify(paramsSend) : "",
           keyPromise,
           this.#appFrame.getAppSid()
         ];
@@ -3990,6 +4004,30 @@ class PlacementManager {
       }
     );
   }
+  /**
+   * Set Up the Interface Event Handler
+   * @param {string} command
+   * @param {null | string | Record<string, any>} parameters
+   * @param {(...args: any[]) => void} callBack
+   *
+   * @return {Promise<any>}
+   */
+  async callCustomBind(command, parameters = null, callBack) {
+    let options = {};
+    if (Type.isString(parameters)) {
+      options["singleOption"] = parameters;
+    } else if (Type.isObjectLike(parameters)) {
+      options = { ...parameters };
+    }
+    return this.#messageManager.send(
+      command,
+      {
+        ...options,
+        callBack,
+        isSafely: true
+      }
+    );
+  }
 }
 
 class B24Frame extends AbstractB24 {