@alfalab/bridge-to-native 0.2.2 → 1.0.0

package/query-and-headers-keys.js

@@ -0,0 +1,45 @@
+"use strict";
+/*
+ * Ключи стандартных заголовков.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK = exports.QUERY_NATIVE_THEME = exports.QUERY_NATIVE_IOS_APPVERSION = exports.QUERY_NATIVE_IOS_APPID = exports.QUERY_B2N_TITLE_DEPRECATED = exports.QUERY_B2N_TITLE = exports.QUERY_B2N_NEXT_PAGEID = exports.HEADER_KEY_NATIVE_APPVERSION = exports.COOKIE_KEY_BRIDGE_TO_NATIVE_DATA = exports.HEADER_KEY_USER_AGENT = exports.HEADER_KEY_COOKIE = void 0;
+exports.HEADER_KEY_COOKIE = 'cookie';
+exports.HEADER_KEY_USER_AGENT = 'user-agent';
+/*
+ * Ключи заголовков и query-параметров, которые использует B2N.
+ */
+// Ключ cookie, с помощью которого серверная часть B2N передаст на клиент информацию об NA.
+exports.COOKIE_KEY_BRIDGE_TO_NATIVE_DATA = 'bridgeToNativeData';
+// Нативное приложение на обеих платформах подмешивает этот заголовок к запросу за HTML.
+// TODO:
+// * Исследовать, делает ли оно это при запросах к прочим ресурсам;
+// * Есть подозрение на некоторую нестабильность — возможно делает это
+//  только для первого документа в вебвью-сессии. Исследовать.
+exports.HEADER_KEY_NATIVE_APPVERSION = 'app-version';
+// Флаг, предписывающий клиентскому коду B2N начать связь
+// с нативным приложением с указанного в этом параметре id, а не с 1.
+// Необходимо для server-side навигации.
+exports.QUERY_B2N_NEXT_PAGEID = 'b2n-next-page-id';
+// Query-параметр, с помощью которого можно передать начальное значение
+// для нативного заголовка — в область, которую не рендерит веб.
+exports.QUERY_B2N_TITLE = 'b2n-title';
+// Deprecated вариант query-параметра 'b2n-title'
+// (т.к. `title` часто может использоваться самим веб-приложением).
+// Игнорируется, если указан 'b2n-title'.
+exports.QUERY_B2N_TITLE_DEPRECATED = 'title';
+// NA на iOS приложение передаёт в этом параметре схему,
+// под которым оно зарегистрировано в OS.
+// Известные проблемы:
+// * В старых версиях отсутствует, клиентский код использует хардкод (см. `src/client/constants.ts`);
+// * В тестовых сборках часто нарушена связь!!! Между фактической схемой
+//  и схемой, которая приходит в этом параметре.
+//  Нужно просить iOS разработчика собрать сборку нормально.
+exports.QUERY_NATIVE_IOS_APPID = 'applicationId';
+// NA на iOS приложение передаёт в этом параметре свою версию.
+exports.QUERY_NATIVE_IOS_APPVERSION = 'device_app_version';
+// NA на обеих платформах в этом параметре передаёт активную тему (светлая/тёмная).
+exports.QUERY_NATIVE_THEME = 'theme';
+// Ключ sesseionStorage, с помощью которого клиентская часть B2N сохраняет своё состояние
+// при server-side навигации.
+exports.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK = 'bridgeToNativeHistoryStack';

package/server/extract-native-service-queries.d.ts

@@ -0,0 +1,9 @@
+import { type UniversalRequest } from './types';
+/**
+ * Извлекает из запроса все сервисные query-параметры, которые нативное приложение подмешивает в URL.
+ * И возвращает query-строку, состоящую только их них.
+ *
+ * @param request Объект запроса (Request или IncomingMessage).
+ * @return Строка, состоящая только из найденных сервисных query-параметров в формате: "title=Title&theme=dark...".
+ */
+export declare function extractNativeServiceQueries(request: UniversalRequest): string;

