@alfalab/bridge-to-native 0.2.1 → 1.0.0

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

@@ -0,0 +1,220 @@
+ 
+import { type BrowserHistoryApiWrappers, type HistoryPushStateParams, type LocationAssignParam, type LogError, type NativeFeatureKey, type PdfType } from './types';
+/**
+ * Сервис, предоставляет методы для WA, работающего внутри NA.
+ */
+export declare class BridgeToNative {
+    private options?;
+    /**
+     * @param options.browserHistoryApiWrappers Объект с методами,
+     *  которые вызовут методы обертки (например из react-router) над
+     *  [History](https://developer.mozilla.org/en-US/docs/Web/API/History),
+     *  если ваше WA такие использует. Если аргумент не передать,
+     *  будут использованы стандартные `History: pushState()` и `History: go()`.
+     * @param options.logError Функция с помощью которой B2N может залогировать ошибку,
+     *  если не передать, B2N не будет логировать ошибки.
+     */
+    constructor(options?: {
+        browserHistoryApiWrappers?: BrowserHistoryApiWrappers;
+        logError?: LogError;
+    } | undefined);
+    private nativeParamsService;
+    private externalLinksService;
+    private nativeNavigationAndTitleService;
+    /**
+     * Схема NA.
+     */
+    get appId(): string;
+    /**
+     * Версия NA.
+     */
+    get appVersion(): string;
+    /**
+     * Платформа, в окружении которой работает NA и WA.
+     */
+    get environment(): import("./types").Environment;
+    /**
+     * Индикатор проблемы чтения данных о NA. Если `true`, используются умолчания,
+     * возможно ошибочные (например, версия будет `0.0.0`).
+     */
+    get wasNativeParamsDataFailedToRead(): boolean;
+    /**
+     * Сохранённые query-параметры, которыми NA обогощает URL при открытии WV.
+     */
+    get originalWebviewParams(): string | null;
+    /**
+     * Тема (светлая/тёмная), в котором работает NA.
+     */
+    get theme(): import("./types").Theme;
+    /**
+     * Метод, проверяющий, можно ли использовать ли указанную функциональность
+     * в текущей версии NA.
+     *
+     * @param feature Ключ (ID) функциональности, которую нужно проверить.
+     * @returns Результат проверки.
+     */
+    canUseNativeFeature(feature: NativeFeatureKey): boolean;
+    /**
+     * Метод, отправляющий сигнал NA, что нужно закрыть текущее WV.
+     */
+    closeWebview(): void;
+    /**
+     * Модифицирует ссылку таким образом, чтобы NA открыл её в браузере.
+     *
+     * ВАЖНО!
+     * В ранних версиях NA в браузере ссылку открыть НЕВОЗМОЖНО!
+     * В таких версиях в качестве фолбэка этот метод вернет диплинк, открывающий
+     * ресурс в новом WV.
+     * Версии, с которых можно открыть ссылку в браузере:
+     * Android  11.71.0
+     * iOS      13.3.0
+     *
+     * @param link Абсолютная ссылка со всеми компонентами (включая протокол).
+     * @returns Модифицированная ссылка для открытия в браузере или диплинк, открывающий
+     *  ресурс в новом WV.
+     */
+    getHrefToOpenInBrowser(link: string): string;
+    /**
+     * Делает один шаг назад по браузерной истории и модифицирует внутреннее состояние B2N,
+     * чтобы в дальнейшем зарегистрировать этот переход в NA.
+     *
+     * Метод автоматически закрывает WV, если отсутствуют записи в истории переходов B2N.
+     */
+    goBack(): void;
+    /**
+     * Делает несколько шагов назад по браузерной истории и модифицирует внутреннее состояние,
+     * чтобы в дальнейшем зарегистрировать этот переход в NA.
+     *
+     * ВАЖНО!
+     * Метод можно использовать только в рамках истории по SPA WA! Движение назад
+     * server-side переходом на несколько шагов не поддерживается.
+     *
+     * Снять это ограничение возможно, но нужны доработки.
+     *
+     * @param stepsNumber Количество шагов назад.
+     *  Возможно передача как положительного, так и отрицательного числа. `0` будет проигнорирован.
+     * @param autoCloseWebview Флаг — закрывать ли WV автоматически,
+     *  если переданное кол-во шагов будет больше, чем записей в истории.
+     */
+    goBackAFewStepsClientSide(stepsNumber: number, autoCloseWebview?: boolean): void;
+    /**
+     * Вызывает обработчик диплинков NA для обработки переданного диплинка.
+     *
+     * Если диплинк приводит к открытию нового экрана, он открывается «поверх» текущего WV.
+     * При выходе из нового экрана, пользователь возвращается обратно в WV.
+     *
+     * ВАЖНО!
+     * В NA на Android до версии `12.30.0` текущее WV закрывается при открытии нового экрана,
+     * поэтому в закрытое WV невозможно вернуться back-навигацией.
+     *
+     * @param deeplink Диплинк для передачи на обработку NA.
+     * @param closeWebviewBeforeCallNativeDeeplinkHandler Флаг принудительного закрытия текущего WV перед открытием нового экрана.
+     *  Применимо для всех версий на iOS и в новых версиях на Android (>=12.30.0), в более старых WV закрывается всегда автоматически.
+     */
+    handleNativeDeeplink(deeplink: string, closeWebviewBeforeCallNativeDeeplinkHandler?: boolean): void;
+    /**
+     * Сравнивает текущую версию приложения с переданной.
+     *
+     * @param versionToCompare Версия, с которой нужно сравнить текущую.
+     * @returns `true` – текущая версия больше или равняется переданной,
+     *  `false` – текущая версия ниже.
+     */
+    isCurrentVersionHigherOrEqual(versionToCompare: string): boolean;
+    /**
+     * Для client-side навигации необходимо воспользоваться этим методом,
+     * чтобы зарегистрировать навигацию WA в NA. В результате кнопка «Назад» в NA
+     * сработает как кнопка «Назад» в Браузере, иначе эта кнопка закрывает WV.
+     * Кол-во вызовов метода === кол-ву поведений кнопки, как «Назад» в браузере.
+     *
+     * Для сброса можно использовать метод `setInitialView`.
+     *
+     * Метод использует функцию `push` параметра `browserHistoryAbstractions`,
+     * если такой был передан в конструктор. Иначе вызывает
+     * `History: pushState()` <https://developer.mozilla.org/en-US/docs/Web/API/History/pushState>.
+     *
+     * @param url URL для перехода внутри WA client-side навигацией.
+     * @param state <https://developer.mozilla.org/en-US/docs/Web/API/History/state> для новой записи в истории.
+     * @param nativeTitle Текст заголовка, для «нативной» части WV, пустая строка — отсутствие заголовка.
+     */
+    navigateClientSide(url: HistoryPushStateParams[2], state?: HistoryPushStateParams[0], nativeTitle?: string): void;
+    /**
+     * Для seriver-side навигации необходимо воспользоваться этим методом,
+     * чтобы корректно передать информацию экземпляру B2N следующего WA или
+     * экзепляру B2N следующей страницы текущего WA (в случае multi-page application).
+     *
+     * ВАЖНО!
+     *
+     * Не поддерживаются такие сценарии:
+     *
+     * 1. Микс client-side навигации и server-side навигации в рамках одного WA.
+     *  т.е. одно WA должно использовать либо только `navigateClientSide`, либо только `navigateServerSide`.
+     * 2. Старт в WA 1 → переход к WA 2 → переход к WA 1,
+     *  т.е. при использовании server-side навигации, история переходов разных WA не должна смешиваться.
+     *
+     * Снять эти ограничения возможно, но нужны доработки.
+     *
+     * @param url URL для перехода внутри WA server-side навигацией.
+     * @param nativeTitle Текст заголовка, для «нативной» части WV, пустая строка — отсутствие заголовка.
+     */
+    navigateServerSide(url: LocationAssignParam, nativeTitle?: string): void;
+    /**
+     * Открывает переданную ссылку в браузере.
+     *
+     * ВАЖНО!
+     * В ранних версиях NA в браузере ссылку открыть НЕВОЗМОЖНО!
+     * В таких версиях в качестве фолбэка этот метод открывает ссылку в новом WV.
+     * Версии, с которых можно открыть ссылку в браузере:
+     * Android  11.71.0
+     * iOS      13.3.0
+     *
+     * @param link Абсолютная ссылка со всеми компонентами (включая протокол).
+     */
+    openInBrowser(link: string): void;
+    /**
+     * Открывает переданную ссылку в новом WV, которое открывается «поверх» текущего WV.
+     * При выходе из «нового WV», пользователь возвращается в текущее WV.
+     *
+     * ВАЖНО!
+     * В NA на Android до версии `12.30.0` текущее WV закрывается при открытии нового
+     * и в него будет невозможно вернуться back-навигацией.
+     *
+     * ВАЖНО!
+     * В NA планируют внедрить «Белые списки» URL (на основе регулярных выражений),
+     * которые разрешено открывать в WV. URL не подпадающие под «Белые списки» NA будет
+     * принудительно открывать в браузере.
+     *
+     * @param link Абсолютная ссылка со всеми компонентами (включая протокол).
+     * @param nativeTitle Текст заголовока, для «нативной» части WV, пустая строка — отсутствие заголовка.
+     * @param closeCurrentWebview Флаг принудительного закрытия текущего WV перед открытием нового вебвью.
+     *  Применимо для всех версий на iOS и в новых версиях на Android (>=12.30.0), в более старых WV закрывается всегда автоматически.
+     */
+    openInNewWebview(link: string, nativeTitle?: string, closeCurrentWebview?: boolean): void;
+    /**
+     * Метод для открытия PDF в нативном вьювере.
+     * TODO: Есть нюансы с версиями приложения, OS устройства. Надо тестировать по моде статистики.
+     *  Надо тщательно изучить вопрос и доработать реализацию.
+     *
+     * @param url Ссылка на PDF.
+     * @param type Тип PDF ссылки (игнорируется в Android окружении).
+     * @param title Название PDF файла (игнорируется в Android окружении).
+     */
+    openPdf(url: string, type?: PdfType, title?: string): void;
+    /**
+     * Для перезагрузки страницы необходимо использовать этот метод.
+     * Иначе синхронизация состояния с NA будет потеряна.
+     */
+    reload(): void;
+    /**
+     * Информирует NA, что WA находится на первом экране. Это приведёт к тому,
+     * что следующее нажатие на кнопку «Назад» в NA закроет WV.
+     *
+     * @param pageTitle Текст заголовка, для «нативной» части WV, пустая строка — отсутствие заголовка.
+     */
+    setInitialView(nativeTitle?: string): void;
+    /**
+     * Метод для смены заголовка в NA.
+     *
+     * @param nativeTitle Текст заголовка, для «нативной» части WV, пустая строка — отсутствие заголовка.
+     */
+    setTitle(nativeTitle: string): void;
+}

