@alfalab/bridge-to-native 0.2.2 → 1.0.1

package/esm/native-navigation-and-title.js

@@ -1,326 +0,0 @@
-import { DEEP_LINK_PATTERN, PREVIOUS_NATIVE_NAVIGATION_AND_TITLE_STATE_STORAGE_KEY, } from './constants';
-import { extractAppNameRouteAndQuery } from './utils';
-/**
- * Класс, отвечающий за взаимодействие с нативными элементами в приложении – заголовком и нативной кнопкой назад.
- */
-export class NativeNavigationAndTitle {
-    b2n;
-    nativeHistoryStack = [''];
-    numOfBackSteps = 1;
-    // Тут сохраняются параметры, которые в последний раз были отправлены в приложение.
-    // Просто, чтобы не слать одинаковые сигналы в приложение.
-    lastSetPageSettingsParams = '';
-    _handleWindowRedirect;
-    constructor(b2n, pageId, initialNativeTitle = '', handleWindowRedirect) {
-        this.b2n = b2n;
-        this.handleBack = this.handleBack.bind(this);
-        this._handleWindowRedirect = handleWindowRedirect;
-        const previousState = !!sessionStorage.getItem(PREVIOUS_NATIVE_NAVIGATION_AND_TITLE_STATE_STORAGE_KEY);
-        if (pageId) {
-            this.supportSharedSession(pageId, initialNativeTitle);
-        }
-        else if (previousState) {
-            this.restorePreviousState();
-        }
-        else {
-            this.setInitialView(initialNativeTitle);
-        }
-    }
-    /**
-     * Метод, вызывающий `history.back()` или закрывающий вебвью, если нет записей
-     * в истории переходов.
-     */
-    goBack() {
-        this.goBackAFewSteps(-1, true);
-    }
-    /**
-     * Метод, вызывающий history.go(-колл. шагов назад) и модифицирует внутреннее
-     * состояние, чтобы в дальнейшем зарегистрировать этот переход в приложении.
-     *
-     * @param stepsNumber Количество шагов назад.
-     *  Возможно передача как положительного, так и отрицательного числа.
-     *  0 будет проигнорирован.
-     * @param autoCloseWebview Флаг – закрывать ли вебвью автоматически,
-     * если переданное кол-во шагов будет больше чем записей в истории.
-     */
-    goBackAFewSteps(stepsNumber, autoCloseWebview = false) {
-        if (!stepsNumber) {
-            return;
-        }
-        const stepsToBack = Math.abs(stepsNumber);
-        const maxStepsToBack = this.nativeHistoryStack.length - 1;
-        if (stepsToBack > maxStepsToBack) {
-            if (autoCloseWebview) {
-                this.b2n.closeWebview();
-                return;
-            }
-            this.numOfBackSteps = maxStepsToBack;
-        }
-        else {
-            this.numOfBackSteps = stepsToBack;
-        }
-        window.history.go(-this.numOfBackSteps);
-    }
-    /**
-     * Метод вызывает `src/shared/utils/handle-redirect` из `newclick-host-ui`
-     * и регистрирует этот переход в приложении, чтобы кнопка «Назад» в Нативе вызывала
-     * переход назад в вебе.
-     */
-    handleRedirect(pageTitleOrPath, appNameOrHistoryState, path, params, historyState) {
-        const checkAppNameArgument = (argument) => Boolean(appNameOrHistoryState && typeof appNameOrHistoryState === 'string');
-        const isAppNameArgument = checkAppNameArgument(appNameOrHistoryState);
-        if (isAppNameArgument) {
-            this._handleWindowRedirect(appNameOrHistoryState, path, params, historyState);
-        }
-        else {
-            const { appName: extractedAppName, path: extractedPath, query: extractedQuery, } = extractAppNameRouteAndQuery(pageTitleOrPath);
-            this._handleWindowRedirect(extractedAppName, extractedPath, extractedQuery, appNameOrHistoryState);
-        }
-        const title = isAppNameArgument ? pageTitleOrPath : '';
-        this.nativeHistoryStack.push(title);
-        this.syncHistoryWithNative(title, 'navigation');
-    }
-    /**
-     * Информирует натив, что веб находится на первом экране (сбрасывает историю переходов, не влияя на браузерную
-     * историю), а значит следующее нажатие на кнопку "Назад" в нативе закроет вебвью.
-     *
-     * @param pageTitle Заголовок, который нужно отрисовать в нативе.
-     */
-    setInitialView(pageTitle = '') {
-        this.nativeHistoryStack = [pageTitle];
-        this.syncHistoryWithNative(pageTitle, 'initialization');
-        this.reassignPopstateListener();
-    }
-    /**
-     * Метод для смены заголовка в нативе без влияния на историю переходов.
-     *
-     * @param pageTitle Заголовок, который нужно отрисовать в нативе.
-     */
-    setTitle(pageTitle) {
-        this.nativeHistoryStack[this.nativeHistoryStack.length - 1] = pageTitle;
-        this.syncHistoryWithNative(pageTitle, 'title-replacing');
-    }
-    /**
-     * Метод для открытия второго web приложения в рамках одной вебвью сессии.
-     * Сохраняет все текущее состояние текущего экземпляра bridgeToAm и AmNavigationAndTitle в sessionStorage, а
-     * так же наполняет url необходимыми query параметрами. Работает только в Android окружении.
-     * В IOS окружении будет открыто новое webview поверх текущего.
-     *
-     * @param url адрес второго web приложения, к которому перед переходом на него будут добавлены
-     * все initial query параметры от натива и параметр nextPageId (Android)
-     */
-    navigateInsideASharedSession(url) {
-        if (this.b2n.environment === 'ios') {
-            const nativeDeeplink = `/webFeature?type=recommendation&url=${encodeURIComponent(url)}`;
-            this.handleNativeDeeplink(nativeDeeplink);
-            return;
-        }
-        // В b2n этот метод отмечен модификатором доступа private, но тут его нужно вызвать
-        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-        // @ts-ignore
-        this.b2n.saveCurrentState();
-        window.location.assign(this.prepareExternalLinkBeforeOpen(url));
-    }
-    /**
-     * Безопасный способ для перезагрузки страницы.
-     */
-    pseudoReloadPage() {
-        // В b2n этот метод отмечен модификатором доступа private, но тут его нужно вызвать
-        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-        // @ts-ignore
-        this.handleRedirect(this.b2n._blankPagePath);
-        this.goBack();
-    }
-    /**
-     * Вызывает обработчик deeplinks в нативе (АМ) и передает туда переданный deeplink.
-     * На Android текущее webview будет закрыто из-за технических особенностей.
-     * На IOS нативная фича открывается в следующем по стеку экране и при выходе из нее пользователь вернется обратно в webview.
-     * На IOS есть возможность закрыть webview перед открытием нативной фичи, передав второй параметр closeIOSWebviewBeforeCallNativeDeeplinkHandler = true
-     * @param deeplink диплинк на нативную АМ фичу в AM
-     * @param [closeIOSWebviewBeforeCallNativeDeeplinkHandler = false] закрыть текущее webview после открытия нативной фичи (применимо только для IOS на Android по техническим причинам webview всегда будет закрываться)
-     */
-    handleNativeDeeplink(deeplink, closeIOSWebviewBeforeCallNativeDeeplinkHandler = false) {
-        const clearedDeeplinkPath = deeplink.replace(DEEP_LINK_PATTERN, '');
-        if (this.b2n.environment === 'ios') {
-            if (closeIOSWebviewBeforeCallNativeDeeplinkHandler) {
-                this.b2n.closeWebview();
-                setTimeout(() => window.location.replace(`${this.b2n.iosAppId}://${clearedDeeplinkPath}`), 0);
-                return;
-            }
-            window.location.replace(`${this.b2n.iosAppId}://${clearedDeeplinkPath}`);
-        }
-        else {
-            window.location.replace(`alfabank://${clearedDeeplinkPath}`);
-        }
-    }
-    /**
-     * Метод для сохранения текущего состояния NativeNavigationAndTitle в sessionStorage.
-     */
-    saveCurrentState() {
-        const currentState = {
-            title: this.nativeHistoryStack[this.nativeHistoryStack.length - 1],
-            nativeHistoryStack: this.nativeHistoryStack,
-        };
-        sessionStorage.setItem(PREVIOUS_NATIVE_NAVIGATION_AND_TITLE_STATE_STORAGE_KEY, JSON.stringify(currentState));
-    }
-    /**
-     * Метод, вычисляющий `pageId`, который нужно послать в приложение
-     * для правильной синхронизации с нативной-кнопкой "Назад".
-     *
-     * @param purpose Цель взаимодействия с приложением.
-     * @returns Правильный pageId.
-     */
-    getNativePageId(purpose) {
-        function assertUnreachable(val) {
-            throw new Error(`Unexpected value "${val}"`);
-        }
-        let pageId;
-        switch (purpose) {
-            case 'initialization':
-                pageId = this.getNativePageIdForInitialization();
-                break;
-            case 'navigation':
-                pageId = this.getNativePageIdForNavigation();
-                break;
-            case 'title-replacing':
-                pageId = this.getNativePageIdForTitleReplacing();
-                break;
-            default:
-                assertUnreachable(purpose);
-        }
-        return pageId;
-    }
-    /**
-     * Вспомогательный метод для `getNativePageId` initialization кейса.
-     *
-     * @returns Правильный pageId.
-     */
-    getNativePageIdForInitialization() {
-        // * В iOS для "первой" страницы не нужно слать `pageId`.
-        // * В Android важно, чтобы `pageId` "первой" страницы
-        //  всегда был одинаковый.
-        return this.b2n.environment === 'ios' ? null : 1;
-    }
-    /**
-     * Вспомогательный метод для `getNativePageId` navigation кейса.
-     *
-     * @returns Правильный pageId.
-     */
-    getNativePageIdForNavigation() {
-        const stackSize = this.nativeHistoryStack.length;
-        // Нажимая на кнопку назад, можно дойти до "первой" страницы,
-        // в iOS для "первой" страницы не нужно слать `pageId`.
-        return this.b2n.environment === 'ios' && stackSize <= 1 ? null : stackSize;
-    }
-    /**
-     * Вспомогательный метод для `getNativePageId` only-title кейса.
-     *
-     * @returns Правильный pageId.
-     */
-    getNativePageIdForTitleReplacing() {
-        const stackSize = this.nativeHistoryStack.length;
-        if (this.b2n.environment === 'android') {
-            // Для смены заголовка в Андроид просто повторяем текущий `pageId`.
-            // В отличии от iOS, если не послать `pageId` первой страницы,
-            // Вебвью не будет закрываться по клику на нативный «Назад».
-            return stackSize <= 1 ? 1 : stackSize;
-        }
-        // Если в iOS не послать `pageId`, следующее нажатие на
-        // нативную кнопку назад закроет webview.
-        return stackSize <= 1 ? null : stackSize;
-    }
-    /**
-     * Обработчик для `window.onpopstate` события. Который сработает
-     * после нажатия на кнопку "Назад" в нативе, вызова `history.back()` и `history.go(-x)`.
-     */
-    handleBack() {
-        const previousState = !!sessionStorage.getItem(PREVIOUS_NATIVE_NAVIGATION_AND_TITLE_STATE_STORAGE_KEY);
-        if (previousState) {
-            // В b2n этот метод отмечен модификатором доступа private дабы не торчал наружу, но тут его нужно вызвать
-            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-            // @ts-ignore
-            this.b2n.restorePreviousState();
-        }
-        this.nativeHistoryStack = this.nativeHistoryStack.slice(0, -this.numOfBackSteps);
-        this.numOfBackSteps = 1;
-        if (this.nativeHistoryStack.length < 1) {
-            this.b2n.closeWebview();
-            return;
-        }
-        const pageTitle = this.nativeHistoryStack[this.nativeHistoryStack.length - 1];
-        this.syncHistoryWithNative(pageTitle, 'navigation');
-    }
-    /**
-     * Синхронизирует состояние истории переходов и заголовок с приложением.
-     *
-     * @param pageTitle Заголовок, который нужно отрисовать в приложении.
-     * @param purpose Цель взаимодействия с приложением.
-     */
-    syncHistoryWithNative(pageTitle, purpose) {
-        const pageId = this.getNativePageId(purpose);
-        if (this.b2n.environment === 'android') {
-            const pageSettingsObj = { pageTitle };
-            if (pageId) {
-                pageSettingsObj.pageId = pageId;
-            }
-            const paramsToSend = JSON.stringify(pageSettingsObj);
-            if (this.lastSetPageSettingsParams !== paramsToSend) {
-                this.b2n.AndroidBridge?.setPageSettings(paramsToSend);
-                this.lastSetPageSettingsParams = paramsToSend;
-            }
-        }
-        else {
-            const pageTitleStr = `?pageTitle=${encodeURIComponent(pageTitle)}`;
-            const pageIdStr = pageId ? `&pageId=${pageId}` : '';
-            const paramsToSend = `ios:setPageSettings/${pageTitleStr + pageIdStr}`;
-            if (this.lastSetPageSettingsParams !== paramsToSend) {
-                window.location.replace(paramsToSend);
-                this.lastSetPageSettingsParams = paramsToSend;
-            }
-        }
-    }
-    /**
-     * Метод для перехода в веб из другого веб приложения в рамках
-     * одной вебвью сессии
-     * @param pageId - Номер текущего page который нужно отправить в приложение
-     * @param title - Title текущего page который нужно отправить в приложение
-     */
-    supportSharedSession(pageId, title) {
-        this.nativeHistoryStack = new Array(pageId).fill('');
-        this.syncHistoryWithNative(title, 'title-replacing');
-        this.reassignPopstateListener();
-    }
-    /**
-     * Восстанавливает свое предыдущее состояние nativeHistoryStack и title из sessionStorage
-     */
-    restorePreviousState() {
-        const previousState = JSON.parse(sessionStorage.getItem(PREVIOUS_NATIVE_NAVIGATION_AND_TITLE_STATE_STORAGE_KEY) || '');
-        this.nativeHistoryStack = previousState.nativeHistoryStack;
-        this.syncHistoryWithNative(previousState.title, 'title-replacing');
-        this.reassignPopstateListener();
-        sessionStorage.removeItem(PREVIOUS_NATIVE_NAVIGATION_AND_TITLE_STATE_STORAGE_KEY);
-    }
-    /**
-     *  Вспомогательный метод для setInitialView, supportSharedSession
-     *  переназначает обработчик @handleBack для `window.onpopstate` события
-     */
-    reassignPopstateListener() {
-        window.removeEventListener('popstate', this.handleBack);
-        window.addEventListener('popstate', this.handleBack);
-    }
-    /**
-     * Вспомогательный метод для navigateInsideASharedSession.
-     * Подготавливает внешнюю ссылку в рамках контракта для совместной работы веб-приложений в
-     * рамках одной вебвью сессии
-     * @param url - url иного веб приложения
-     * @return подготовленная согласно контракту ссылка на иное веб приложение с initial query
-     * параметрами от натива, а так же nextPageId.
-     */
-    prepareExternalLinkBeforeOpen(url) {
-        const currentPageId = this.nativeHistoryStack.length;
-        const divider = new URL(url).searchParams.toString() ? '&' : '?';
-        const link = new URL(`${url}${divider}${this.b2n.originalWebviewParams}`);
-        link.searchParams.set('nextPageId', (currentPageId + 1).toString());
-        return link.toString();
-    }
-}