package/server/extract-native-service-queries.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractNativeServiceQueries = extractNativeServiceQueries;
+const utils_1 = require("./utils");
+// Словарь всех известных на данный момент сервисных query-параметров,
+// которые нативное приложение подмешивает в URL.
+const nativeServiceQueryKeys = [
+    'applicationId',
+    'client_id',
+    'device_app_id',
+    'device_app_version',
+    'device_boot_time',
+    'device_id',
+    'device_locale',
+    'device_model',
+    'device_name',
+    'device_os_version',
+    'device_timezone',
+    'device_uuid',
+    'paySupported',
+    'scope',
+    'theme',
+];
+/**
+ * Извлекает из запроса все сервисные query-параметры, которые нативное приложение подмешивает в URL.
+ * И возвращает query-строку, состоящую только их них.
+ *
+ * @param request Объект запроса (Request или IncomingMessage).
+ * @return Строка, состоящая только из найденных сервисных query-параметров в формате: "title=Title&theme=dark...".
+ */
+function extractNativeServiceQueries(request) {
+    const serviceQueryValues = (0, utils_1.getQueryValues)(request, nativeServiceQueryKeys);
+    const foundQueries = new URLSearchParams();
+    serviceQueryValues.forEach((value, i) => {
+        const key = nativeServiceQueryKeys[i];
+        if (value) {
+            foundQueries.set(key, value);
+        }
+    });
+    return foundQueries.toString();
+}

package/server/index.d.ts

@@ -0,0 +1,2 @@
+export { isWebviewEnv } from './is-webview-env';
+export { prepareNativeAppDetailsForClient } from './prepare-native-app-details-for-client';

package/server/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareNativeAppDetailsForClient = exports.isWebviewEnv = void 0;
+var is_webview_env_1 = require("./is-webview-env");
+Object.defineProperty(exports, "isWebviewEnv", { enumerable: true, get: function () { return is_webview_env_1.isWebviewEnv; } });
+var prepare_native_app_details_for_client_1 = require("./prepare-native-app-details-for-client");
+Object.defineProperty(exports, "prepareNativeAppDetailsForClient", { enumerable: true, get: function () { return prepare_native_app_details_for_client_1.prepareNativeAppDetailsForClient; } });

package/server/is-webview-env.d.ts

@@ -0,0 +1,7 @@
+import { type UniversalRequest } from './types';
+/**
+ * На основе объекта запроса любого типа определяет, сделан ли запрос из вебвью.
+ *
+ * @param request Объект запроса (Request или IncomingMessage).
+ */
+export declare function isWebviewEnv(request: UniversalRequest): boolean;

package/server/is-webview-env.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isWebviewEnv = isWebviewEnv;
+const query_and_headers_keys_1 = require("../query-and-headers-keys");
+const regexp_patterns_1 = require("./regexp-patterns");
+const utils_1 = require("./utils");
+/**
+ * На основе объекта запроса любого типа определяет, сделан ли запрос из вебвью.
+ *
+ * @param request Объект запроса (Request или IncomingMessage).
+ */
+function isWebviewEnv(request) {
+    // Выставленная ранее кука — однозначный индикатор вебвью окружения.
+    if ((0, utils_1.hasBridgeToNativeDataCookie)(request)) {
+        return true;
+    }
+    const appVersion = (0, utils_1.getHeaderValue)(request, query_and_headers_keys_1.HEADER_KEY_NATIVE_APPVERSION);
+    // `app-version` в заголовках — основной индикатор запроса из вебвью.
+    if (appVersion && regexp_patterns_1.versionPattern.test(appVersion)) {
+        return true;
+    }
+    const userAgent = (0, utils_1.getHeaderValue)(request, query_and_headers_keys_1.HEADER_KEY_USER_AGENT);
+    // Проверка «на всякий случай» для iOS — нет уверенности,
+    // что `app-version` стабильно и на всех версиях есть во всех запросах из вебвью.
+    if (userAgent && regexp_patterns_1.webviewUaIOSPattern.test(userAgent)) {
+        return true;
+    }
+    return false;
+}

