@alfalab/bridge-to-native 0.0.8 → 0.0.9-beta-fa134e1

package/bridge-to-native.d.ts

@@ -6,25 +6,26 @@ import type { Environment, HandleRedirect, NativeFeatureKey, NativeParams, Theme
  * для использования в вебвью окружении.
  */
 export declare class BridgeToNative {
+    private readonly handleRedirect;
+    private readonly blankPagePath;
+    private readonly nativeParams?;
     readonly AndroidBridge: {
         setPageSettings: (params: string) => void;
     } | undefined;
     readonly environment: Environment;
     readonly nativeFallbacks: NativeFallbacks;
     private nextPageId;
+    constructor(handleRedirect: HandleRedirect, blankPagePath: string, nativeParams?: NativeParams | undefined);
     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 +44,7 @@ export declare class BridgeToNative {
      *  `false` – текущая версия ниже.
      */
     isCurrentVersionHigherOrEqual(versionToCompare: string): boolean;
+    checkAndroidAllowOpenInNewWebview(): boolean;
     /**
      * Сохраняет текущее состояние BridgeToNative в sessionStorage.
      * Так же сохраняет текущее состояние nativeNavigationAndTitle.

package/bridge-to-native.js

@@ -1,5 +1,4 @@
 "use strict";
-/* eslint-disable no-underscore-dangle */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BridgeToNative = void 0;
 const constants_1 = require("./constants");
@@ -12,6 +11,9 @@ const utils_1 = require("./utils");
  */
 class BridgeToNative {
     constructor(handleRedirect, blankPagePath, nativeParams) {
+        this.handleRedirect = handleRedirect;
+        this.blankPagePath = blankPagePath;
+        this.nativeParams = nativeParams;
         // Webview, запущенное в Android окружении имеет объект `Android` в window.
         this.AndroidBridge = window.Android;
         this.environment = this.AndroidBridge ? 'android' : 'ios';
@@ -19,7 +21,6 @@ class BridgeToNative {
         if (previousState) {
             this.restorePreviousState();
             this.nativeFallbacks = new native_fallbacks_1.NativeFallbacks(this);
-            this._blankPagePath = blankPagePath;
             return;
         }
         this._appVersion =
@@ -29,14 +30,15 @@ class BridgeToNative {
         this._iosAppId = this.getIosAppId(nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.iosAppId);
         this._theme = (nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.theme) === 'dark' ? 'dark' : 'light';
         this._originalWebviewParams = (nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.originalWebviewParams) || '';
-        this._nativeNavigationAndTitle = new native_navigation_and_title_1.NativeNavigationAndTitle(this, nativeParams ? nativeParams.nextPageId : null, nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.title, handleRedirect);
-        this._handleRedirect = handleRedirect;
+        this._nativeNavigationAndTitle = new native_navigation_and_title_1.NativeNavigationAndTitle(this, (nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.nextPageId) || null, nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.title, handleRedirect);
         this.nextPageId = nativeParams ? nativeParams.nextPageId : null;
         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 +46,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 +88,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.
@@ -102,7 +105,7 @@ class BridgeToNative {
             appVersion: this._appVersion,
             theme: this._theme,
             nextPageId: this.nextPageId,
-            originalWebviewParams: this._originalWebviewParams || '',
+            originalWebviewParams: this.originalWebviewParams,
             iosAppId: this._iosAppId,
         };
         sessionStorage.setItem(constants_1.PREVIOUS_B2N_STATE_STORAGE_KEY, JSON.stringify(currentState));
@@ -135,7 +138,7 @@ class BridgeToNative {
         this._theme = previousState.theme;
         this._originalWebviewParams = previousState.originalWebviewParams;
         this.nextPageId = previousState.nextPageId;
-        this._nativeNavigationAndTitle = new native_navigation_and_title_1.NativeNavigationAndTitle(this, previousState.nextPageId, '', this._handleRedirect);
+        this._nativeNavigationAndTitle = new native_navigation_and_title_1.NativeNavigationAndTitle(this, previousState.nextPageId, '', this.handleRedirect);
         sessionStorage.removeItem(constants_1.PREVIOUS_B2N_STATE_STORAGE_KEY);
     }
 }

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,10 +1,10 @@
-import { PdfType } from './types';
+import { ExternalNavigationOptions, PdfType } from './types';
 import type { BridgeToNative } from './bridge-to-native';
 /**
  * Класс содержит реализацию обходных путей для веб-фич, которые не работают в нативном-вебвью.
  */
 export declare class NativeFallbacks {
-    private b2n;
+    private readonly b2n;
     constructor(b2n: BridgeToNative);
     /**
      * Метод, возвращающий пропсы для ссылок, ведущих на ВНЕШНИЙ ресурс. Которые просто
@@ -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, 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, 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/native-navigation-and-title.d.ts

@@ -4,12 +4,14 @@ import { BridgeToNative } from './bridge-to-native';
  * Класс, отвечающий за взаимодействие с нативными элементами в приложении – заголовком и нативной кнопкой назад.
  */
 export declare class NativeNavigationAndTitle {
-    private b2n;
+    private readonly b2n;
+    private readonly pageId;
+    private readonly initialNativeTitle;
+    private readonly handleWindowRedirect;
     private nativeHistoryStack;
     private numOfBackSteps;
     private lastSetPageSettingsParams;
-    private readonly _handleWindowRedirect;
-    constructor(b2n: BridgeToNative, pageId: number | null, initialNativeTitle: string | undefined, handleWindowRedirect: HandleRedirect);
+    constructor(b2n: BridgeToNative, pageId: number | null, initialNativeTitle: string, handleWindowRedirect: HandleRedirect);
     /**
      * Метод, вызывающий `history.back()` или закрывающий вебвью, если нет записей
      * в истории переходов.

package/native-navigation-and-title.js

@@ -9,13 +9,15 @@ const utils_1 = require("./utils");
 class NativeNavigationAndTitle {
     constructor(b2n, pageId, initialNativeTitle = '', handleWindowRedirect) {
         this.b2n = b2n;
+        this.pageId = pageId;
+        this.initialNativeTitle = initialNativeTitle;
+        this.handleWindowRedirect = handleWindowRedirect;
         this.nativeHistoryStack = [''];
         this.numOfBackSteps = 1;
         // Тут сохраняются параметры, которые в последний раз были отправлены в приложение.
         // Просто, чтобы не слать одинаковые сигналы в приложение.
         this.lastSetPageSettingsParams = '';
         this.handleBack = this.handleBack.bind(this);
-        this._handleWindowRedirect = handleWindowRedirect;
         const previousState = !!sessionStorage.getItem(constants_1.PREVIOUS_NATIVE_NAVIGATION_AND_TITLE_STATE_STORAGE_KEY);
         if (pageId) {
             this.supportSharedSession(pageId, initialNativeTitle);
@@ -63,17 +65,17 @@ class NativeNavigationAndTitle {
         window.history.go(-this.numOfBackSteps);
     }
     /**
-     * Метод вызывает `src/shared/utils/handle-redirect` из `newclick-host-ui`
-     * и регистрирует этот переход в приложении, чтобы кнопка «Назад» в Нативе вызывала
+     * Метод вызывает handle-redirect и регистрирует этот переход в
+     * приложении, чтобы кнопка «Назад» в Нативе вызывала
      * переход назад в вебе.
      */
     handleRedirect(pageTitleOrPath, appName, path, params) {
         if (appName) {
-            this._handleWindowRedirect(appName, path, params);
+            this.handleWindowRedirect(appName, path, params);
         }
         else {
             const { appName: extractedAppName, path: extractedPath, query: extractedQuery, } = (0, utils_1.extractAppNameRouteAndQuery)(pageTitleOrPath);
-            this._handleWindowRedirect(extractedAppName, extractedPath, extractedQuery);
+            this.handleWindowRedirect(extractedAppName, extractedPath, extractedQuery);
         }
         const title = appName ? pageTitleOrPath : '';
         this.nativeHistoryStack.push(title);
@@ -127,7 +129,7 @@ class NativeNavigationAndTitle {
         // В b2n этот метод отмечен модификатором доступа private, но тут его нужно вызвать
         // eslint-disable-next-line @typescript-eslint/ban-ts-comment
         // @ts-ignore
-        this.handleRedirect(this.b2n._blankPagePath);
+        this.handleRedirect(this.b2n.blankPagePath);
         this.goBack();
     }
     /**

package/package.json

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

package/types.d.ts

@@ -19,7 +19,6 @@ export declare type WebViewWindow = Window & {
     Android?: {
         setPageSettings: (params: string) => void;
     };
-    handleRedirect?: (appName: string, path?: string, params?: Record<string, string>) => VoidFunction;
 };
 export declare type PdfType = 'pdfFile' | 'base64' | 'binary';
 export declare type PreviousBridgeToNativeState = Omit<NativeParams, 'title' | 'theme'> & {
@@ -32,4 +31,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;