package/esm/types.d.ts

@@ -1,39 +0,0 @@
-export declare type NativeParams = {
-    appVersion: string;
-    title?: string;
-    iosAppId?: string;
-    theme: string;
-    nextPageId: number | null;
-    originalWebviewParams: string;
-};
-export declare type NativeFeatureKey = 'geolocation' | 'linksInBrowser' | 'savedBackStack';
-declare type NativeFeaturesParams = Readonly<Record<NativeFeatureKey, {
-    fromVersion: string;
-}>>;
-export declare type NativeFeaturesFromVersion = Readonly<{
-    android: NativeFeaturesParams;
-    ios: NativeFeaturesParams;
-}>;
-export declare type Environment = 'android' | 'ios';
-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'> & {
-    theme: 'dark' | 'light';
-};
-export declare type PreviousNativeNavigationAndTitleState = {
-    nativeHistoryStack: string[];
-    title: string;
-};
-export declare type SyncPurpose = 'initialization' | 'navigation' | 'title-replacing';
-export declare type HandleRedirect = (appName: string, path?: string, params?: Record<string, string>, historyState?: Record<string, unknown>) => void;
-export declare type Theme = 'light' | 'dark';
-export declare type ExternalNavigationOptions = {
-    onClick?: () => void;
-    forceOpenInWebview?: boolean;
-};
-export {};