package/client/bridge-to-native.js

@@ -0,0 +1,267 @@
+"use strict";
+/* eslint max-lines: ["error", {"skipComments": true}] */ // Много комментариев.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BridgeToNative = void 0;
+const external_links_service_1 = require("./services-and-utils/external-links-service");
+const native_navigation_and_title_service_1 = require("./services-and-utils/native-navigation-and-title-service");
+const native_params_service_1 = require("./services-and-utils/native-params-service");
+/**
+ * Сервис, предоставляет методы для WA, работающего внутри NA.
+ */
+class BridgeToNative {
+    /**
+     * @param options.browserHistoryApiWrappers Объект с методами,
+     *  которые вызовут методы обертки (например из react-router) над
+     *  [History](https://developer.mozilla.org/en-US/docs/Web/API/History),
+     *  если ваше WA такие использует. Если аргумент не передать,
+     *  будут использованы стандартные `History: pushState()` и `History: go()`.
+     * @param options.logError Функция с помощью которой B2N может залогировать ошибку,
+     *  если не передать, B2N не будет логировать ошибки.
+     */
+    constructor(options) {
+        var _a, _b, _c;
+        this.options = options;
+        this.nativeParamsService = new native_params_service_1.NativeParamsService((_a = this.options) === null || _a === void 0 ? void 0 : _a.logError);
+        this.externalLinksService = new external_links_service_1.ExternalLinksService(this.nativeParamsService);
+        this.nativeNavigationAndTitleService = new native_navigation_and_title_service_1.NativeNavigationAndTitleService(this.nativeParamsService, (_b = this.options) === null || _b === void 0 ? void 0 : _b.browserHistoryApiWrappers, (_c = this.options) === null || _c === void 0 ? void 0 : _c.logError);
+    }
+    /**
+     * Схема NA.
+     */
+    get appId() {
+        return this.nativeParamsService.appId;
+    }
+    /**
+     * Версия NA.
+     */
+    get appVersion() {
+        return this.nativeParamsService.appVersion;
+    }
+    /**
+     * Платформа, в окружении которой работает NA и WA.
+     */
+    get environment() {
+        return this.nativeParamsService.environment;
+    }
+    /**
+     * Индикатор проблемы чтения данных о NA. Если `true`, используются умолчания,
+     * возможно ошибочные (например, версия будет `0.0.0`).
+     */
+    get wasNativeParamsDataFailedToRead() {
+        return this.nativeParamsService.nativeParamsReadErrorFlag;
+    }
+    /**
+     * Сохранённые query-параметры, которыми NA обогощает URL при открытии WV.
+     */
+    get originalWebviewParams() {
+        return this.nativeParamsService.originalWebviewParams;
+    }
+    /**
+     * Тема (светлая/тёмная), в котором работает NA.
+     */
+    get theme() {
+        return this.nativeParamsService.theme;
+    }
+    /**
+     * Метод, проверяющий, можно ли использовать ли указанную функциональность
+     * в текущей версии NA.
+     *
+     * @param feature Ключ (ID) функциональности, которую нужно проверить.
+     * @returns Результат проверки.
+     */
+    canUseNativeFeature(feature) {
+        return this.nativeParamsService.canUseNativeFeature(feature);
+    }
+    /**
+     * Метод, отправляющий сигнал NA, что нужно закрыть текущее WV.
+     */
+    closeWebview() {
+        this.nativeNavigationAndTitleService.closeWebview();
+    }
+    /**
+     * Модифицирует ссылку таким образом, чтобы NA открыл её в браузере.
+     *
+     * ВАЖНО!
+     * В ранних версиях NA в браузере ссылку открыть НЕВОЗМОЖНО!
+     * В таких версиях в качестве фолбэка этот метод вернет диплинк, открывающий
+     * ресурс в новом WV.
+     * Версии, с которых можно открыть ссылку в браузере:
+     * Android  11.71.0
+     * iOS      13.3.0
+     *
+     * @param link Абсолютная ссылка со всеми компонентами (включая протокол).
+     * @returns Модифицированная ссылка для открытия в браузере или диплинк, открывающий
+     *  ресурс в новом WV.
+     */
+    getHrefToOpenInBrowser(link) {
+        return this.externalLinksService.getHrefToOpenInBrowser(link);
+    }
+    /**
+     * Делает один шаг назад по браузерной истории и модифицирует внутреннее состояние B2N,
+     * чтобы в дальнейшем зарегистрировать этот переход в NA.
+     *
+     * Метод автоматически закрывает WV, если отсутствуют записи в истории переходов B2N.
+     */
+    goBack() {
+        this.nativeNavigationAndTitleService.goBack();
+    }
+    /**
+     * Делает несколько шагов назад по браузерной истории и модифицирует внутреннее состояние,
+     * чтобы в дальнейшем зарегистрировать этот переход в NA.
+     *
+     * ВАЖНО!
+     * Метод можно использовать только в рамках истории по SPA WA! Движение назад
+     * server-side переходом на несколько шагов не поддерживается.
+     *
+     * Снять это ограничение возможно, но нужны доработки.
+     *
+     * @param stepsNumber Количество шагов назад.
+     *  Возможно передача как положительного, так и отрицательного числа. `0` будет проигнорирован.
+     * @param autoCloseWebview Флаг — закрывать ли WV автоматически,
+     *  если переданное кол-во шагов будет больше, чем записей в истории.
+     */
+    goBackAFewStepsClientSide(stepsNumber, autoCloseWebview = false) {
+        this.nativeNavigationAndTitleService.goBackAFewStepsClientSide(stepsNumber, autoCloseWebview);
+    }
+    /**
+     * Вызывает обработчик диплинков NA для обработки переданного диплинка.
+     *
+     * Если диплинк приводит к открытию нового экрана, он открывается «поверх» текущего WV.
+     * При выходе из нового экрана, пользователь возвращается обратно в WV.
+     *
+     * ВАЖНО!
+     * В NA на Android до версии `12.30.0` текущее WV закрывается при открытии нового экрана,
+     * поэтому в закрытое WV невозможно вернуться back-навигацией.
+     *
+     * @param deeplink Диплинк для передачи на обработку NA.
+     * @param closeWebviewBeforeCallNativeDeeplinkHandler Флаг принудительного закрытия текущего WV перед открытием нового экрана.
+     *  Применимо для всех версий на iOS и в новых версиях на Android (>=12.30.0), в более старых WV закрывается всегда автоматически.
+     */
+    handleNativeDeeplink(deeplink, closeWebviewBeforeCallNativeDeeplinkHandler = false) {
+        this.externalLinksService.handleNativeDeeplink(deeplink, closeWebviewBeforeCallNativeDeeplinkHandler);
+    }
+    /**
+     * Сравнивает текущую версию приложения с переданной.
+     *
+     * @param versionToCompare Версия, с которой нужно сравнить текущую.
+     * @returns `true` – текущая версия больше или равняется переданной,
+     *  `false` – текущая версия ниже.
+     */
+    isCurrentVersionHigherOrEqual(versionToCompare) {
+        return this.nativeParamsService.isCurrentVersionHigherOrEqual(versionToCompare);
+    }
+    /**
+     * Для client-side навигации необходимо воспользоваться этим методом,
+     * чтобы зарегистрировать навигацию WA в NA. В результате кнопка «Назад» в NA
+     * сработает как кнопка «Назад» в Браузере, иначе эта кнопка закрывает WV.
+     * Кол-во вызовов метода === кол-ву поведений кнопки, как «Назад» в браузере.
+     *
+     * Для сброса можно использовать метод `setInitialView`.
+     *
+     * Метод использует функцию `push` параметра `browserHistoryAbstractions`,
+     * если такой был передан в конструктор. Иначе вызывает
+     * `History: pushState()` <https://developer.mozilla.org/en-US/docs/Web/API/History/pushState>.
+     *
+     * @param url URL для перехода внутри WA client-side навигацией.
+     * @param state <https://developer.mozilla.org/en-US/docs/Web/API/History/state> для новой записи в истории.
+     * @param nativeTitle Текст заголовка, для «нативной» части WV, пустая строка — отсутствие заголовка.
+     */
+    navigateClientSide(url, state, nativeTitle = '') {
+        this.nativeNavigationAndTitleService.navigateClientSide(url, state, nativeTitle);
+    }
+    /**
+     * Для seriver-side навигации необходимо воспользоваться этим методом,
+     * чтобы корректно передать информацию экземпляру B2N следующего WA или
+     * экзепляру B2N следующей страницы текущего WA (в случае multi-page application).
+     *
+     * ВАЖНО!
+     *
+     * Не поддерживаются такие сценарии:
+     *
+     * 1. Микс client-side навигации и server-side навигации в рамках одного WA.
+     *  т.е. одно WA должно использовать либо только `navigateClientSide`, либо только `navigateServerSide`.
+     * 2. Старт в WA 1 → переход к WA 2 → переход к WA 1,
+     *  т.е. при использовании server-side навигации, история переходов разных WA не должна смешиваться.
+     *
+     * Снять эти ограничения возможно, но нужны доработки.
+     *
+     * @param url URL для перехода внутри WA server-side навигацией.
+     * @param nativeTitle Текст заголовка, для «нативной» части WV, пустая строка — отсутствие заголовка.
+     */
+    navigateServerSide(url, nativeTitle = '') {
+        this.nativeNavigationAndTitleService.navigateServerSide(url, nativeTitle);
+    }
+    /**
+     * Открывает переданную ссылку в браузере.
+     *
+     * ВАЖНО!
+     * В ранних версиях NA в браузере ссылку открыть НЕВОЗМОЖНО!
+     * В таких версиях в качестве фолбэка этот метод открывает ссылку в новом WV.
+     * Версии, с которых можно открыть ссылку в браузере:
+     * Android  11.71.0
+     * iOS      13.3.0
+     *
+     * @param link Абсолютная ссылка со всеми компонентами (включая протокол).
+     */
+    openInBrowser(link) {
+        this.externalLinksService.openInBrowser(link);
+    }
+    /**
+     * Открывает переданную ссылку в новом WV, которое открывается «поверх» текущего WV.
+     * При выходе из «нового WV», пользователь возвращается в текущее WV.
+     *
+     * ВАЖНО!
+     * В NA на Android до версии `12.30.0` текущее WV закрывается при открытии нового
+     * и в него будет невозможно вернуться back-навигацией.
+     *
+     * ВАЖНО!
+     * В NA планируют внедрить «Белые списки» URL (на основе регулярных выражений),
+     * которые разрешено открывать в WV. URL не подпадающие под «Белые списки» NA будет
+     * принудительно открывать в браузере.
+     *
+     * @param link Абсолютная ссылка со всеми компонентами (включая протокол).
+     * @param nativeTitle Текст заголовока, для «нативной» части WV, пустая строка — отсутствие заголовка.
+     * @param closeCurrentWebview Флаг принудительного закрытия текущего WV перед открытием нового вебвью.
+     *  Применимо для всех версий на iOS и в новых версиях на Android (>=12.30.0), в более старых WV закрывается всегда автоматически.
+     */
+    openInNewWebview(link, nativeTitle = '', closeCurrentWebview = false) {
+        this.externalLinksService.openInNewWebview(link, nativeTitle, closeCurrentWebview);
+    }
+    /**
+     * Метод для открытия PDF в нативном вьювере.
+     * TODO: Есть нюансы с версиями приложения, OS устройства. Надо тестировать по моде статистики.
+     *  Надо тщательно изучить вопрос и доработать реализацию.
+     *
+     * @param url Ссылка на PDF.
+     * @param type Тип PDF ссылки (игнорируется в Android окружении).
+     * @param title Название PDF файла (игнорируется в Android окружении).
+     */
+    openPdf(url, type = 'pdfFile', title) {
+        this.externalLinksService.openPdf(url, type, title);
+    }
+    /**
+     * Для перезагрузки страницы необходимо использовать этот метод.
+     * Иначе синхронизация состояния с NA будет потеряна.
+     */
+    reload() {
+        this.nativeNavigationAndTitleService.reload();
+    }
+    /**
+     * Информирует NA, что WA находится на первом экране. Это приведёт к тому,
+     * что следующее нажатие на кнопку «Назад» в NA закроет WV.
+     *
+     * @param pageTitle Текст заголовка, для «нативной» части WV, пустая строка — отсутствие заголовка.
+     */
+    setInitialView(nativeTitle = '') {
+        this.nativeNavigationAndTitleService.setInitialView(nativeTitle);
+    }
+    /**
+     * Метод для смены заголовка в NA.
+     *
+     * @param nativeTitle Текст заголовка, для «нативной» части WV, пустая строка — отсутствие заголовка.
+     */
+    setTitle(nativeTitle) {
+        this.nativeNavigationAndTitleService.setTitle(nativeTitle);
+    }
+}
+exports.BridgeToNative = BridgeToNative;

