@alfalab/bridge-to-native 0.0.2-beta-1c5826f

package/constants.d.ts

@@ -0,0 +1,12 @@
+import { NativeFeaturesFromVersion } from './types';
+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";
+export declare const PREVIOUS_NATIVE_NAVIGATION_AND_TITLE_STATE_STORAGE_KEY = "previousNativeNavigationAndTitleState";
+export declare const versionToIosAppId: {
+    readonly '0.0.0': "YWxmYWJhbms=";
+    readonly '12.22.0': "YWNvbmNpZXJnZQ==";
+    readonly '12.26.0': "a2l0dHljYXNo";
+    readonly '12.31.0': "YXdlYXNzaXN0";
+};
+export declare const nativeFeaturesFromVersion: NativeFeaturesFromVersion;

package/constants.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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.CLOSE_WEBVIEW_SEARCH_KEY = 'closeWebView';
+exports.CLOSE_WEBVIEW_SEARCH_VALUE = 'true';
+exports.PREVIOUS_B2N_STATE_STORAGE_KEY = 'previousBridgeToNativeState';
+exports.PREVIOUS_NATIVE_NAVIGATION_AND_TITLE_STATE_STORAGE_KEY = 'previousNativeNavigationAndTitleState';
+exports.versionToIosAppId = {
+    '0.0.0': 'YWxmYWJhbms=',
+    '12.22.0': 'YWNvbmNpZXJnZQ==',
+    '12.26.0': 'a2l0dHljYXNo',
+    '12.31.0': 'YXdlYXNzaXN0',
+};
+exports.nativeFeaturesFromVersion = {
+    android: {
+        linksInBrowser: {
+            nativeFeatureFtKey: 'linksInBrowserAndroid',
+            fromVersion: '11.71.0',
+        },
+        geolocation: { fromVersion: '11.71.0' },
+    },
+    ios: {
+        linksInBrowser: {
+            nativeFeatureFtKey: 'linksInBrowserIos',
+            fromVersion: '13.3.0',
+        },
+        geolocation: { fromVersion: '0.0.0' },
+    },
+};

package/index.d.ts

@@ -0,0 +1,64 @@
+import { NativeFallbacks } from './native-fallbacks';
+import { HandleRedirect, NativeNavigationAndTitle } from './native-navigation-and-title';
+import type { Environment, NativeFeatureKey, NativeFeaturesFts, NativeParams } from './types';
+declare type Theme = 'light' | 'dark';
+/**
+ * Этот класс - абстракция для связи веб приложения с нативом и предназначен ТОЛЬКО
+ * для использования в вебвью окружении.
+ */
+export declare class BridgeToNative {
+    nativeFeaturesFts: NativeFeaturesFts;
+    readonly AndroidBridge: {
+        setPageSettings: (params: string) => void;
+    } | undefined;
+    readonly environment: Environment;
+    readonly nativeFallbacks: NativeFallbacks;
+    private nextPageId;
+    private _nativeNavigationAndTitle;
+    private _originalWebviewParams;
+    private _appVersion;
+    private _iosAppId?;
+    private _theme;
+    private _handleRedirect;
+    constructor(nativeFeaturesFts: NativeFeaturesFts, handleRedirect: HandleRedirect, nativeParams?: NativeParams);
+    get theme(): Theme;
+    get appVersion(): string;
+    get iosAppId(): string | undefined;
+    get nativeNavigationAndTitle(): NativeNavigationAndTitle;
+    get originalWebviewParams(): string;
+    /**
+     * Метод, проверяющий, можно ли использовать нативную функциональность в текущей версии приложения.
+     *
+     * @param feature Название функциональности, которую нужно проверить.
+     */
+    canUseNativeFeature(feature: NativeFeatureKey): boolean;
+    /**
+     * Метод, отправляющий сигнал нативу, что нужно закрыть текущее вебвью.
+     */
+    closeWebview(): void;
+    /**
+     * Сравнивает текущую версию приложения с переданной.
+     *
+     * @param versionToCompare Версия, с которой нужно сравнить текущую.
+     * @returns `true` – текущая версия больше или равняется переданной,
+     *  `false` – текущая версия ниже.
+     */
+    isCurrentVersionHigherOrEqual(versionToCompare: string): boolean;
+    /**
+     * Сохраняет текущее состояние BridgeToNative в sessionStorage.
+     * Так же сохраняет текущее состояние nativeNavigationAndTitle.
+     */
+    private saveCurrentState;
+    /**
+     * Возвращает схему приложения в iOS окружении, на основе версии.
+     *
+     * @param knownIosAppId Тип iOS приложения, если он известен.
+     * @returns Тип приложения, `undefined` для Android окружения.
+     */
+    private getIosAppId;
+    /**
+     * Восстанавливает свое предыдущее состояние из sessionStorage
+     */
+    private restorePreviousState;
+}
+export {};