package/esm/types.js

@@ -1 +0,0 @@
-export {};

package/esm/utils.d.ts

@@ -1,23 +0,0 @@
-import { Environment } from './types';
-/**
- * Разделяет веб ссылку на компоненты
- * @param route внутренний путь для навигации
- * @return объект с appName, route, query
- */
-export declare const extractAppNameRouteAndQuery: (route: string) => {
-    appName: string;
-    path: string;
-    query: Record<string, string> | undefined;
-};
-/**
- * Возвращает экземпляр `URL` из ссылки, докидывая `https://` при отсутствии.
- */
-export declare const getUrlInstance: (link: string) => URL;
-/**
- * Проверяет, что переданная строка содержит версию приложения в правильном формате.
- *
- * @param version Строка с версией для проверки.
- * @returns Правильный формат или нет.
- */
-export declare const isValidVersionFormat: (version?: string | undefined) => boolean;
-export declare const getAppId: (environment: Environment, iosAppId?: string | undefined) => string | null;

package/esm/utils.js

@@ -1,62 +0,0 @@
-import { ANDROID_APP_ID } from './constants';
-/**
- * Разделяет веб ссылку на компоненты
- * @param route внутренний путь для навигации
- * @return объект с appName, route, query
- */
-export const extractAppNameRouteAndQuery = (route) => {
-    let appName = '';
-    let path = '';
-    let query;
-    const clearedPath = route.replace(/(?:^\/)|(?:\/$)/g, '');
-    const segments = clearedPath.split('/');
-    const queryByPath = clearedPath.split('?')[1];
-    appName = segments.shift()?.split('?')[0] || '';
-    if (queryByPath) {
-        query = Array.from(new URLSearchParams(queryByPath).entries()).reduce((acc, [key, value]) => ({ ...acc, [key]: value }), {});
-    }
-    path = segments.join('/').replace(`?${queryByPath}`, '');
-    return { appName, path, query };
-};
-/**
- * Возвращает экземпляр `URL` из ссылки, докидывая `https://` при отсутствии.
- */
-export const getUrlInstance = (link) => {
-    const protocolRequiredPattern = /^https?:\/\//;
-    let url;
-    if (protocolRequiredPattern.test(link)) {
-        url = new URL(link);
-    }
-    else {
-        try {
-            // Пробуем докинуть `https://`, как правило, это помогает.
-            url = new URL(`https://${link}`);
-        }
-        catch (e) {
-            // Кажется, добавив протокол, сюда мы больше не сможем вывалиться, но на всякий случай...
-            url = new URL('about:blank');
-        }
-    }
-    return url;
-};
-/**
- * Проверяет, что переданная строка содержит версию приложения в правильном формате.
- *
- * @param version Строка с версией для проверки.
- * @returns Правильный формат или нет.
- */
-export const isValidVersionFormat = (version) => {
-    if (!version)
-        return false;
-    const versionPattern = /^\d+\.\d+\.\d+$/;
-    return versionPattern.test(version);
-};
-export const getAppId = (environment, iosAppId) => {
-    if (environment === 'android') {
-        return atob(ANDROID_APP_ID);
-    }
-    if (environment === 'ios' && iosAppId && typeof iosAppId === 'string') {
-        return iosAppId;
-    }
-    return null;
-};