package/client/constants.d.ts

@@ -0,0 +1,13 @@
+import { type NativeFeaturesFromVersion } from './types';
+export declare const ANDROID_APP_ID = "alfabank";
+export declare const DEEP_LINK_PATTERN: RegExp;
+export declare const NATIVE_FEATURES_FROM_VERSION: NativeFeaturesFromVersion;
+export declare const VERSION_TO_IOS_APP_ID: {
+    readonly '0.0.0': "alfabank";
+    readonly '12.22.0': "aconcierge";
+    readonly '12.26.0': "kittycash";
+    readonly '13.2.0': "triptally";
+    readonly '13.4.0': "cashline";
+    readonly '13.5.0': "assistmekz";
+    readonly '14.5.0': "smartfinancementor";
+};

package/client/constants.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION_TO_IOS_APP_ID = exports.NATIVE_FEATURES_FROM_VERSION = exports.DEEP_LINK_PATTERN = exports.ANDROID_APP_ID = void 0;
+exports.ANDROID_APP_ID = 'alfabank';
+exports.DEEP_LINK_PATTERN = /^(\/|alfabank:\/{3}dashboard\/|alfabank:\/{3}|alfabank:\/{2}|https:\/{2}online.alfabank.ru\/)/;
+exports.NATIVE_FEATURES_FROM_VERSION = {
+    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.VERSION_TO_IOS_APP_ID = {
+    '0.0.0': 'alfabank',
+    '12.22.0': 'aconcierge',
+    '12.26.0': 'kittycash',
+    '13.2.0': 'triptally',
+    '13.4.0': 'cashline',
+    '13.5.0': 'assistmekz',
+    '14.5.0': 'smartfinancementor',
+};

package/client/services-and-utils/close-webview-util.d.ts

@@ -0,0 +1 @@
+export declare const closeWebviewUtil: () => void;

package/client/services-and-utils/close-webview-util.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.closeWebviewUtil = void 0;
+const QUERY_CLOSE_WEBVIEW_KEY = 'closeWebView';
+const QUERY_CLOSE_WEBVIEW_VALUE = 'true';
+const closeWebviewUtil = () => {
+    const originalPageUrl = new URL(window.location.href);
+    originalPageUrl.searchParams.set(QUERY_CLOSE_WEBVIEW_KEY, QUERY_CLOSE_WEBVIEW_VALUE);
+    window.location.href = originalPageUrl.toString();
+};
+exports.closeWebviewUtil = closeWebviewUtil;

package/client/services-and-utils/external-links-service.d.ts

@@ -0,0 +1,15 @@
+import { type PdfType } from '../types';
+import { type NativeParamsService } from './native-params-service';
+/**
+ * Сервис, предоставляющий методы для открытия внешних для текущего WA экранов
+ * и связанных с этим действий.
+ */
+export declare class ExternalLinksService {
+    private nativeParamsService;
+    constructor(nativeParamsService: NativeParamsService);
+    handleNativeDeeplink(deeplink: string, closeWebviewBeforeCallNativeDeeplinkHandler?: boolean): void;
+    getHrefToOpenInBrowser(link: string): string;
+    openInBrowser(link: string): void;
+    openInNewWebview(link: string, nativeTitle?: string, closeCurrentWebview?: boolean): void;
+    openPdf(url: string, type?: PdfType, title?: string): void;
+}

package/client/services-and-utils/external-links-service.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExternalLinksService = void 0;
+const query_and_headers_keys_1 = require("../../query-and-headers-keys");
+const constants_1 = require("../constants");
+const close_webview_util_1 = require("./close-webview-util");
+const QUERY_OPEN_IN_BROWSER_KEY = 'openInBrowser';
+const QUERY_OPEN_IN_BROWSER_VALUE = 'true';
+/**
+ * Сервис, предоставляющий методы для открытия внешних для текущего WA экранов
+ * и связанных с этим действий.
+ */
+class ExternalLinksService {
+    constructor(nativeParamsService) {
+        this.nativeParamsService = nativeParamsService;
+    }
+    handleNativeDeeplink(deeplink, closeWebviewBeforeCallNativeDeeplinkHandler = false) {
+        const clearedDeeplinkPath = deeplink.replace(constants_1.DEEP_LINK_PATTERN, '');
+        if (closeWebviewBeforeCallNativeDeeplinkHandler &&
+            this.nativeParamsService.canUseNativeFeature('savedBackStack')) {
+            (0, close_webview_util_1.closeWebviewUtil)();
+            // Проверено, ОС получает диплинк и передаёт его NA, не смотря на то,
+            // что это происходит в следующей макрозадаче после команды на закрытие WV.
+            setTimeout(() => window.location.replace(`${this.nativeParamsService.appId}://${clearedDeeplinkPath}`), 0);
+            return;
+        }
+        window.location.replace(`${this.nativeParamsService.appId}://${clearedDeeplinkPath}`);
+    }
+    getHrefToOpenInBrowser(link) {
+        if (!this.nativeParamsService.canUseNativeFeature('linksInBrowser')) {
+            return `${this.nativeParamsService.appId}://webFeature?type=recommendation&url=${encodeURIComponent(link)}`;
+        }
+        const url = new URL(link);
+        url.searchParams.append(QUERY_OPEN_IN_BROWSER_KEY, QUERY_OPEN_IN_BROWSER_VALUE);
+        return url.href;
+    }
+    openInBrowser(link) {
+        if (!this.nativeParamsService.canUseNativeFeature('linksInBrowser')) {
+            this.openInNewWebview(link);
+            return;
+        }
+        const url = new URL(link);
+        url.searchParams.append(QUERY_OPEN_IN_BROWSER_KEY, QUERY_OPEN_IN_BROWSER_VALUE);
+        window.location.replace(url.href);
+    }
+    openInNewWebview(link, nativeTitle = '', closeCurrentWebview = false) {
+        const url = new URL(link);
+        if (nativeTitle) {
+            url.searchParams.set(query_and_headers_keys_1.QUERY_B2N_TITLE, nativeTitle);
+        }
+        this.handleNativeDeeplink(`/webFeature?type=recommendation&url=${encodeURIComponent(url.toString())}`, closeCurrentWebview);
+    }
+    openPdf(url, type = 'pdfFile', title) {
+        let replaceUrl = url;
+        if (this.nativeParamsService.environment === 'ios') {
+            const params = new URLSearchParams();
+            params.append('type', type);
+            params.append('url', decodeURIComponent(url));
+            if (title) {
+                params.append('title', title.replace(/\s/g, '_'));
+            }
+            const paramsStr = params.toString();
+            replaceUrl = `${this.nativeParamsService.appId}:///dashboard/pdf_viewer?${paramsStr}`;
+        }
+        const windowObjectReference = window.open(replaceUrl);
+        if (windowObjectReference === null) {
+            window.location.replace(replaceUrl);
+        }
+    }
+}
+exports.ExternalLinksService = ExternalLinksService;