package/index.js

@@ -0,0 +1,144 @@
+"use strict";
+/* eslint-disable no-underscore-dangle */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BridgeToNative = void 0;
+const constants_1 = require("./constants");
+const native_fallbacks_1 = require("./native-fallbacks");
+const native_navigation_and_title_1 = require("./native-navigation-and-title");
+const utils_1 = require("./utils");
+/**
+ * Этот класс - абстракция для связи веб приложения с нативом и предназначен ТОЛЬКО
+ * для использования в вебвью окружении.
+ */
+class BridgeToNative {
+    constructor(nativeFeaturesFts = { 'linksInBrowserAndroid': true, 'linksInBrowserIos': true }, handleRedirect, nativeParams) {
+        this.nativeFeaturesFts = nativeFeaturesFts;
+        // Webview, запущенное в Android окружении имеет объект `Android` в window.
+        this.AndroidBridge = window.Android;
+        this.environment = this.AndroidBridge ? 'android' : 'ios';
+        const previousState = !!sessionStorage.getItem(constants_1.PREVIOUS_B2N_STATE_STORAGE_KEY);
+        if (previousState) {
+            this.restorePreviousState();
+            this.nativeFallbacks = new native_fallbacks_1.NativeFallbacks(this);
+            return;
+        }
+        this._appVersion =
+            nativeParams && (0, utils_1.isValidVersionFormat)(nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.appVersion)
+                ? nativeParams.appVersion
+                : '0.0.0';
+        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.nextPageId = nativeParams ? nativeParams.nextPageId : null;
+        this.nativeFallbacks = new native_fallbacks_1.NativeFallbacks(this);
+    }
+    get theme() {
+        return this._theme;
+    }
+    get appVersion() {
+        return this._appVersion;
+    }
+    get iosAppId() {
+        return this._iosAppId;
+    }
+    get nativeNavigationAndTitle() {
+        return this._nativeNavigationAndTitle;
+    }
+    get originalWebviewParams() {
+        return this._originalWebviewParams;
+    }
+    /**
+     * Метод, проверяющий, можно ли использовать нативную функциональность в текущей версии приложения.
+     *
+     * @param feature Название функциональности, которую нужно проверить.
+     */
+    canUseNativeFeature(feature) {
+        const { nativeFeatureFtKey, fromVersion } = constants_1.nativeFeaturesFromVersion[this.environment][feature];
+        if (nativeFeatureFtKey && !this.nativeFeaturesFts[nativeFeatureFtKey]) {
+            return false;
+        }
+        return this.isCurrentVersionHigherOrEqual(fromVersion);
+    }
+    /**
+     * Метод, отправляющий сигнал нативу, что нужно закрыть текущее вебвью.
+     */
+    // eslint-disable-next-line class-methods-use-this
+    closeWebview() {
+        const originalPageUrl = new URL(window.location.href);
+        originalPageUrl.searchParams.set(constants_1.CLOSE_WEBVIEW_SEARCH_KEY, constants_1.CLOSE_WEBVIEW_SEARCH_VALUE);
+        window.location.href = originalPageUrl.toString();
+    }
+    /**
+     * Сравнивает текущую версию приложения с переданной.
+     *
+     * @param versionToCompare Версия, с которой нужно сравнить текущую.
+     * @returns `true` – текущая версия больше или равняется переданной,
+     *  `false` – текущая версия ниже.
+     */
+    isCurrentVersionHigherOrEqual(versionToCompare) {
+        if (!(0, utils_1.isValidVersionFormat)(versionToCompare)) {
+            return false;
+        }
+        const matchPattern = /(\d+)\.(\d+)\.(\d+)/;
+        const [, ...appVersionComponents] = this._appVersion.match(matchPattern); // Формат версии проверен в конструкторе, можно смело убирать `null` из типа.
+        const [, ...versionToCompareComponents] = versionToCompare.match(matchPattern);
+        for (let i = 0; i < appVersionComponents.length; i++) {
+            if (appVersionComponents[i] !== versionToCompareComponents[i]) {
+                return appVersionComponents[i] >= versionToCompareComponents[i];
+            }
+        }
+        return true;
+    }
+    /**
+     * Сохраняет текущее состояние BridgeToNative в sessionStorage.
+     * Так же сохраняет текущее состояние nativeNavigationAndTitle.
+     */
+    saveCurrentState() {
+        // В nativeNavigationAndTitle этот метод отмечен модификатором доступа private дабы не торчал наружу, но тут его нужно вызвать
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        this._nativeNavigationAndTitle.saveCurrentState();
+        const currentState = {
+            appVersion: this._appVersion,
+            theme: this._theme,
+            nextPageId: this.nextPageId,
+            originalWebviewParams: this._originalWebviewParams || '',
+            iosAppId: this._iosAppId,
+        };
+        sessionStorage.setItem(constants_1.PREVIOUS_B2N_STATE_STORAGE_KEY, JSON.stringify(currentState));
+    }
+    /**
+     * Возвращает схему приложения в iOS окружении, на основе версии.
+     *
+     * @param knownIosAppId Тип iOS приложения, если он известен.
+     * @returns Тип приложения, `undefined` для Android окружения.
+     */
+    getIosAppId(knownIosAppId) {
+        if (this.environment !== 'ios') {
+            return undefined;
+        }
+        if (knownIosAppId) {
+            return knownIosAppId;
+        }
+        const keys = Object.keys(constants_1.versionToIosAppId);
+        const rightKey = [...keys].reverse().find((version) => this.isCurrentVersionHigherOrEqual(version)) ||
+            keys[0];
+        return atob(constants_1.versionToIosAppId[rightKey]);
+    }
+    /**
+     * Восстанавливает свое предыдущее состояние из sessionStorage
+     */
+    restorePreviousState() {
+        const previousState = JSON.parse(sessionStorage.getItem(constants_1.PREVIOUS_B2N_STATE_STORAGE_KEY) || '');
+        this._appVersion = previousState.appVersion;
+        this._iosAppId = previousState.iosAppId;
+        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);
+        sessionStorage.removeItem(constants_1.PREVIOUS_B2N_STATE_STORAGE_KEY);
+    }
+}
+exports.BridgeToNative = BridgeToNative;

