@alfalab/bridge-to-native 1.4.0-beta.7b254fa → 1.4.1-beta.4145945

package/client/bridge-to-native.d.ts

@@ -127,6 +127,20 @@ export declare class BridgeToNative {
      *  Применимо для всех версий на iOS и в новых версиях на Android (>=12.30.0), в более старых WV закрывается всегда автоматически.
      */
     handleNativeDeeplink(deeplink: string, closeWebviewBeforeCallNativeDeeplinkHandler?: boolean): void;
+    /**
+     * Открывает dashboard экран NA.
+     *
+     * Полезно для сценария возврата из WV на dashboard экран приложения,
+     * когда обычный deeplink требует специальной обработки.
+     *
+     * ВАЖНО!
+     * В NA на Android до версии `12.30.0` текущее WV закрывается при открытии нового экрана,
+     * поэтому в закрытое WV невозможно вернуться back-навигацией.
+     *
+     * @param closeWebviewBeforeOpen Флаг принудительного закрытия текущего WV перед открытием dashboard экрана.
+     *  Применимо для всех версий на iOS и в новых версиях на Android (>=12.30.0), в более старых WV закрывается всегда автоматически.
+     */
+    openNativeAppDashboard(closeWebviewBeforeOpen?: boolean): void;
     /**
      * Сравнивает текущую версию приложения с переданной.
      *

package/client/bridge-to-native.js

@@ -159,6 +159,22 @@ class BridgeToNative {
     handleNativeDeeplink(deeplink, closeWebviewBeforeCallNativeDeeplinkHandler = false) {
         this.externalLinksService.handleNativeDeeplink(deeplink, closeWebviewBeforeCallNativeDeeplinkHandler);
     }
+    /**
+     * Открывает dashboard экран NA.
+     *
+     * Полезно для сценария возврата из WV на dashboard экран приложения,
+     * когда обычный deeplink требует специальной обработки.
+     *
+     * ВАЖНО!
+     * В NA на Android до версии `12.30.0` текущее WV закрывается при открытии нового экрана,
+     * поэтому в закрытое WV невозможно вернуться back-навигацией.
+     *
+     * @param closeWebviewBeforeOpen Флаг принудительного закрытия текущего WV перед открытием dashboard экрана.
+     *  Применимо для всех версий на iOS и в новых версиях на Android (>=12.30.0), в более старых WV закрывается всегда автоматически.
+     */
+    openNativeAppDashboard(closeWebviewBeforeOpen = false) {
+        this.externalLinksService.openNativeAppDashboard(closeWebviewBeforeOpen);
+    }
     /**
      * Сравнивает текущую версию приложения с переданной.
      *

package/client/services-and-utils/external-links-service.d.ts

@@ -9,6 +9,7 @@ export declare class ExternalLinksService {
     private navigationByNativeAppInProgress;
     constructor(nativeParamsService: NativeParamsService);
     handleNativeDeeplink(deeplink: string, closeWebviewBeforeCallNativeDeeplinkHandler?: boolean): void;
+    openNativeAppDashboard(closeWebviewBeforeOpen?: boolean): void;
     getHrefToOpenInBrowser(link: string): string;
     openInBrowser(link: string): void;
     openInNewWebview(link: string, nativeTitle?: string, closeCurrentWebview?: boolean): void;

package/client/services-and-utils/external-links-service.js

@@ -35,6 +35,22 @@ class ExternalLinksService {
         }
         this.navigateByNativeApp(preparedNativeUrl);
     }
+    openNativeAppDashboard(closeWebviewBeforeOpen = false) {
+        if (this.navigationByNativeAppInProgress) {
+            return;
+        }
+        const originalNativeUrl = `${this.nativeParamsService.appId}:///`;
+        const preparedNativeUrl = this.nativeParamsService.environment === 'ios'
+            ? (0, utils_1.appendFromCurrentQueryParamForIos)(originalNativeUrl)
+            : originalNativeUrl;
+        if (closeWebviewBeforeOpen &&
+            this.nativeParamsService.canUseNativeFeature('savedBackStack')) {
+            (0, utils_1.closeWebviewUtil)();
+            setTimeout(() => window.location.replace(preparedNativeUrl), 0);
+            return;
+        }
+        this.navigateByNativeApp(preparedNativeUrl);
+    }
     getHrefToOpenInBrowser(link) {
         if (!this.nativeParamsService.canUseNativeFeature('linksInBrowser')) {
             return `${this.nativeParamsService.appId}://webFeature?type=recommendation&url=${encodeURIComponent(link)}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfalab/bridge-to-native",
-  "version": "1.4.0-beta.7b254fa",
+  "version": "1.4.1-beta.4145945",
   "license": "MIT",
   "description": "Утилита для удобной работы веб приложения внутри нативного приложения и коммуникации с ним.",
   "engines": {