@alfalab/bridge-to-native 0.0.8 → 0.0.9

package/bridge-to-native.d.ts

@@ -12,19 +12,19 @@ export declare class BridgeToNative {
     readonly environment: Environment;
     readonly nativeFallbacks: NativeFallbacks;
     private nextPageId;
+    private readonly _blankPagePath;
+    private readonly _handleRedirect;
+    constructor(handleRedirect: HandleRedirect, blankPagePath: string, nativeParams?: NativeParams);
     private _nativeNavigationAndTitle;
+    get nativeNavigationAndTitle(): NativeNavigationAndTitle;
     private _originalWebviewParams;
+    get originalWebviewParams(): string;
     private _appVersion;
+    get appVersion(): string;
     private _iosAppId?;
+    get iosAppId(): string | undefined;
     private _theme;
-    private readonly _blankPagePath;
-    private readonly _handleRedirect;
-    constructor(handleRedirect: HandleRedirect, blankPagePath: string, nativeParams?: NativeParams);
     get theme(): Theme;
-    get appVersion(): string;
-    get iosAppId(): string | undefined;
-    get nativeNavigationAndTitle(): NativeNavigationAndTitle;
-    get originalWebviewParams(): string;
     /**
      * Метод, проверяющий, можно ли использовать нативную функциональность в текущей версии приложения.
      *
@@ -43,6 +43,7 @@ export declare class BridgeToNative {
      *  `false` – текущая версия ниже.
      */
     isCurrentVersionHigherOrEqual(versionToCompare: string): boolean;
+    checkAndroidAllowOpenInNewWebview(): boolean;
     /**
      * Сохраняет текущее состояние BridgeToNative в sessionStorage.
      * Так же сохраняет текущее состояние nativeNavigationAndTitle.

package/bridge-to-native.js

@@ -35,8 +35,11 @@ class BridgeToNative {
         this.nativeFallbacks = new native_fallbacks_1.NativeFallbacks(this);
         this._blankPagePath = blankPagePath;
     }
-    get theme() {
-        return this._theme;
+    get nativeNavigationAndTitle() {
+        return this._nativeNavigationAndTitle;
+    }
+    get originalWebviewParams() {
+        return this._originalWebviewParams;
     }
     get appVersion() {
         return this._appVersion;
@@ -44,11 +47,8 @@ class BridgeToNative {
     get iosAppId() {
         return this._iosAppId;
     }
-    get nativeNavigationAndTitle() {
-        return this._nativeNavigationAndTitle;
-    }
-    get originalWebviewParams() {
-        return this._originalWebviewParams;
+    get theme() {
+        return this._theme;
     }
     /**
      * Метод, проверяющий, можно ли использовать нативную функциональность в текущей версии приложения.
@@ -89,6 +89,10 @@ class BridgeToNative {
         }
         return true;
     }
+    checkAndroidAllowOpenInNewWebview() {
+        const comparisonResult = this.isCurrentVersionHigherOrEqual(constants_1.START_VERSION_ANDROID_ALLOW_OPEN_NEW_WEBVIEW);
+        return this.environment === 'android' && comparisonResult;
+    }
     /**
      * Сохраняет текущее состояние BridgeToNative в sessionStorage.
      * Так же сохраняет текущее состояние nativeNavigationAndTitle.

package/constants.d.ts

@@ -1,4 +1,6 @@
 import { NativeFeaturesFromVersion } from './types';
+export declare const START_VERSION_ANDROID_ALLOW_OPEN_NEW_WEBVIEW = "10.35.0";
+export declare const ANDROID_APP_ID = "YWxmYWJhbms=";
 export declare const CLOSE_WEBVIEW_SEARCH_KEY = "closeWebView";
 export declare const CLOSE_WEBVIEW_SEARCH_VALUE = "true";
 export declare const PREVIOUS_B2N_STATE_STORAGE_KEY = "previousBridgeToNativeState";

package/constants.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEEP_LINK_PATTERN = exports.nativeFeaturesFromVersion = exports.versionToIosAppId = exports.PREVIOUS_NATIVE_NAVIGATION_AND_TITLE_STATE_STORAGE_KEY = exports.PREVIOUS_B2N_STATE_STORAGE_KEY = exports.CLOSE_WEBVIEW_SEARCH_VALUE = exports.CLOSE_WEBVIEW_SEARCH_KEY = void 0;
+exports.DEEP_LINK_PATTERN = exports.nativeFeaturesFromVersion = exports.versionToIosAppId = exports.PREVIOUS_NATIVE_NAVIGATION_AND_TITLE_STATE_STORAGE_KEY = exports.PREVIOUS_B2N_STATE_STORAGE_KEY = exports.CLOSE_WEBVIEW_SEARCH_VALUE = exports.CLOSE_WEBVIEW_SEARCH_KEY = exports.ANDROID_APP_ID = exports.START_VERSION_ANDROID_ALLOW_OPEN_NEW_WEBVIEW = void 0;
+exports.START_VERSION_ANDROID_ALLOW_OPEN_NEW_WEBVIEW = '10.35.0';
+exports.ANDROID_APP_ID = 'YWxmYWJhbms=';
 exports.CLOSE_WEBVIEW_SEARCH_KEY = 'closeWebView';
 exports.CLOSE_WEBVIEW_SEARCH_VALUE = 'true';
 exports.PREVIOUS_B2N_STATE_STORAGE_KEY = 'previousBridgeToNativeState';

package/native-fallbacks.d.ts

@@ -1,4 +1,4 @@
-import { PdfType } from './types';
+import { ExternalNavigationOptions, PdfType } from './types';
 import type { BridgeToNative } from './bridge-to-native';
 /**
  * Класс содержит реализацию обходных путей для веб-фич, которые не работают в нативном-вебвью.
@@ -21,7 +21,7 @@ export declare class NativeFallbacks {
      * ```
      * В разных OS и разных версиях приложения, открытие ресурса будет работать по-разному:
      *
-     * - Если текущая версия приложения может открыть ссылку в браузере,
+     * - Если текущая версия приложения может открыть ссылку в браузере и не задан параметр `forceOpenInWebview`,
      *  обогащаем URL специальным query-параметром (`target=_blank` в приложении не работает).
      * - Если это iOS, меняем URL на диплинк, который откроет ссылку в новом вебвью, поверх текущего.
      *  К первому-вебвью, пользователь вернётся, когда закроет второе вебвью с внешним ресурсом.
@@ -29,11 +29,14 @@ export declare class NativeFallbacks {
      *  навигации с приложением. Это «фолбэк-сценарий» с плохим UX (сайт полностью выпадает из истории), но другого способа нет.
      *
      * @param link Строка - валидный урл.
-     * @param onClick Дополнительный обработчик на клик, например, для отправки метрики.
+     * @param options - опции
+     * @param options.forceOpenInWebview Boolean - по умолчанию = false, если передать true,
+     * все ссылки будут открываться в рамках webview, иначе открытие по возможности будет происходить в браузере.
+     * @param options.onClick Дополнительный обработчик на клик, например, для отправки метрики.
      *  Внимание! Не факт, что в «фолбэк-сценарии» асинхронная операция будет выполнена (метрика отправлена)!
      * @returns Пропсы для ссылки в вебвью окружении.
      */
-    getExternalLinkProps(link: string, onClick?: () => void): {
+    getExternalLinkProps(link: string, options?: ExternalNavigationOptions): {
         href: string;
         onClick: (() => void) | undefined;
     };
@@ -54,6 +57,8 @@ export declare class NativeFallbacks {
      * См. описание в `getExternalLinkProps`, чтобы узнать, как выбирается способ для перехода.
      *
      * @param link Строка - валидный урл.
+     * @param forceOpenInWebview Boolean - по умолчанию = false, если передать true,
+     * все ссылки будут открываться в рамках webview, иначе открытие по возможности будет происходить в браузере.
      */
-    visitExternalResource(link: string): void;
+    visitExternalResource(link: string, forceOpenInWebview?: boolean): void;
 }

package/native-fallbacks.js

@@ -24,7 +24,7 @@ class NativeFallbacks {
      * ```
      * В разных OS и разных версиях приложения, открытие ресурса будет работать по-разному:
      *
-     * - Если текущая версия приложения может открыть ссылку в браузере,
+     * - Если текущая версия приложения может открыть ссылку в браузере и не задан параметр `forceOpenInWebview`,
      *  обогащаем URL специальным query-параметром (`target=_blank` в приложении не работает).
      * - Если это iOS, меняем URL на диплинк, который откроет ссылку в новом вебвью, поверх текущего.
      *  К первому-вебвью, пользователь вернётся, когда закроет второе вебвью с внешним ресурсом.
@@ -32,21 +32,26 @@ class NativeFallbacks {
      *  навигации с приложением. Это «фолбэк-сценарий» с плохим UX (сайт полностью выпадает из истории), но другого способа нет.
      *
      * @param link Строка - валидный урл.
-     * @param onClick Дополнительный обработчик на клик, например, для отправки метрики.
+     * @param options - опции
+     * @param options.forceOpenInWebview Boolean - по умолчанию = false, если передать true,
+     * все ссылки будут открываться в рамках webview, иначе открытие по возможности будет происходить в браузере.
+     * @param options.onClick Дополнительный обработчик на клик, например, для отправки метрики.
      *  Внимание! Не факт, что в «фолбэк-сценарии» асинхронная операция будет выполнена (метрика отправлена)!
      * @returns Пропсы для ссылки в вебвью окружении.
      */
-    getExternalLinkProps(link, onClick) {
-        const { iosAppId } = this.b2n;
+    getExternalLinkProps(link, options = {}) {
+        const { onClick, forceOpenInWebview } = options;
+        const { iosAppId, environment, appVersion, checkAndroidAllowOpenInNewWebview } = this.b2n;
         const url = (0, utils_1.getUrlInstance)(link);
-        if (this.b2n.canUseNativeFeature('linksInBrowser')) {
+        const appId = (0, utils_1.getAppId)(environment, iosAppId);
+        if (!forceOpenInWebview && this.b2n.canUseNativeFeature('linksInBrowser')) {
             url.searchParams.append('openInBrowser', 'true');
             return { href: url.href, onClick };
         }
-        if (iosAppId) {
+        if (iosAppId || checkAndroidAllowOpenInNewWebview()) {
             return {
-                href: `${iosAppId}://webFeature?type=recommendation&url=${encodeURIComponent(url.href)}`,
-                onClick,
+                href: `${appId}://webFeature?type=recommendation&url=${encodeURIComponent(url.href)}`,
+                onClick: options === null || options === void 0 ? void 0 : options.onClick,
             };
         }
         return {
@@ -95,17 +100,20 @@ class NativeFallbacks {
      * См. описание в `getExternalLinkProps`, чтобы узнать, как выбирается способ для перехода.
      *
      * @param link Строка - валидный урл.
+     * @param forceOpenInWebview Boolean - по умолчанию = false, если передать true,
+     * все ссылки будут открываться в рамках webview, иначе открытие по возможности будет происходить в браузере.
      */
-    visitExternalResource(link) {
+    visitExternalResource(link, forceOpenInWebview = false) {
         var _a;
-        const { iosAppId } = this.b2n;
+        const { iosAppId, appVersion, environment, checkAndroidAllowOpenInNewWebview } = this.b2n;
         const url = (0, utils_1.getUrlInstance)(link);
-        if (this.b2n.canUseNativeFeature('linksInBrowser')) {
+        const appId = (0, utils_1.getAppId)(environment, iosAppId);
+        if (!forceOpenInWebview && this.b2n.canUseNativeFeature('linksInBrowser')) {
             url.searchParams.append('openInBrowser', 'true');
             window.location.replace(url.href);
         }
-        else if (iosAppId) {
-            window.location.replace(`${iosAppId}://webFeature?type=recommendation&url=${encodeURIComponent(url.href)}`);
+        else if (iosAppId || checkAndroidAllowOpenInNewWebview()) {
+            window.location.replace(`${appId}://webFeature?type=recommendation&url=${encodeURIComponent(url.href)}`);
         }
         else {
             (_a = this.b2n.nativeNavigationAndTitle) === null || _a === void 0 ? void 0 : _a.setInitialView('');

package/package.json

@@ -1,7 +1,7 @@
 {
     "license": "UNLICENSED",
     "name": "@alfalab/bridge-to-native",
-    "version": "0.0.8",
+    "version": "0.0.9",
     "repository": {
         "type": "git",
         "url": "git+https://github.com/core-ds/bridge-to-native.git"

package/types.d.ts

@@ -32,4 +32,8 @@ export declare type PreviousNativeNavigationAndTitleState = {
 export declare type SyncPurpose = 'initialization' | 'navigation' | 'title-replacing';
 export declare type HandleRedirect = (appName: string, path?: string, params?: Record<string, string>) => void;
 export declare type Theme = 'light' | 'dark';
+export declare type ExternalNavigationOptions = {
+    onClick?: () => void;
+    forceOpenInWebview?: boolean;
+};
 export {};

package/utils.d.ts

@@ -1,3 +1,4 @@
+import { Environment } from './types';
 /**
  * Разделяет веб ссылку на компоненты
  * @param route внутренний путь для навигации
@@ -19,3 +20,4 @@ export declare const getUrlInstance: (link: string) => URL;
  * @returns Правильный формат или нет.
  */
 export declare const isValidVersionFormat: (version?: string | undefined) => boolean;
+export declare const getAppId: (environment: Environment, iosAppId?: string | undefined) => string | null;

package/utils.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isValidVersionFormat = exports.getUrlInstance = exports.extractAppNameRouteAndQuery = void 0;
+exports.getAppId = exports.isValidVersionFormat = exports.getUrlInstance = exports.extractAppNameRouteAndQuery = void 0;
+const constants_1 = require("./constants");
 /**
  * Разделяет веб ссылку на компоненты
  * @param route внутренний путь для навигации
@@ -57,3 +58,13 @@ const isValidVersionFormat = (version) => {
     return versionPattern.test(version);
 };
 exports.isValidVersionFormat = isValidVersionFormat;
+const getAppId = (environment, iosAppId) => {
+    if (environment === 'android') {
+        return atob(constants_1.ANDROID_APP_ID);
+    }
+    if (environment === 'ios' && iosAppId && typeof iosAppId === 'string') {
+        return iosAppId;
+    }
+    return null;
+};
+exports.getAppId = getAppId;