@bitrix24/b24jssdk 0.1.4 → 0.1.5

package/dist/commonjs/index.cjs

@@ -1,5 +1,5 @@
 /**
- * @version @bitrix24/b24jssdk v0.1.4
+ * @version @bitrix24/b24jssdk v0.1.5
  * @copyright (c) 2024 Bitrix24
  * @licence MIT
  * @links https://github.com/bitrix24/b24jssdk - GitHub
@@ -1339,7 +1339,10 @@ class Http {
   #restrictionManager;
   #requestIdGenerator;
   _logger = null;
+  _loggerSystem = null;
   #logTag = "";
+  #isClientSideWarning = false;
+  #clientSideWarningMessage = "";
   constructor(baseURL, authActions, options) {
     this.#clientAxios = axios.create({
       baseURL,
@@ -1349,6 +1352,7 @@ class Http {
     this.#restrictionManager = new RestrictionManager();
     this.#requestIdGenerator = new DefaultRequestIdGenerator();
   }
+  // region Logger ////
   setLogger(logger) {
     this._logger = logger;
     this.#restrictionManager.setLogger(this.getLogger());
@@ -1367,18 +1371,38 @@ class Http {
     }
     return this._logger;
   }
+  getSystemLogger() {
+    if (null === this._loggerSystem) {
+      this._loggerSystem = LoggerBrowser.build(`SystemLogger`);
+      this._loggerSystem.setConfig({
+        [LoggerType.desktop]: false,
+        [LoggerType.log]: false,
+        [LoggerType.info]: true,
+        [LoggerType.warn]: true,
+        [LoggerType.error]: true,
+        [LoggerType.trace]: false
+      });
+    }
+    return this._loggerSystem;
+  }
+  // endregion ////
+  // region RestrictionManager ////
   setRestrictionManagerParams(params) {
     this.#restrictionManager.params = params;
   }
   getRestrictionManagerParams() {
     return this.#restrictionManager.params;
   }
+  // endregion ////
+  // region LogTag ////
   setLogTag(logTag) {
     this.#logTag = logTag;
   }
   clearLogTag() {
     this.#logTag = "";
   }
+  // endregion ////
+  // region Actions Call ////
   async batch(calls, isHaltOnError = true) {
     const isArrayMode = Array.isArray(calls);
     const cmd = isArrayMode ? [] : {};
@@ -1520,6 +1544,9 @@ class Http {
       authData = await this.#authActions.refreshAuth();
     }
     await this.#restrictionManager.check();
+    if (this.#isClientSideWarning && !this.isServerSide() && Type.isStringFilled(this.#clientSideWarningMessage)) {
+      this.getSystemLogger().warn(this.#clientSideWarningMessage);
+    }
     return this.#clientAxios.post(
       this.#prepareMethod(method),
       this.#prepareParams(authData, params, start)
@@ -1603,6 +1630,8 @@ class Http {
       return Promise.resolve(result);
     });
   }
+  // endregion ////
+  // region Prepare ////
   /**
    * Processes function parameters and adds authorization
    *
@@ -1618,7 +1647,7 @@ class Http {
       result.logTag = this.#logTag;
     }
     result[this.#requestIdGenerator.getQueryStringParameterName()] = this.#requestIdGenerator.getRequestId();
-    result[this.#requestIdGenerator.getQueryStringSdkParameterName()] = "0.1.4";
+    result[this.#requestIdGenerator.getQueryStringSdkParameterName()] = "0.1.5";
     if (!!result.data && !!result.data.start) {
       delete result.data.start;
     }
@@ -1637,6 +1666,24 @@ class Http {
   #prepareMethod(method) {
     return `${encodeURIComponent(method)}.json`;
   }
+  /**
+   * @inheritDoc
+   */
+  setClientSideWarning(value, message) {
+    this.#isClientSideWarning = value;
+    this.#clientSideWarningMessage = message;
+  }
+  // endregion ////
+  // region Tools ////
+  /**
+   * Tests whether the code is executed on the client side
+   * @return {boolean}
+   * @protected
+   */
+  isServerSide() {
+    return Type.isUndefined(window);
+  }
+  // endregion ////
 }
 
 class AbstractB24 {
@@ -2691,6 +2738,10 @@ class B24Hook extends AbstractB24 {
       this.#authHookManager,
       this._getHttpOptions()
     );
+    this._http.setClientSideWarning(
+      true,
+      "It is not safe to use hook requests on the client side"
+    );
     this._isInit = true;
   }
   setLogger(logger) {
@@ -2701,6 +2752,12 @@ class B24Hook extends AbstractB24 {
     return this.#authHookManager;
   }
   // region Core ////
+  /**
+   * Disables warning about client-side query execution
+   */
+  offClientSideWarning() {
+    this.getHttpClient().setClientSideWarning(false, "");
+  }
   // endregion ////
   // region Get ////
   /**