package/index.d.ts

@@ -1,2 +0,0 @@
-export { BridgeToNative } from './bridge-to-native';
-export { NativeParams, Theme, Environment, NativeFeatureKey, PdfType } from './types';

package/native-fallbacks.d.ts

@@ -1,64 +0,0 @@
-import { ExternalNavigationOptions, PdfType } from './types';
-import type { BridgeToNative } from './bridge-to-native';
-/**
- * Класс содержит реализацию обходных путей для веб-фич, которые не работают в нативном-вебвью.
- */
-export declare class NativeFallbacks {
-    private b2n;
-    constructor(b2n: BridgeToNative);
-    /**
-     * Метод, возвращающий пропсы для ссылок, ведущих на ВНЕШНИЙ ресурс. Которые просто
-     * нужно «подмешать» к ссылке в JSX:
-     *
-     * ```
-     * <a {...bridgeToNative.nativeFallbacks.getExternalLinkProps('https://ya.ru')}>Link to external feature</a>
-     * ```
-     * Либо просто достать интересующие поля - onClick или href
-     * ```
-     * const {onClick, href} = bridgeToNative.nativeFallbacks.getExternalLinkProps(url, clickHandler)
-     * document.querySelector('.myLink').onclick = onClick;
-     * <a {...bridgeToNative.nativeFallbacks.getExternalLinkProps('https://ya.ru')}>Link to external feature</a>
-     * ```
-     * В разных OS и разных версиях приложения, открытие ресурса будет работать по-разному:
-     *
-     * - Если текущая версия приложения может открыть ссылку в браузере и не задан параметр `forceOpenInWebview`,
-     *  обогащаем URL специальным query-параметром (`target=_blank` в приложении не работает).
-     * - Если это iOS, меняем URL на диплинк, который откроет ссылку в новом вебвью, поверх текущего.
-     *  К первому-вебвью, пользователь вернётся, когда закроет второе вебвью с внешним ресурсом.
-     * - В старых приложениях на Андроид – URL не меняем, но добавляем `onClick` для сбрасывания синхронизации
-     *  навигации с приложением. Это «фолбэк-сценарий» с плохим UX (сайт полностью выпадает из истории), но другого способа нет.
-     *
-     * @param link Строка - валидный урл.
-     * @param options - опции
-     * @param options.forceOpenInWebview Boolean - по умолчанию = false, если передать true,
-     * все ссылки будут открываться в рамках webview, иначе открытие по возможности будет происходить в браузере.
-     * @param options.onClick Дополнительный обработчик на клик, например, для отправки метрики.
-     *  Внимание! Не факт, что в «фолбэк-сценарии» асинхронная операция будет выполнена (метрика отправлена)!
-     * @returns Пропсы для ссылки в вебвью окружении.
-     */
-    getExternalLinkProps(link: string, options?: ExternalNavigationOptions): {
-        href: string;
-        onClick: (() => void) | undefined;
-    };
-    /**
-     * Метод для открытия PDF в нативном вьювере.
-     *
-     * Есть нюансы с версиями приложения, OS устройства.
-     * Надо тестировать по моде статистики.
-     *
-     * @param url ссылка на pdf
-     * @param type тип pdf ссылки
-     * @param title название pdf файла
-     */
-    openPdf(url: string, type?: PdfType, title?: string): void;
-    /**
-     * Метод, для перехода на ВНЕШНИЙ ресурс.
-     *
-     * См. описание в `getExternalLinkProps`, чтобы узнать, как выбирается способ для перехода.
-     *
-     * @param link Строка - валидный урл.
-     * @param forceOpenInWebview Boolean - по умолчанию = false, если передать true,
-     * все ссылки будут открываться в рамках webview, иначе открытие по возможности будет происходить в браузере.
-     */
-    visitExternalResource(link: string, forceOpenInWebview?: boolean): void;
-}