package/server/prepare-native-app-details-for-client.d.ts

@@ -0,0 +1,13 @@
+import { type UniversalRequest } from './types';
+/**
+ * Парсит запрос, доставая из него данные о нативном приложении,
+ * которое подмешивает их туда.
+ * Собранные данные о нативном приложении помещаются в не-HttpOnly куку
+ * для дальнейшего использования клиентским кодом bridge2native.
+ *
+ * @param request Объект запроса (Request или IncomingMessage).
+ * @param setResponseHeader Функция для добавления заголовка ответа.
+ *  Нужно передать функцию, которая средствами используемого веб-сервера добавит заголовок в ответ.
+ *  b2native с её помощью добавит `Set-Cookie` заголовок с некоторыми данными для своего клиентского кода.
+ */
+export declare function prepareNativeAppDetailsForClient(request: UniversalRequest, setResponseHeader: (headerKey: string, headerValue: string) => void): void;

package/server/prepare-native-app-details-for-client.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareNativeAppDetailsForClient = prepareNativeAppDetailsForClient;
+const query_and_headers_keys_1 = require("../query-and-headers-keys");
+const extract_native_service_queries_1 = require("./extract-native-service-queries");
+const regexp_patterns_1 = require("./regexp-patterns");
+const utils_1 = require("./utils");
+/**
+ * Парсит запрос, доставая из него данные о нативном приложении,
+ * которое подмешивает их туда.
+ * Собранные данные о нативном приложении помещаются в не-HttpOnly куку
+ * для дальнейшего использования клиентским кодом bridge2native.
+ *
+ * @param request Объект запроса (Request или IncomingMessage).
+ * @param setResponseHeader Функция для добавления заголовка ответа.
+ *  Нужно передать функцию, которая средствами используемого веб-сервера добавит заголовок в ответ.
+ *  b2native с её помощью добавит `Set-Cookie` заголовок с некоторыми данными для своего клиентского кода.
+ */
+function prepareNativeAppDetailsForClient(request, setResponseHeader) {
+    // Если кука с данными о нативном приложении уже есть, информация уже собрана,
+    // делать больше ничего не нужно.
+    // Возможна смена темы нативного приложения (светлая/тёмная) во время вебвью-сессии.
+    // Но веб об этом не узнает, т.к. нативное приложение сообщает об этом
+    // только при старте нового вебвью.
+    if ((0, utils_1.hasBridgeToNativeDataCookie)(request)) {
+        return;
+    }
+    const nativeParams = parseRequest(request);
+    const serializedNativeParams = encodeURIComponent(JSON.stringify(nativeParams));
+    setResponseHeader('Set-Cookie', `${query_and_headers_keys_1.COOKIE_KEY_BRIDGE_TO_NATIVE_DATA}=${serializedNativeParams}`);
+}
+function parseRequest(request) {
+    // Прихраним «сервисные» query-параметры от нативного приложения,
+    // чтобы подмешать их к URL при переходе в другое веб-приложение
+    // в рамках одной вебвью-сессии.
+    const originalWebviewParams = (0, extract_native_service_queries_1.extractNativeServiceQueries)(request);
+    // Чтобы понять, как парсится запрос, см. описания констант в `src/server/constants.ts`
+    const [nextPageId, iosAppIdQuery, iosAppVersionQuery, theme, title, deprecatedTitle] = (0, utils_1.getQueryValues)(request, [
+        query_and_headers_keys_1.QUERY_B2N_NEXT_PAGEID,
+        query_and_headers_keys_1.QUERY_NATIVE_IOS_APPID,
+        query_and_headers_keys_1.QUERY_NATIVE_IOS_APPVERSION,
+        query_and_headers_keys_1.QUERY_NATIVE_THEME,
+        query_and_headers_keys_1.QUERY_B2N_TITLE,
+        query_and_headers_keys_1.QUERY_B2N_TITLE_DEPRECATED,
+    ]);
+    const appVersionFromHeaders = (0, utils_1.getHeaderValue)(request, query_and_headers_keys_1.HEADER_KEY_NATIVE_APPVERSION);
+    const nativeParams = {
+        originalWebviewParams,
+        theme: theme || 'light',
+    };
+    if (Number(nextPageId) > 1) {
+        nativeParams.nextPageId = Number(nextPageId);
+    }
+    if (iosAppIdQuery && regexp_patterns_1.iosAppIdPattern.test(iosAppIdQuery)) {
+        const [, appIdSubsting] = iosAppIdQuery.match(regexp_patterns_1.iosAppIdPattern); // кастинг ок — в условии блока регулярка проверена
+        nativeParams.iosAppId = appIdSubsting;
+    }
+    if (iosAppVersionQuery && regexp_patterns_1.versionPattern.test(iosAppVersionQuery)) {
+        nativeParams.appVersion = iosAppVersionQuery;
+    }
+    else if (appVersionFromHeaders && regexp_patterns_1.versionPattern.test(appVersionFromHeaders)) {
+        const [, versionSubstring] = appVersionFromHeaders.match(regexp_patterns_1.versionPattern); // кастинг ок — в условии блока регулярка проверена
+        nativeParams.appVersion = versionSubstring;
+    }
+    else {
+        nativeParams.appVersion = '0.0.0';
+    }
+    // Здесь такая проверка сделана намеренно, чтобы можно было задать пустой заголовок с помощью пустой строки:
+    // http://example.com?b2n-title=    →   title === ''
+    // http://example.com               →   title === null
+    if (typeof title === 'string') {
+        nativeParams.title = title;
+    }
+    else if (typeof deprecatedTitle === 'string') {
+        nativeParams.title = deprecatedTitle;
+    }
+    return nativeParams;
+}

