@alfalab/bridge-to-native 0.0.13 → 0.1.0

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

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

package/esm/bridge-to-native.js

@@ -0,0 +1,154 @@
+/* eslint-disable no-underscore-dangle */
+import { CLOSE_WEBVIEW_SEARCH_KEY, CLOSE_WEBVIEW_SEARCH_VALUE, nativeFeaturesFromVersion, PREVIOUS_B2N_STATE_STORAGE_KEY, START_VERSION_ANDROID_ALLOW_OPEN_NEW_WEBVIEW, versionToIosAppId, } from './constants';
+import { NativeFallbacks } from './native-fallbacks';
+import { NativeNavigationAndTitle } from './native-navigation-and-title';
+import { isValidVersionFormat } from './utils';
+/**
+ * Этот класс — абстракция для связи веб приложения с нативом и предназначен ТОЛЬКО
+ * для использования в вебвью окружении.
+ */
+export class BridgeToNative {
+    // Webview, запущенное в Android окружении имеет объект `Android` в window.
+    AndroidBridge = window.Android;
+    environment = this.AndroidBridge ? 'android' : 'ios';
+    nativeFallbacks;
+    nextPageId;
+    _blankPagePath;
+    _handleRedirect;
+    constructor(handleRedirect, blankPagePath, nativeParams) {
+        const previousState = !!sessionStorage.getItem(PREVIOUS_B2N_STATE_STORAGE_KEY);
+        if (previousState) {
+            this._handleRedirect = handleRedirect;
+            this.restorePreviousState();
+            this.nativeFallbacks = new NativeFallbacks(this);
+            this._blankPagePath = blankPagePath;
+            return;
+        }
+        this._appVersion =
+            nativeParams && isValidVersionFormat(nativeParams?.appVersion)
+                ? nativeParams.appVersion
+                : '0.0.0';
+        this._iosAppId = this.getIosAppId(nativeParams?.iosAppId);
+        this._theme = nativeParams?.theme === 'dark' ? 'dark' : 'light';
+        this._originalWebviewParams = nativeParams?.originalWebviewParams || '';
+        this._nativeNavigationAndTitle = new NativeNavigationAndTitle(this, nativeParams ? nativeParams.nextPageId : null, nativeParams?.title, handleRedirect);
+        this._handleRedirect = handleRedirect;
+        this.nextPageId = nativeParams ? nativeParams.nextPageId : null;
+        this.nativeFallbacks = new NativeFallbacks(this);
+        this._blankPagePath = blankPagePath;
+    }
+    _nativeNavigationAndTitle;
+    get nativeNavigationAndTitle() {
+        return this._nativeNavigationAndTitle;
+    }
+    _originalWebviewParams;
+    get originalWebviewParams() {
+        return this._originalWebviewParams;
+    }
+    // В формате `x.x.x`.
+    _appVersion;
+    get appVersion() {
+        return this._appVersion;
+    }
+    // Необходимо для формирования диплинка.
+    _iosAppId;
+    get iosAppId() {
+        return this._iosAppId;
+    }
+    _theme;
+    get theme() {
+        return this._theme;
+    }
+    /**
+     * Метод, проверяющий, можно ли использовать нативную функциональность в текущей версии приложения.
+     *
+     * @param feature Название функциональности, которую нужно проверить.
+     */
+    canUseNativeFeature(feature) {
+        const { fromVersion } = nativeFeaturesFromVersion[this.environment][feature];
+        return this.isCurrentVersionHigherOrEqual(fromVersion);
+    }
+    /**
+     * Метод, отправляющий сигнал нативу, что нужно закрыть текущее вебвью.
+     */
+    // eslint-disable-next-line class-methods-use-this
+    closeWebview() {
+        const originalPageUrl = new URL(window.location.href);
+        originalPageUrl.searchParams.set(CLOSE_WEBVIEW_SEARCH_KEY, CLOSE_WEBVIEW_SEARCH_VALUE);
+        window.location.href = originalPageUrl.toString();
+    }
+    /**
+     * Сравнивает текущую версию приложения с переданной.
+     *
+     * @param versionToCompare Версия, с которой нужно сравнить текущую.
+     * @returns `true` – текущая версия больше или равняется переданной,
+     *  `false` – текущая версия ниже.
+     */
+    isCurrentVersionHigherOrEqual(versionToCompare) {
+        if (!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;
+    }
+    checkAndroidAllowOpenInNewWebview() {
+        const comparisonResult = this.isCurrentVersionHigherOrEqual(START_VERSION_ANDROID_ALLOW_OPEN_NEW_WEBVIEW);
+        return this.environment === 'android' && comparisonResult;
+    }
+    /**
+     * Сохраняет текущее состояние 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(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(versionToIosAppId);
+        const rightKey = [...keys].reverse().find((version) => this.isCurrentVersionHigherOrEqual(version)) ||
+            keys[0];
+        return atob(versionToIosAppId[rightKey]);
+    }
+    /**
+     * Восстанавливает свое предыдущее состояние из sessionStorage
+     */
+    restorePreviousState() {
+        const previousState = JSON.parse(sessionStorage.getItem(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 NativeNavigationAndTitle(this, previousState.nextPageId, '', this._handleRedirect);
+        sessionStorage.removeItem(PREVIOUS_B2N_STATE_STORAGE_KEY);
+    }
+}

package/esm/constants.d.ts

@@ -0,0 +1,15 @@
+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";
+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;
+export declare const DEEP_LINK_PATTERN: RegExp;

package/esm/constants.js

@@ -0,0 +1,27 @@
+export const START_VERSION_ANDROID_ALLOW_OPEN_NEW_WEBVIEW = '10.35.0';
+export const ANDROID_APP_ID = 'YWxmYWJhbms=';
+export const CLOSE_WEBVIEW_SEARCH_KEY = 'closeWebView';
+export const CLOSE_WEBVIEW_SEARCH_VALUE = 'true';
+export const PREVIOUS_B2N_STATE_STORAGE_KEY = 'previousBridgeToNativeState';
+export const PREVIOUS_NATIVE_NAVIGATION_AND_TITLE_STATE_STORAGE_KEY = 'previousNativeNavigationAndTitleState';
+export const versionToIosAppId = {
+    '0.0.0': 'YWxmYWJhbms=',
+    '12.22.0': 'YWNvbmNpZXJnZQ==',
+    '12.26.0': 'a2l0dHljYXNo',
+    '12.31.0': 'YXdlYXNzaXN0',
+};
+export const nativeFeaturesFromVersion = {
+    android: {
+        linksInBrowser: {
+            fromVersion: '11.71.0',
+        },
+        geolocation: { fromVersion: '11.71.0' },
+    },
+    ios: {
+        linksInBrowser: {
+            fromVersion: '13.3.0',
+        },
+        geolocation: { fromVersion: '0.0.0' },
+    },
+};
+export const DEEP_LINK_PATTERN = /^(\/|\x61\x6c\x66\x61\x62\x61\x6e\x6b:\/{3}dashboard\/|\x61\x6c\x66\x61\x62\x61\x6e\x6b:\/{3}|\x61\x6c\x66\x61\x62\x61\x6e\x6b:\/{2}|https:\/{2}\x6f\x6e\x6c\x69\x6e\x65\x2e\x61\x6c\x66\x61\x62\x61\x6e\x6b\x2e\x72\x75\/)/;

package/esm/index.d.ts

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

package/esm/index.js

@@ -0,0 +1 @@
+export { BridgeToNative } from './bridge-to-native';

package/esm/native-fallbacks.d.ts

@@ -0,0 +1,64 @@
+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/esm/native-fallbacks.js

@@ -0,0 +1,119 @@
+import { getAppId, getUrlInstance } from './utils';
+/**
+ * Класс содержит реализацию обходных путей для веб-фич, которые не работают в нативном-вебвью.
+ */
+export class NativeFallbacks {
+    b2n;
+    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 = getUrlInstance(link);
+        const appId = 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?.onClick,
+            };
+        }
+        return {
+            href: url.href,
+            onClick: () => {
+                onClick?.();
+                this.b2n.nativeNavigationAndTitle?.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) {
+        const url = getUrlInstance(link);
+        const appId = 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 {
+            this.b2n.nativeNavigationAndTitle?.setInitialView('');
+            window.location.replace(url.href);
+        }
+    }
+}

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

@@ -0,0 +1,147 @@
+import { HandleRedirect } from './types';
+import { BridgeToNative } from './bridge-to-native';
+/**
+ * Класс, отвечающий за взаимодействие с нативными элементами в приложении – заголовком и нативной кнопкой назад.
+ */
+export declare class NativeNavigationAndTitle {
+    private b2n;
+    private nativeHistoryStack;
+    private numOfBackSteps;
+    private lastSetPageSettingsParams;
+    private readonly _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 Путь для перехода на функциональность внутри приложения.
+     * @param historyState (https://developer.mozilla.org/en-US/docs/Web/API/History/state) для новой записи в истории.
+     */
+    handleRedirect(path: string, historyState?: Record<string, unknown>): 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`.
+     * @param historyState (https://developer.mozilla.org/en-US/docs/Web/API/History/state) для новой записи в истории.
+     */
+    handleRedirect(pageTitle: string, appName: string, path?: string, params?: Record<string, string>, historyState?: Record<string, unknown>): 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;
+    /**
+     * Безопасный способ для перезагрузки страницы.
+     */
+    pseudoReloadPage(): void;
+    /**
+     * Вызывает обработчик deeplinks в нативе (АМ) и передает туда переданный deeplink.
+     * На Android текущее webview будет закрыто из-за технических особенностей.
+     * На IOS нативная фича открывается в следующем по стеку экране и при выходе из нее пользователь вернется обратно в webview.
+     * На IOS есть возможность закрыть webview перед открытием нативной фичи, передав второй параметр closeIOSWebviewBeforeCallNativeDeeplinkHandler = true
+     * @param deeplink диплинк на нативную АМ фичу в AM
+     * @param [closeIOSWebviewBeforeCallNativeDeeplinkHandler = false] закрыть текущее webview после открытия нативной фичи (применимо только для IOS на Android по техническим причинам webview всегда будет закрываться)
+     */
+    handleNativeDeeplink(deeplink: string, closeIOSWebviewBeforeCallNativeDeeplinkHandler?: boolean): 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/esm/native-navigation-and-title.js

@@ -0,0 +1,326 @@
+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

@@ -0,0 +1,39 @@
+export declare type NativeParams = {
+    appVersion: string;
+    title?: string;
+    iosAppId?: string;
+    theme: string;
+    nextPageId: number | null;
+    originalWebviewParams: string;
+};
+export declare type NativeFeatureKey = 'geolocation' | 'linksInBrowser';
+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

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

package/esm/utils.d.ts

@@ -0,0 +1,23 @@
+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

@@ -0,0 +1,62 @@
+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/package.json

@@ -1,11 +1,27 @@
 {
     "license": "UNLICENSED",
     "name": "@alfalab/bridge-to-native",
-    "version": "0.0.13",
+    "version": "0.1.0",
     "repository": {
         "type": "git",
         "url": "git+https://github.com/core-ds/bridge-to-native.git"
     },
+    "main": "./index.js",
+    "module": "./esm/index.js",
+    "exports": {
+        ".": {
+            "import": "./esm/index.js",
+            "require": "./index.js"
+        },
+        "./*": {
+            "import": "./esm/*",
+            "require": "./*"
+        }
+    },
+    "sideEffects": false,
+    "files": [
+        "*"
+    ],
     "bugs": {
         "url": "https://github.com/core-ds/bridge-to-native/issues"
     },
@@ -13,18 +29,19 @@
     "scripts": {
         "build": "yarn compile",
         "changelog": "bash bin/fill-changelog-file-and-notify-github.sh",
-        "compile": "yarn compile:clean && yarn compile:ts && yarn compile:copy-resources",
+        "compile": "yarn compile:clean && yarn compile:ts && yarn compile:ts:esm && 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\" -u 1 \"src/**/*\" .publish",
         "compile:clean": "shx rm -rf .publish",
         "compile:ts": "tsc --project tsconfig.build.json",
+        "compile:ts:esm": "tsc --project tsconfig.build.esm.json",
         "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"
+        "release": "yarn build && npm version \"$VERSION\" --no-git-tag-version && yarn compile:copy-package-json && yarn pub"
     },
     "dependencies": {},
     "devDependencies": {