package/native-fallbacks.js

@@ -1,124 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NativeFallbacks = void 0;
-const utils_1 = require("./utils");
-/**
- * Класс содержит реализацию обходных путей для веб-фич, которые не работают в нативном-вебвью.
- */
-class NativeFallbacks {
-    constructor(b2n) {
-        this.b2n = b2n;
-    }
-    /**
-     * Метод, возвращающий пропсы для ссылок, ведущих на ВНЕШНИЙ ресурс. Которые просто
-     * нужно «подмешать» к ссылке в JSX:
-     *
-     * ```
-     * <a {...bridgeToNative.nativeFallbacks.getExternalLinkProps('https://ya.ru')}>Link to external feature</a>
-     * ```
-     * Либо просто достать интересующие поля - onClick или href
-     * ```
-     * const {onClick, href} = bridgeToNative.nativeFallbacks.getExternalLinkProps(url, clickHandler)
-     * document.querySelector('.myLink').onclick = onClick;
-     * <a {...bridgeToNative.nativeFallbacks.getExternalLinkProps('https://ya.ru')}>Link to external feature</a>
-     * ```
-     * В разных OS и разных версиях приложения, открытие ресурса будет работать по-разному:
-     *
-     * - Если текущая версия приложения может открыть ссылку в браузере и не задан параметр `forceOpenInWebview`,
-     *  обогащаем URL специальным query-параметром (`target=_blank` в приложении не работает).
-     * - Если это iOS, меняем URL на диплинк, который откроет ссылку в новом вебвью, поверх текущего.
-     *  К первому-вебвью, пользователь вернётся, когда закроет второе вебвью с внешним ресурсом.
-     * - В старых приложениях на Андроид – URL не меняем, но добавляем `onClick` для сбрасывания синхронизации
-     *  навигации с приложением. Это «фолбэк-сценарий» с плохим UX (сайт полностью выпадает из истории), но другого способа нет.
-     *
-     * @param link Строка - валидный урл.
-     * @param options - опции
-     * @param options.forceOpenInWebview Boolean - по умолчанию = false, если передать true,
-     * все ссылки будут открываться в рамках webview, иначе открытие по возможности будет происходить в браузере.
-     * @param options.onClick Дополнительный обработчик на клик, например, для отправки метрики.
-     *  Внимание! Не факт, что в «фолбэк-сценарии» асинхронная операция будет выполнена (метрика отправлена)!
-     * @returns Пропсы для ссылки в вебвью окружении.
-     */
-    getExternalLinkProps(link, options = {}) {
-        const { onClick, forceOpenInWebview } = options;
-        const url = (0, utils_1.getUrlInstance)(link);
-        const appId = (0, utils_1.getAppId)(this.b2n.environment, this.b2n.iosAppId);
-        if (!forceOpenInWebview && this.b2n.canUseNativeFeature('linksInBrowser')) {
-            url.searchParams.append('openInBrowser', 'true');
-            return { href: url.href, onClick };
-        }
-        if (this.b2n.iosAppId || this.b2n.checkAndroidAllowOpenInNewWebview()) {
-            return {
-                href: `${appId}://webFeature?type=recommendation&url=${encodeURIComponent(url.href)}`,
-                onClick: options === null || options === void 0 ? void 0 : options.onClick,
-            };
-        }
-        return {
-            href: url.href,
-            onClick: () => {
-                var _a;
-                onClick === null || onClick === void 0 ? void 0 : onClick();
-                (_a = this.b2n.nativeNavigationAndTitle) === null || _a === void 0 ? void 0 : _a.setInitialView('');
-            },
-        };
-    }
-    /**
-     * Метод для открытия PDF в нативном вьювере.
-     *
-     * Есть нюансы с версиями приложения, OS устройства.
-     * Надо тестировать по моде статистики.
-     *
-     * @param url ссылка на pdf
-     * @param type тип pdf ссылки
-     * @param title название pdf файла
-     */
-    openPdf(url, type = 'pdfFile', title) {
-        const params = new URLSearchParams();
-        params.append('type', type);
-        params.append('url', decodeURIComponent(url));
-        if (title) {
-            params.append('title', title.replace(/\s/g, '_'));
-        }
-        let replaceUrl = url;
-        const paramsStr = params.toString();
-        if (this.b2n.environment === 'ios') {
-            replaceUrl = `${this.b2n.iosAppId}:///dashboard/pdf_viewer?${paramsStr}`;
-        }
-        // У андройда через диплинк открывается, но предыдущий экран затирается.
-        // Поэтому мы открываем base64 через конвертирование в бинарный pdf (через ручки сервиса)
-        // Это позволяет перейти назад к вебвью
-        if (this.b2n.environment === 'android' && type === 'base64') {
-            replaceUrl = `/services/base64-to-pdf?${paramsStr}`;
-        }
-        const windowObjectReference = window.open(replaceUrl);
-        if (windowObjectReference === null) {
-            window.location.replace(replaceUrl);
-        }
-    }
-    /**
-     * Метод, для перехода на ВНЕШНИЙ ресурс.
-     *
-     * См. описание в `getExternalLinkProps`, чтобы узнать, как выбирается способ для перехода.
-     *
-     * @param link Строка - валидный урл.
-     * @param forceOpenInWebview Boolean - по умолчанию = false, если передать true,
-     * все ссылки будут открываться в рамках webview, иначе открытие по возможности будет происходить в браузере.
-     */
-    visitExternalResource(link, forceOpenInWebview = false) {
-        var _a;
-        const url = (0, utils_1.getUrlInstance)(link);
-        const appId = (0, utils_1.getAppId)(this.b2n.environment, this.b2n.iosAppId);
-        if (!forceOpenInWebview && this.b2n.canUseNativeFeature('linksInBrowser')) {
-            url.searchParams.append('openInBrowser', 'true');
-            window.location.replace(url.href);
-        }
-        else if (this.b2n.iosAppId || this.b2n.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('');
-            window.location.replace(url.href);
-        }
-    }
-}
-exports.NativeFallbacks = NativeFallbacks;