package/server/regexp-patterns.d.ts

@@ -0,0 +1,4 @@
+export declare const bridgeToNativeDataCookieExistencePattern: RegExp;
+export declare const iosAppIdPattern: RegExp;
+export declare const versionPattern: RegExp;
+export declare const webviewUaIOSPattern: RegExp;

package/server/regexp-patterns.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.webviewUaIOSPattern = exports.versionPattern = exports.iosAppIdPattern = exports.bridgeToNativeDataCookieExistencePattern = void 0;
+const query_and_headers_keys_1 = require("../query-and-headers-keys");
+// Проверка, согласно спецификации https://httpwg.org/specs/rfc6265.html#cookie
+exports.bridgeToNativeDataCookieExistencePattern = new RegExp(`^(.+;\\s?)?${query_and_headers_keys_1.COOKIE_KEY_BRIDGE_TO_NATIVE_DATA}=`);
+exports.iosAppIdPattern = /^com\.([a-z]+)\.app$/;
+// Вебвью Android приписывает после версии тип билда, например `feature`. Нам эта информация не нужна.
+exports.versionPattern = /^(\d+\.\d+\.\d+)(\s.+)?$/;
+exports.webviewUaIOSPattern = /WebView|(iPhone|iPod|iPad)(?!.*Safari)/i;

package/server/types.d.ts

@@ -0,0 +1,2 @@
+import { type IncomingMessage } from 'http';
+export type UniversalRequest = IncomingMessage | Request;

package/server/types.js

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

package/server/utils.d.ts

