@bitrix24/b24jssdk 0.4.3 → 0.4.4

package/dist/esm/index.d.mts

@@ -1572,8 +1572,18 @@ interface EventOnAppInstallHandlerParams extends EventHandlerParams {
  * @todo fix this application_token
  * @see https://apidocs.bitrix24.com/api-reference/events/safe-event-handlers.html
  */
-interface EventOnAppUnInstallHandlerParams extends EventHandlerParams {
+interface EventOnAppUnInstallHandlerParams {
+    event: string;
+    event_handler_id: string;
+    ts: string;
     [key: string]: any;
+    auth: {
+        domain: string;
+        client_endpoint: string;
+        server_endpoint: string;
+        member_id: string;
+        application_token: string;
+    };
 }
 
 type TypePullMessage = {
@@ -2207,6 +2217,7 @@ declare class B24Hook extends AbstractB24 implements TypeB24 {
      * Get the account address BX24 with Path ( https://name.bitrix24.com/rest/1/xxxxx )
      */
     getTargetOriginWithPath(): string;
+    static fromWebhookUrl(url: string): B24Hook;
 }
 
 /**

package/dist/esm/index.d.ts

@@ -1572,8 +1572,18 @@ interface EventOnAppInstallHandlerParams extends EventHandlerParams {
  * @todo fix this application_token
  * @see https://apidocs.bitrix24.com/api-reference/events/safe-event-handlers.html
  */
-interface EventOnAppUnInstallHandlerParams extends EventHandlerParams {
+interface EventOnAppUnInstallHandlerParams {
+    event: string;
+    event_handler_id: string;
+    ts: string;
     [key: string]: any;
+    auth: {
+        domain: string;
+        client_endpoint: string;
+        server_endpoint: string;
+        member_id: string;
+        application_token: string;
+    };
 }
 
 type TypePullMessage = {
@@ -2207,6 +2217,7 @@ declare class B24Hook extends AbstractB24 implements TypeB24 {
      * Get the account address BX24 with Path ( https://name.bitrix24.com/rest/1/xxxxx )
      */
     getTargetOriginWithPath(): string;
+    static fromWebhookUrl(url: string): B24Hook;
 }
 
 /**

package/dist/esm/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @version @bitrix24/b24jssdk v0.4.3
+ * @version @bitrix24/b24jssdk v0.4.4
  * @copyright (c) 2025 Bitrix24
  * @licence MIT
  * @links https://github.com/bitrix24/b24jssdk - GitHub
@@ -1678,7 +1678,7 @@ class Http {
   #clientSideWarningMessage = "";
   constructor(baseURL, authActions, options) {
     const defaultHeaders = {
-      // 'X-Sdk': 'b24-js-sdk-v-0.4.3'
+      // 'X-Sdk': 'b24-js-sdk-v-0.4.4'
     };
     this.#clientAxios = axios.create({
       baseURL,
@@ -2106,7 +2106,7 @@ class Http {
     const baseUrl = `${encodeURIComponent(method)}.json`;
     const queryParams = new URLSearchParams({
       [this.#requestIdGenerator.getQueryStringParameterName()]: this.#requestIdGenerator.getRequestId(),
-      [this.#requestIdGenerator.getQueryStringSdkParameterName()]: "0.4.3",
+      [this.#requestIdGenerator.getQueryStringSdkParameterName()]: "0.4.4",
       [this.#requestIdGenerator.getQueryStringSdkTypeParameterName()]: "b24-js-sdk"
     });
     return `${baseUrl}?${queryParams.toString()}`;
@@ -3246,6 +3246,35 @@ class B24Hook extends AbstractB24 {
   }
   // endregion ////
   // region Tools ////
+  static fromWebhookUrl(url) {
+    if (!url.trim()) {
+      throw new Error("Webhook URL cannot be empty");
+    }
+    let parsedUrl;
+    try {
+      parsedUrl = new URL(url);
+    } catch {
+      throw new Error(`Invalid webhook URL format: ${url}`);
+    }
+    if (parsedUrl.protocol !== "https:") {
+      throw new Error("Webhook requires HTTPS protocol");
+    }
+    const pathParts = parsedUrl.pathname.split("/").filter(Boolean);
+    if (pathParts.length < 3 || pathParts[0] !== "rest") {
+      throw new Error("Webhook URL must follow format: /rest/<userId>/<secret>");
+    }
+    const userIdStr = pathParts[1];
+    const secret = pathParts[2];
+    if (!/^\d+$/.test(userIdStr)) {
+      throw new Error(`User ID must be numeric in webhook URL, received: ${userIdStr}`);
+    }
+    const userId = Number.parseInt(userIdStr, 10);
+    return new B24Hook({
+      b24Url: parsedUrl.origin,
+      userId,
+      secret
+    });
+  }
   // endregion ////
 }