package/native-fallbacks.d.ts

@@ -0,0 +1,59 @@
+import type { BridgeToNative } from '.';
+import { PdfType } from './types';
+/**
+ * Класс содержит реализацию обходных путей для веб-фич, которые не работают в нативном-вебвью.
+ */
+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 и разных версиях приложения, открытие ресурса будет работать по-разному:
+     *
+     * - Если текущая версия приложения может открыть ссылку в браузере,
+     *  обогащаем URL специальным query-параметром (`target=_blank` в приложении не работает).
+     * - Если это iOS, меняем URL на диплинк, который откроет ссылку в новом вебвью, поверх текущего.
+     *  К первому-вебвью, пользователь вернётся, когда закроет второе вебвью с внешним ресурсом.
+     * - В старых приложениях на Андроид – URL не меняем, но добавляем `onClick` для сбрасывания синхронизации
+     *  навигации с приложением. Это «фолбэк-сценарий» с плохим UX (сайт полностью выпадает из истории), но другого способа нет.
+     *
+     * @param link Строка - валидный урл.
+     * @param onClick Дополнительный обработчик на клик, например, для отправки метрики.
+     *  Внимание! Не факт, что в «фолбэк-сценарии» асинхронная операция будет выполнена (метрика отправлена)!
+     * @returns Пропсы для ссылки в вебвью окружении.
+     */
+    getExternalLinkProps(link: string, onClick?: () => void): {
+        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 Строка - валидный урл.
+     */
+    visitExternalResource(link: string): void;
+}