@@ -0,0 +1,24 @@
+import { type UniversalRequest } from './types';
+/**
+ * На основе объекта запроса любого типа возвращает
+ * значение заголовка по заданному ключу.
+ *
+ * @param request Объект запроса (Request или IncomingMessage).
+ * @param headerKey Ключ заголовка, значение которого нужно получить.
+ */
+export declare function getHeaderValue(request: UniversalRequest, headerKey: string): string | null;
+/**
+ * На основе объекта запроса любого типа возвращает
+ * значение query-параметра(ов) по ключу(ам).
+ *
+ * @param request Объект запроса (Request или IncomingMessage).
+ * @param queryKeys Ключ(и) query-параметра(ов), значение(я) которого(ых) нужно получить.
+ */
+export declare function getQueryValues(request: UniversalRequest, queryKeys: string): string | null;
+export declare function getQueryValues(request: UniversalRequest, queryKeys: string[]): Array<string | null>;
+/**
+ * Проверяет наличие в запросе bridgeToNativeData куки.
+ *
+ * @param request Объект запроса (Request или IncomingMessage).
+ */
+export declare function hasBridgeToNativeDataCookie(request: UniversalRequest): boolean;

package/server/utils.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHeaderValue = getHeaderValue;
+exports.getQueryValues = getQueryValues;
+exports.hasBridgeToNativeDataCookie = hasBridgeToNativeDataCookie;
+const query_and_headers_keys_1 = require("../query-and-headers-keys");
+const regexp_patterns_1 = require("./regexp-patterns");
+/**
+ * На основе объекта запроса любого типа возвращает
+ * значение заголовка по заданному ключу.
+ *
+ * @param request Объект запроса (Request или IncomingMessage).
+ * @param headerKey Ключ заголовка, значение которого нужно получить.
+ */
+function getHeaderValue(request, headerKey) {
+    if (request.headers instanceof Headers) {
+        return request.headers.get(headerKey);
+    }
+    const headerValue = request.headers[headerKey] || null;
+    // Массив создается только для множественных `set-cookie` заголовков,
+    // что не актуально в контексте запроса из браузера.
+    // https://nodejs.org/api/http.html#messageheaders
+    return Array.isArray(headerValue) ? headerValue[0] : headerValue;
+}
+function getQueryValues(request, queryKeys) {
+    if (!request.url || request.url.indexOf('?') === -1) {
+        return Array.isArray(queryKeys) ? queryKeys.map(() => null) : null;
+    }
+    const [, queryString] = request.url.split('?');
+    const searchParams = new URLSearchParams(queryString);
+    if (Array.isArray(queryKeys)) {
+        return queryKeys.map((key) => searchParams.get(key));
+    }
+    return searchParams.get(queryKeys);
+}
+/**
+ * Проверяет наличие в запросе bridgeToNativeData куки.
+ *
+ * @param request Объект запроса (Request или IncomingMessage).
+ */
+function hasBridgeToNativeDataCookie(request) {
+    const cookies = getHeaderValue(request, query_and_headers_keys_1.HEADER_KEY_COOKIE);
+    return Boolean(cookies && regexp_patterns_1.bridgeToNativeDataCookieExistencePattern.test(cookies));
+}

package/types.d.ts

@@ -1,4 +1,4 @@
-export declare type NativeParams = {
+export type NativeParams = {
     appVersion: string;
     title?: string;
     iosAppId?: string;
@@ -6,34 +6,3 @@ export declare type NativeParams = {
     nextPageId: number | null;
     originalWebviewParams: string;
 };
-export declare type NativeFeatureKey = 'geolocation' | 'linksInBrowser' | 'savedBackStack';
-declare type NativeFeaturesParams = Readonly<Record<NativeFeatureKey, {
-    fromVersion: string;
-}>>;
-export declare type NativeFeaturesFromVersion = Readonly<{
-    android: NativeFeaturesParams;
-    ios: NativeFeaturesParams;
-}>;
-export declare type Environment = 'android' | 'ios';
-export declare type WebViewWindow = Window & {
-    Android?: {
-        setPageSettings: (params: string) => void;
-    };
-    handleRedirect?: (appName: string, path?: string, params?: Record<string, string>) => VoidFunction;
-};
-export declare type PdfType = 'pdfFile' | 'base64' | 'binary';
-export declare type PreviousBridgeToNativeState = Omit<NativeParams, 'title' | 'theme'> & {
-    theme: 'dark' | 'light';
-};
-export declare type PreviousNativeNavigationAndTitleState = {
-    nativeHistoryStack: string[];
-    title: string;
-};
-export declare type SyncPurpose = 'initialization' | 'navigation' | 'title-replacing';
-export declare type HandleRedirect = (appName: string, path?: string, params?: Record<string, string>, historyState?: Record<string, unknown>) => void;
-export declare type Theme = 'light' | 'dark';
-export declare type ExternalNavigationOptions = {
-    onClick?: () => void;
-    forceOpenInWebview?: boolean;
-};
-export {};

package/bridge-to-native.d.ts

@@ -1,63 +0,0 @@
-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/bridge-to-native.js

@@ -1,147 +0,0 @@
-"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(handleRedirect, blankPagePath, nativeParams) {
-        // 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._handleRedirect = handleRedirect;
-            this.restorePreviousState();
-            this.nativeFallbacks = new native_fallbacks_1.NativeFallbacks(this);
-            this._blankPagePath = blankPagePath;
-            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);
-        this._blankPagePath = blankPagePath;
-    }
-    get nativeNavigationAndTitle() {
-        return this._nativeNavigationAndTitle;
-    }
-    get originalWebviewParams() {
-        return this._originalWebviewParams;
-    }
-    get appVersion() {
-        return this._appVersion;
-    }
-    get iosAppId() {
-        return this._iosAppId;
-    }
-    get theme() {
-        return this._theme;
-    }
-    /**
-     * Метод, проверяющий, можно ли использовать нативную функциональность в текущей версии приложения.
-     *
-     * @param feature Название функциональности, которую нужно проверить.
-     */
-    canUseNativeFeature(feature) {
-        const { fromVersion } = constants_1.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(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;
-    }
-    checkAndroidAllowOpenInNewWebview() {
-        const comparisonResult = this.isCurrentVersionHigherOrEqual(constants_1.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(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/constants.d.ts

@@ -1,15 +0,0 @@
-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/constants.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEEP_LINK_PATTERN = exports.nativeFeaturesFromVersion = exports.versionToIosAppId = exports.PREVIOUS_NATIVE_NAVIGATION_AND_TITLE_STATE_STORAGE_KEY = exports.PREVIOUS_B2N_STATE_STORAGE_KEY = exports.CLOSE_WEBVIEW_SEARCH_VALUE = exports.CLOSE_WEBVIEW_SEARCH_KEY = exports.ANDROID_APP_ID = exports.START_VERSION_ANDROID_ALLOW_OPEN_NEW_WEBVIEW = void 0;
-exports.START_VERSION_ANDROID_ALLOW_OPEN_NEW_WEBVIEW = '10.35.0';
-exports.ANDROID_APP_ID = 'YWxmYWJhbms=';
-exports.CLOSE_WEBVIEW_SEARCH_KEY = 'closeWebView';
-exports.CLOSE_WEBVIEW_SEARCH_VALUE = 'true';
-exports.PREVIOUS_B2N_STATE_STORAGE_KEY = 'previousBridgeToNativeState';
-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: {
-            fromVersion: '11.71.0',
-        },
-        geolocation: { fromVersion: '11.71.0' },
-        savedBackStack: { fromVersion: '12.30.0' },
-    },
-    ios: {
-        linksInBrowser: {
-            fromVersion: '13.3.0',
-        },
-        geolocation: { fromVersion: '0.0.0' },
-        savedBackStack: { fromVersion: '0.0.0' }
-    },
-};
-exports.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\/)/;