package/native-fallbacks.js

@@ -0,0 +1,116 @@
+"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 и разных версиях приложения, открытие ресурса будет работать по-разному:
+     *
+     * - Если текущая версия приложения может открыть ссылку в браузере,
+     *  обогащаем URL специальным query-параметром (`target=_blank` в приложении не работает).
+     * - Если это iOS, меняем URL на диплинк, который откроет ссылку в новом вебвью, поверх текущего.
+     *  К первому-вебвью, пользователь вернётся, когда закроет второе вебвью с внешним ресурсом.
+     * - В старых приложениях на Андроид – URL не меняем, но добавляем `onClick` для сбрасывания синхронизации
+     *  навигации с приложением. Это «фолбэк-сценарий» с плохим UX (сайт полностью выпадает из истории), но другого способа нет.
+     *
+     * @param link Строка - валидный урл.
+     * @param onClick Дополнительный обработчик на клик, например, для отправки метрики.
+     *  Внимание! Не факт, что в «фолбэк-сценарии» асинхронная операция будет выполнена (метрика отправлена)!
+     * @returns Пропсы для ссылки в вебвью окружении.
+     */
+    getExternalLinkProps(link, onClick) {
+        const { iosAppId } = this.b2n;
+        const url = (0, utils_1.getUrlInstance)(link);
+        if (this.b2n.canUseNativeFeature('linksInBrowser')) {
+            url.searchParams.append('openInBrowser', 'true');
+            return { href: url.href, onClick };
+        }
+        if (iosAppId) {
+            return {
+                href: `${iosAppId}://webFeature?type=recommendation&url=${encodeURIComponent(url.href)}`,
+                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();
+        const { environment, iosAppId } = this.b2n;
+        if (environment === 'ios') {
+            replaceUrl = `${iosAppId}:///dashboard/pdf_viewer?${paramsStr}`;
+        }
+        // У андройда через диплинк открывается, но предыдущий экран затирается.
+        // Поэтому мы открываем base64 через конвертирование в бинарный pdf (через ручки сервиса)
+        // Это позволяет перейти назад к вебвью
+        if (environment === 'android' && type === 'base64') {
+            replaceUrl = `/services/base64-to-pdf?${paramsStr}`;
+        }
+        window.open(replaceUrl);
+    }
+    /**
+     * Метод, для перехода на ВНЕШНИЙ ресурс.
+     *
+     * См. описание в `getExternalLinkProps`, чтобы узнать, как выбирается способ для перехода.
+     *
+     * @param link Строка - валидный урл.
+     */
+    visitExternalResource(link) {
+        var _a;
+        const { iosAppId } = this.b2n;
+        const url = (0, utils_1.getUrlInstance)(link);
+        if (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 {
+            (_a = this.b2n.nativeNavigationAndTitle) === null || _a === void 0 ? void 0 : _a.setInitialView('');
+            window.location.replace(url.href);
+        }
+    }
+}
+exports.NativeFallbacks = NativeFallbacks;

package/native-navigation-and-title.d.ts

@@ -0,0 +1,142 @@
+import { BridgeToNative } from '.';
+export declare type HandleRedirect = (appName: string, path?: string, params?: Record<string, string>) => void;
+/**
+ * Класс, отвечающий за взаимодействие с нативными элементами в приложении – заголовком
+ * и нативной кнопкой назад.
+ */
+export declare class NativeNavigationAndTitle {
+    private b2n;
+    private nativeHistoryStack;
+    private numOfBackSteps;
+    private lastSetPageSettingsParams;
+    private handleWindowRedirect;
+    constructor(b2n: BridgeToNative, pageId: number | null, initialNativeTitle: string | undefined, handleWindowRedirect: HandleRedirect);
+    /**
+     * Метод, вызывающий `history.back()` или закрывающий вебвью, если нет записей
+     * в истории переходов.
+     */
+    goBack(): void;
+    /**
+     * Метод, вызывающий history.go(-колл. шагов назад) и модифицирует внутреннее
+     * состояние, чтобы в дальнейшем зарегистририровать этот переход в приложении.
+     *
+     * @param stepsNumber Количество шагов назад.
+     *  Возможно передача как положительного, так и отрицательного числа.
+     *  0 будет проигнорирован.
+     * @param autocloseWebview Флаг – закрывать ли вебвью автоматически,
+     *  если переданное кол-во шагов будет больше, чем записей в истории.
+     */
+    goBackAFewSteps(stepsNumber: number, autocloseWebview?: boolean): void;
+    /**
+     * @param path Путь для перехода на функциональность внутри приложения.
+     */
+    handleRedirect(path: string): void;
+    /**
+     * В этом варианте аргументы 2,3,4 соответствуют аргументам 1,2,3 метода `src/shared/utils/handle-redirect`.
+     *
+     * @param pageTitle Заголовок, который нужно отрисовать в приложении.
+     * @param appName См. первый параметр `src/handle-redirect.ts`.
+     * @param path См. второй параметр `src/handle-redirect.ts`.
+     * @param params См. третий параметр `src/handle-redirect.ts`.
+     */
+    handleRedirect(pageTitle: string, appName: string, path?: string, params?: Record<string, string>): void;
+    /**
+     * Информирует натив, что веб находится на первом экране (сбрасывает историю переходов, не влияя на браузерную
+     * историю), а значит следующее нажатие на кнопку "Назад" в нативне закроет вебвью.
+     *
+     * @param pageTitle Заголовок, который нужно отрисовать в нативе.
+     */
+    setInitialView(pageTitle?: string): void;
+    /**
+     * Метод для смены заголовка в нативе без влияния на историю переходов.
+     *
+     * @param pageTitle Заголовок, который нужно отрисовать в нативе.
+     */
+    setTitle(pageTitle: string): void;
+    /**
+     * Метод для открытия второго web приложения в рамках
+     * одной вебвью сессии
+     * сохраняет все текущее состояние текущего экземпляра bridgeToAm и AmNavigationAndTitle в sessionStorage, а
+     * так же наполняет url необходимыми query параметрами. Работает только в Android окружении.
+     * В IOS окружении будет открыто новое webview поверх текущего.
+     * @param url адрес второго web приложения к которому перед переходом на него будут добавлены
+     * все initial query параметры от натива и параметр nextPageId (Android)
+     */
+    navigateInsideASharedSession(url: string): void;
+    /**
+     * ПОКА НЕ ИСПОЛЬЗОВАТЬ В ПРОДЕ (МЕТОД НЕ РАБОТАЕТ КОРРЕКТНО НА ANDROID)
+     * НА ANDROID ПРИ ПЕРЕЗАГРУЗКЕ СТРАНИЦЫ В ИСТРИЮ ЛОЖИТСЯ + ЕЩЕ ОДИН ЛИШНИЙ ЭЛЕМЕНТ
+     * Данный метод будет дорабатываться отдельной задачей
+     * Безопасный способ для перезагрузки страницы.
+     * Производит предварительное сохранение текущего состояния
+     * BridgeToNative и NativeNavigationAndTitle перед вызовом location.reload()
+     */
+    reloadPage(): void;
+    /**
+     * Метод для сохранения текущего состояния NativeNavigationAndTitle в sessionStorage.
+     */
+    private saveCurrentState;
+    /**
+     * Метод, вычисляющий `pageId`, который нужно послать в приложение
+     * для правильной синхронизации с нативной-кнопкой "Назад".
+     *
+     * @param purpose Цель взаимодействия с приложением.
+     * @returns Правильный pageId.
+     */
+    private getNativePageId;
+    /**
+     * Вспомогательный метод для `getNativePageId` initialization кейса.
+     *
+     * @returns Правильный pageId.
+     */
+    private getNativePageIdForInitialization;
+    /**
+     * Вспомогательный метод для `getNativePageId` navigation кейса.
+     *
+     * @returns Правильный pageId.
+     */
+    private getNativePageIdForNavigation;
+    /**
+     * Вспомогательный метод для `getNativePageId` only-title кейса.
+     *
+     * @returns Правильный pageId.
+     */
+    private getNativePageIdForTitleReplacing;
+    /**
+     * Обработчик для `window.onpopstate` события. Который сработает
+     * после нажатия на кнопку "Назад" в нативе, вызова `history.back()` и `history.go(-x)`.
+     */
+    private handleBack;
+    /**
+     * Синхронизирует состояние истории переходов и заголовок с приложением.
+     *
+     * @param pageTitle Заголовок, который нужно отрисовать в приложении.
+     * @param purpose Цель взаимодействия с приложением.
+     */
+    private syncHistoryWithNative;
+    /**
+     * Метод для перехода в веб из другого веб приложения в рамках
+     * одной вебвью сессии
+     * @param pageId - Номер текущего page который нужно отправить в приложение
+     * @param title - Title текущего page который нужно отправить в приложение
+     */
+    private supportSharedSession;
+    /**
+     * Восстанавливает свое предыдущее состояние nativeHistoryStack и title из sessionStorage
+     */
+    private restorePreviousState;
+    /**
+     *  Вспомогательный метод для setInitialView, supportSharedSession
+     *  переназначает обработчик @handleBack для `window.onpopstate` события
+     */
+    private reassignPopstateListener;
+    /**
+     * Вспомогательный метод для navigateInsideASharedSession.
+     * Подготавливает внешнюю ссылку в рамках контракта для совместной работы веб-приложений в
+     * рамках одной вебвью сессии
+     * @param url - url иного веб приложения
+     * @return подготовленная согласно контракту ссылка на иное веб приложение с initial query
+     * параметрами от нативе, а так же nextPageId
+     */
+    private prepareExternalLinkBeforeOpen;
+}

package/native-navigation-and-title.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NativeNavigationAndTitle = void 0;
+const constants_1 = require("./constants");
+const utils_1 = require("./utils");
+/**
+ * Класс, отвечающий за взаимодействие с нативными элементами в приложении – заголовком
+ * и нативной кнопкой назад.
+ */
+class NativeNavigationAndTitle {
+    constructor(b2n, pageId, initialNativeTitle = '', handleWindowRedirect) {
+        this.b2n = b2n;
+        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);
+        }
+        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, appName, path, params) {
+        if (appName) {
+            this.handleWindowRedirect(appName, path, params);
+        }
+        else {
+            const { appName: extractedAppName, path: extractedPath, query: extractedQuery, } = (0, utils_1.extractAppNameRouteAndQuery)(pageTitleOrPath);
+            this.handleWindowRedirect(extractedAppName, extractedPath, extractedQuery);
+        }
+        const title = appName ? 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') {
+            this.b2n.nativeFallbacks.visitExternalResource(url);
+            return;
+        }
+        // В b2n этот метод отмечен модификатором доступа private, но тут его нужно вызвать
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        this.b2n.saveCurrentState();
+        window.location.assign(this.prepareExternalLinkBeforeOpen(url));
+    }
+    /**
+     * ПОКА НЕ ИСПОЛЬЗОВАТЬ В ПРОДЕ (МЕТОД НЕ РАБОТАЕТ КОРРЕКТНО НА ANDROID)
+     * НА ANDROID ПРИ ПЕРЕЗАГРУЗКЕ СТРАНИЦЫ В ИСТРИЮ ЛОЖИТСЯ + ЕЩЕ ОДИН ЛИШНИЙ ЭЛЕМЕНТ
+     * Данный метод будет дорабатываться отдельной задачей
+     * Безопасный способ для перезагрузки страницы.
+     * Производит предварительное сохранение текущего состояния
+     * BridgeToNative и NativeNavigationAndTitle перед вызовом location.reload()
+     */
+    reloadPage() {
+        // В b2n этот метод отмечен модификатором доступа private, но тут его нужно вызвать
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        this.b2n.saveCurrentState();
+        window.location.reload();
+    }
+    /**
+     * Метод для сохранения текущего состояния NativeNavigationAndTitle в sessionStorage.
+     */
+    saveCurrentState() {
+        const currentState = {
+            title: this.nativeHistoryStack[this.nativeHistoryStack.length - 1],
+            nativeHistoryStack: this.nativeHistoryStack,
+        };
+        sessionStorage.setItem(constants_1.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(constants_1.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) {
+        var _a;
+        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) {
+                (_a = this.b2n.AndroidBridge) === null || _a === void 0 ? void 0 : _a.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(constants_1.PREVIOUS_NATIVE_NAVIGATION_AND_TITLE_STATE_STORAGE_KEY) || '');
+        this.nativeHistoryStack = previousState.nativeHistoryStack;
+        this.syncHistoryWithNative(previousState.title, 'title-replacing');
+        this.reassignPopstateListener();
+        sessionStorage.removeItem(constants_1.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();
+    }
+}
+exports.NativeNavigationAndTitle = NativeNavigationAndTitle;

package/package.json

@@ -0,0 +1,107 @@
+{
+    "license": "UNLICENSED",
+    "name": "@alfalab/bridge-to-native",
+    "version": "0.0.2-beta-1c5826f",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/core-ds/bridge-to-native.git"
+    },
+    "bugs": {
+        "url": "https://github.com/core-ds/bridge-to-native/issues"
+    },
+    "description": "Утилита для удобной работы веб приложения внутри нативного приложения и коммуникации с ним.",
+    "scripts": {
+        "build": "yarn compile",
+        "changelog": "bash bin/fill-changelog-file.sh",
+        "compile": "yarn compile:clean && yarn compile:ts && yarn compile:copy-resources",
+        "compile:copy-package-json": "shx cp package.json .publish/package.json",
+        "compile:copy-resources": "yarn copyfiles -e \"**/*.{[jt]s*(x),snap}\" -e \"**/*.json\" -e \"src/mock/**/*\" -u 1 \"src/**/*\" .publish",
+        "compile:clean": "shx rm -rf .publish",
+        "compile:ts": "tsc --project tsconfig.build.json",
+        "create-release-commit": "git add package.json CHANGELOG.md && git commit -m \"$MESSAGE\" && git push origin \"$BRANCH\"",
+        "lint:scripts": "eslint \"**/*.{js,jsx,ts,tsx}\" --ext .js,.jsx,.ts,.tsx",
+        "lint": "yarn lint:scripts && prettier --check \"./src/*.{ts,tsx,js,jsx,json}\"",
+        "lint:fix": "yarn lint:scripts --fix",
+        "pub": "npm publish .publish --userconfig \"../.npmrc\" --tag \"$TAG\"",
+        "format": "prettier --write \"./**/*.{ts,tsx,js,jsx,css,json}\"",
+        "test": "jest --silent --collect-coverage",
+        "release": "yarn compile && npm version \"$VERSION\" --no-git-tag-version && yarn compile:copy-package-json && yarn pub"
+    },
+    "dependencies": {},
+    "devDependencies": {
+        "@types/jest": "27.5.2",
+        "@types/node": "14.14.22",
+        "@typescript-eslint/eslint-plugin": "^5.30.6",
+        "@typescript-eslint/parser": "^5.30.6",
+        "arui-presets-lint": "6.2.0",
+        "arui-scripts": "15.10.3",
+        "copyfiles": "2.4.1",
+        "eslint": "^8.20.0",
+        "eslint-config-airbnb": "^19.0.4",
+        "eslint-config-airbnb-typescript": "^17.0.0",
+        "eslint-config-prettier": "^8.5.0",
+        "eslint-import-resolver-typescript": "~3.1.5",
+        "eslint-plugin-cypress": "^2.12.1",
+        "eslint-plugin-dirnames": "^1.0.3",
+        "eslint-plugin-import": "^2.26.0",
+        "eslint-plugin-jsx-a11y": "^6.6.1",
+        "eslint-plugin-react": "^7.30.1",
+        "eslint-plugin-react-hooks": "^4.6.0",
+        "eslint-plugin-simple-import-sort": "^7.0.0",
+        "eslint-plugin-unicorn": "^42.0.0",
+        "husky": "^4.3.8",
+        "jest": "27.5.1",
+        "jest-junit": "10.0.0",
+        "lint-staged": "^12.5.0",
+        "prettier": "^2.7.1",
+        "promisify-child-process": "4.1.1",
+        "stylelint": "^14.9.1",
+        "stylelint-config-prettier": "^9.0.3",
+        "ts-jest": "25.3.1",
+        "typescript": "4.5.5",
+        "shx": "0.3.4"
+    },
+    "peerDependencies": {},
+    "jest": {
+        "preset": "arui-scripts",
+        "testEnvironment": "jsdom",
+        "testRegex": "/test/.*\\.ts$",
+        "moduleFileExtensions": [
+            "ts",
+            "js"
+        ],
+        "coveragePathIgnorePatterns": [
+            "/node_modules/",
+            "/test/"
+        ],
+        "transformIgnorePatterns": [
+            "node_modules/(?!(uuid)/)"
+        ],
+        "testPathIgnorePatterns": [
+            "/node_modules/"
+        ],
+        "reporters": [
+            "jest-junit",
+            "default"
+        ]
+    },
+    "jest-junit": {
+        "output": "./test-results.xml"
+    },
+    "prettier": "arui-presets-lint/prettier",
+    "eslintConfig": {
+        "extends": "./node_modules/arui-presets-lint/eslint"
+    },
+    "stylelint": {
+        "extends": "arui-presets-lint/stylelint",
+        "ignoreFiles": [
+            "coverage/**/*.js"
+        ]
+    },
+    "commitlint": {
+        "extends": "./node_modules/arui-presets-lint/commitlint"
+    },
+    "publishConfig": {
+        "registry": "https://registry.npmjs.org"
+    }
+}

package/types.d.ts

@@ -0,0 +1,35 @@
+export declare type NativeParams = {
+    appVersion: string;
+    title?: string;
+    iosAppId?: string;
+    theme: string;
+    nextPageId: number | null;
+    originalWebviewParams: string;
+};
+declare type NativeFeatureFtKey = 'linksInBrowserAndroid' | 'linksInBrowserIos';
+export declare type NativeFeaturesFts = Record<NativeFeatureFtKey, boolean>;
+export declare type NativeFeatureKey = 'geolocation' | 'linksInBrowser';
+declare type NativeFeaturesParams = Readonly<Record<NativeFeatureKey, {
+    nativeFeatureFtKey?: NativeFeatureFtKey;
+    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 {};

package/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/utils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Разделяет веб ссылку на компоненты
+ * @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;

package/utils.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidVersionFormat = exports.getUrlInstance = exports.extractAppNameRouteAndQuery = void 0;
+/**
+ * Разделяет веб ссылку на компоненты
+ * @param route внутренний путь для навигации
+ * @return объект с appName, route, query
+ */
+const extractAppNameRouteAndQuery = (route) => {
+    var _a;
+    let appName = '';
+    let path = '';
+    let query;
+    const clearedPath = route.replace(/(?:^\/)|(?:\/$)/g, '');
+    const segments = clearedPath.split('/');
+    const queryByPath = clearedPath.split('?')[1];
+    appName = ((_a = segments.shift()) === null || _a === void 0 ? void 0 : _a.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 };
+};
+exports.extractAppNameRouteAndQuery = extractAppNameRouteAndQuery;
+/**
+ * Возвращает экземпляр `URL` из ссылки, докидывая `https://` при отсутствии.
+ */
+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;
+};
+exports.getUrlInstance = getUrlInstance;
+/**
+ * Проверяет, что переданная строка содержит версию приложения в правильном формате.
+ *
+ * @param version Строка с версией для проверки.
+ * @returns Правильный формат или нет.
+ */
+const isValidVersionFormat = (version) => {
+    if (!version)
+        return false;
+    const versionPattern = /^\d+\.\d+\.\d+$/;
+    return versionPattern.test(version);
+};
+exports.isValidVersionFormat = isValidVersionFormat;