@alfalab/bridge-to-native 1.4.2 → 1.5.1-beta.50a07d1

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

@@ -1,5 +1,5 @@
  
-import { type BrowserHistoryApiWrappers, type HistoryPushStateParams, type HistoryReplaceStateParams, type LocationAssignParam, type LogError, type NativeFeatureKey, type PdfType } from './types';
+import { type BrowserHistoryApiWrappers, type HistoryPushStateParams, type HistoryReplaceStateParams, type LocationAssignParam, type LogError, type NativeFeatureKey, type NoopOptions, type PdfType } from './types';
 /**
  * Сервис, предоставляет методы для WA, работающего внутри NA.
  */
@@ -13,12 +13,15 @@ export declare class BridgeToNative {
      *  будут использованы стандартные `History: pushState()` и `History: go()`.
      * @param options.logError Функция с помощью которой B2N может залогировать ошибку,
      *  если не передать, B2N не будет логировать ошибки.
+     * @param options.noop ....
      */
     constructor(options?: {
         browserHistoryApiWrappers?: BrowserHistoryApiWrappers;
         logError?: LogError;
+        noop?: NoopOptions;
     } | undefined);
     private nativeParamsService;
+    private nativeLogService;
     private externalLinksService;
     private nativeNavigationAndTitleService;
     /**

package/client/bridge-to-native.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BridgeToNative = void 0;
 const external_links_service_1 = require("./services-and-utils/external-links-service");
+const native_log_service_1 = require("./services-and-utils/native-log-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");
 /**
@@ -17,13 +18,15 @@ class BridgeToNative {
      *  будут использованы стандартные `History: pushState()` и `History: go()`.
      * @param options.logError Функция с помощью которой B2N может залогировать ошибку,
      *  если не передать, B2N не будет логировать ошибки.
+     * @param options.noop ....
      */
     constructor(options) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e, _f, _g;
         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, (_b = this.options) === null || _b === void 0 ? void 0 : _b.logError);
-        this.nativeNavigationAndTitleService = new native_navigation_and_title_service_1.NativeNavigationAndTitleService(this.nativeParamsService, (_c = this.options) === null || _c === void 0 ? void 0 : _c.browserHistoryApiWrappers, (_d = this.options) === null || _d === void 0 ? void 0 : _d.logError);
+        this.nativeParamsService = new native_params_service_1.NativeParamsService((_a = this.options) === null || _a === void 0 ? void 0 : _a.noop, (_b = this.options) === null || _b === void 0 ? void 0 : _b.logError);
+        this.nativeLogService = new native_log_service_1.NativeLogService(this.nativeParamsService.environment, this.nativeParamsService.appVersion, (_d = (_c = this.options) === null || _c === void 0 ? void 0 : _c.noop) === null || _d === void 0 ? void 0 : _d.enabled);
+        this.externalLinksService = new external_links_service_1.ExternalLinksService(this.nativeParamsService, this.nativeLogService, (_e = this.options) === null || _e === void 0 ? void 0 : _e.logError);
+        this.nativeNavigationAndTitleService = new native_navigation_and_title_service_1.NativeNavigationAndTitleService(this.nativeParamsService, this.nativeLogService, (_f = this.options) === null || _f === void 0 ? void 0 : _f.browserHistoryApiWrappers, (_g = this.options) === null || _g === void 0 ? void 0 : _g.logError);
     }
     /**
      * Схема NA.

package/client/index.d.ts

@@ -1 +1,3 @@
 export { BridgeToNative } from './bridge-to-native';
+export { canUseNativeFeature, isVersionHigherOrEqual, prepareNativeDeeplinkUrl, prepareOpenInBrowserUrl, prepareOpenInNewWebviewDeeplink, preparePdfUrl, } from './primitives';
+export type { Environment, NativeAppTarget, NativeFeatureKey, PdfType } from './types';

package/client/index.js

@@ -1,5 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BridgeToNative = void 0;
+exports.preparePdfUrl = exports.prepareOpenInNewWebviewDeeplink = exports.prepareOpenInBrowserUrl = exports.prepareNativeDeeplinkUrl = exports.isVersionHigherOrEqual = exports.canUseNativeFeature = exports.BridgeToNative = void 0;
 var bridge_to_native_1 = require("./bridge-to-native");
 Object.defineProperty(exports, "BridgeToNative", { enumerable: true, get: function () { return bridge_to_native_1.BridgeToNative; } });
+var primitives_1 = require("./primitives");
+Object.defineProperty(exports, "canUseNativeFeature", { enumerable: true, get: function () { return primitives_1.canUseNativeFeature; } });
+Object.defineProperty(exports, "isVersionHigherOrEqual", { enumerable: true, get: function () { return primitives_1.isVersionHigherOrEqual; } });
+Object.defineProperty(exports, "prepareNativeDeeplinkUrl", { enumerable: true, get: function () { return primitives_1.prepareNativeDeeplinkUrl; } });
+Object.defineProperty(exports, "prepareOpenInBrowserUrl", { enumerable: true, get: function () { return primitives_1.prepareOpenInBrowserUrl; } });
+Object.defineProperty(exports, "prepareOpenInNewWebviewDeeplink", { enumerable: true, get: function () { return primitives_1.prepareOpenInNewWebviewDeeplink; } });
+Object.defineProperty(exports, "preparePdfUrl", { enumerable: true, get: function () { return primitives_1.preparePdfUrl; } });

package/client/primitives.d.ts

@@ -0,0 +1,3 @@
+export { canUseNativeFeature, isVersionHigherOrEqual } from './services-and-utils/native-features';
+export { prepareNativeDeeplinkUrl, prepareOpenInBrowserUrl, prepareOpenInNewWebviewDeeplink, preparePdfUrl, } from './services-and-utils/native-links';
+export type { Environment, NativeAppTarget, NativeFeatureKey, PdfType } from './types';

package/client/primitives.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preparePdfUrl = exports.prepareOpenInNewWebviewDeeplink = exports.prepareOpenInBrowserUrl = exports.prepareNativeDeeplinkUrl = exports.isVersionHigherOrEqual = exports.canUseNativeFeature = void 0;
+var native_features_1 = require("./services-and-utils/native-features");
+Object.defineProperty(exports, "canUseNativeFeature", { enumerable: true, get: function () { return native_features_1.canUseNativeFeature; } });
+Object.defineProperty(exports, "isVersionHigherOrEqual", { enumerable: true, get: function () { return native_features_1.isVersionHigherOrEqual; } });
+var native_links_1 = require("./services-and-utils/native-links");
+Object.defineProperty(exports, "prepareNativeDeeplinkUrl", { enumerable: true, get: function () { return native_links_1.prepareNativeDeeplinkUrl; } });
+Object.defineProperty(exports, "prepareOpenInBrowserUrl", { enumerable: true, get: function () { return native_links_1.prepareOpenInBrowserUrl; } });
+Object.defineProperty(exports, "prepareOpenInNewWebviewDeeplink", { enumerable: true, get: function () { return native_links_1.prepareOpenInNewWebviewDeeplink; } });
+Object.defineProperty(exports, "preparePdfUrl", { enumerable: true, get: function () { return native_links_1.preparePdfUrl; } });

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

@@ -1,4 +1,5 @@
 import { type LogError, type PdfType } from '../types';
+import { type NativeLogService } from './native-log-service';
 import { type NativeParamsService } from './native-params-service';
 /**
  * Сервис, предоставляющий методы для открытия внешних для текущего WA экранов
@@ -6,13 +7,21 @@ import { type NativeParamsService } from './native-params-service';
  */
 export declare class ExternalLinksService {
     private nativeParamsService;
+    private nativeLogService;
     private logError?;
     private navigationByNativeAppInProgress;
-    constructor(nativeParamsService: NativeParamsService, logError?: LogError | undefined);
+    constructor(nativeParamsService: NativeParamsService, nativeLogService: NativeLogService, logError?: LogError | undefined);
     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;
+    private get nativeAppTarget();
+    /**
+     * Логирует невалидный URL через `logError` и бросает ошибку.
+     * Чистые функции сборки URL бросают ту же ошибку, но без логирования.
+     */
+    private validateUrlOrThrow;
+    private logBrowserFallback;
     private navigateByNativeApp;
 }

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

@@ -1,19 +1,17 @@
 "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 native_links_1 = require("./native-links");
 const utils_1 = require("./utils");
 const CANCEL_NEW_CALLS_TO_NA_TIME = 150;
-const QUERY_OPEN_IN_BROWSER_KEY = 'openInBrowser';
-const QUERY_OPEN_IN_BROWSER_VALUE = 'true';
 /**
  * Сервис, предоставляющий методы для открытия внешних для текущего WA экранов
  * и связанных с этим действий.
  */
 class ExternalLinksService {
-    constructor(nativeParamsService, logError) {
+    constructor(nativeParamsService, nativeLogService, logError) {
         this.nativeParamsService = nativeParamsService;
+        this.nativeLogService = nativeLogService;
         this.logError = logError;
         this.navigationByNativeAppInProgress = false;
     }
@@ -21,84 +19,86 @@ class ExternalLinksService {
         if (this.navigationByNativeAppInProgress) {
             return;
         }
-        const clearedDeeplinkPath = deeplink.replace(constants_1.DEEP_LINK_PATTERN, '');
-        const originalNativeUrl = `${this.nativeParamsService.appId}://${clearedDeeplinkPath}`;
-        const preparedNativeUrl = this.nativeParamsService.environment === 'ios'
-            ? (0, utils_1.appendFromCurrentQueryParamForIos)(originalNativeUrl)
-            : originalNativeUrl;
+        const preparedNativeUrl = (0, native_links_1.prepareNativeDeeplinkUrl)(this.nativeAppTarget, deeplink);
         if (closeWebviewBeforeCallNativeDeeplinkHandler &&
             this.nativeParamsService.canUseNativeFeature('savedBackStack')) {
-            (0, utils_1.closeWebviewUtil)();
+            this.nativeLogService.execute('closeWebview', () => (0, utils_1.closeWebviewUtil)());
             // Проверено, ОС получает диплинк и передаёт его NA, не смотря на то,
             // что это происходит в следующей макрозадаче после команды на закрытие WV.
-            setTimeout(() => window.location.replace(preparedNativeUrl), 0);
+            this.nativeLogService.execute('nativeDeeplink', () => {
+                setTimeout(() => window.location.replace(preparedNativeUrl), 0);
+            }, { payload: { deeplink: preparedNativeUrl } });
             return;
         }
-        this.navigateByNativeApp(preparedNativeUrl);
+        this.navigateByNativeApp(preparedNativeUrl, 'nativeDeeplink');
     }
     getHrefToOpenInBrowser(link) {
         if (!this.nativeParamsService.canUseNativeFeature('linksInBrowser')) {
+            this.logBrowserFallback(link);
             return `${this.nativeParamsService.appId}://webFeature?type=recommendation&url=${encodeURIComponent(link)}`;
         }
-        const url = (0, utils_1.validateUrl)(link, this.logError);
-        if (!url) {
-            throw new Error(`invalid url: ${link}`);
-        }
-        url.searchParams.append(QUERY_OPEN_IN_BROWSER_KEY, QUERY_OPEN_IN_BROWSER_VALUE);
-        return url.href;
+        this.validateUrlOrThrow(link);
+        return (0, native_links_1.prepareOpenInBrowserUrl)(this.nativeAppTarget, link, true);
     }
     openInBrowser(link) {
         if (this.navigationByNativeAppInProgress) {
             return;
         }
-        if (!this.nativeParamsService.canUseNativeFeature('linksInBrowser')) {
-            this.openInNewWebview(link);
-            return;
-        }
-        const url = (0, utils_1.validateUrl)(link, this.logError);
-        if (!url) {
-            throw new Error(`invalid url: ${link}`);
+        this.validateUrlOrThrow(link);
+        const linksInBrowser = this.nativeParamsService.canUseNativeFeature('linksInBrowser');
+        if (!linksInBrowser) {
+            this.logBrowserFallback(link);
         }
-        url.searchParams.append(QUERY_OPEN_IN_BROWSER_KEY, QUERY_OPEN_IN_BROWSER_VALUE);
-        this.navigateByNativeApp(url.href);
+        this.navigateByNativeApp((0, native_links_1.prepareOpenInBrowserUrl)(this.nativeAppTarget, link, linksInBrowser), 'openInBrowser');
     }
     openInNewWebview(link, nativeTitle = '', closeCurrentWebview = false) {
-        const url = (0, utils_1.validateUrl)(link, this.logError);
-        if (!url) {
-            throw new Error(`invalid url: ${link}`);
-        }
-        if (nativeTitle) {
-            url.searchParams.set(query_and_headers_keys_1.QUERY_B2N_TITLE, nativeTitle);
+        this.validateUrlOrThrow(link);
+        if (this.nativeParamsService.environment === 'android' &&
+            !this.nativeParamsService.canUseNativeFeature('savedBackStack')) {
+            this.nativeLogService.logFeatureFallback({
+                feature: 'savedBackStack',
+                fallbackReason: 'Открытие нового webview в Android приведет к закрытию текущего',
+                payload: { link },
+            });
         }
-        this.handleNativeDeeplink(`/webFeature?type=recommendation&url=${encodeURIComponent(url.toString())}`, closeCurrentWebview);
+        this.handleNativeDeeplink((0, native_links_1.prepareOpenInNewWebviewDeeplink)(link, nativeTitle), closeCurrentWebview);
     }
     openPdf(url, type = 'pdfFile', title) {
         if (this.navigationByNativeAppInProgress) {
             return;
         }
-        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}`;
+        this.navigateByNativeApp((0, native_links_1.preparePdfUrl)(this.nativeAppTarget, url, type, title), 'openPdf');
+    }
+    get nativeAppTarget() {
+        return {
+            platform: this.nativeParamsService.environment,
+            appId: this.nativeParamsService.appId,
+        };
+    }
+    /**
+     * Логирует невалидный URL через `logError` и бросает ошибку.
+     * Чистые функции сборки URL бросают ту же ошибку, но без логирования.
+     */
+    validateUrlOrThrow(link) {
+        if (!(0, utils_1.validateUrl)(link, this.logError)) {
+            throw new Error(`invalid url: ${link}`);
         }
-        replaceUrl =
-            this.nativeParamsService.environment === 'ios'
-                ? (0, utils_1.appendFromCurrentQueryParamForIos)(replaceUrl)
-                : replaceUrl;
-        this.navigateByNativeApp(replaceUrl);
     }
-    navigateByNativeApp(url) {
-        this.navigationByNativeAppInProgress = true;
-        window.location.replace(url);
-        setTimeout(() => {
-            this.navigationByNativeAppInProgress = false;
-        }, CANCEL_NEW_CALLS_TO_NA_TIME);
+    logBrowserFallback(link) {
+        this.nativeLogService.logFeatureFallback({
+            feature: 'linksInBrowser',
+            fallbackReason: 'Открытие в браузере технически недоступно, будет открыто в новом webview',
+            payload: { link },
+        });
+    }
+    navigateByNativeApp(url, action) {
+        this.nativeLogService.execute(action, () => {
+            this.navigationByNativeAppInProgress = true;
+            window.location.replace(url);
+            setTimeout(() => {
+                this.navigationByNativeAppInProgress = false;
+            }, CANCEL_NEW_CALLS_TO_NA_TIME);
+        }, { payload: { url } });
     }
 }
 exports.ExternalLinksService = ExternalLinksService;

package/client/services-and-utils/native-features.d.ts

@@ -0,0 +1,12 @@
+import { type Environment, type NativeFeatureKey } from '../types';
+export declare const isValidVersionFormat: (version?: string) => version is string;
+/**
+ * Сравнивает версии формата `x.y.z` покомпонентно, как числа.
+ * Если хоть одна из версий в другом формате — возвращает `false`.
+ */
+export declare const isVersionHigherOrEqual: (version: string, versionToCompare: string) => boolean;
+/**
+ * Проверяет, поддерживает ли NA указанной платформы и версии нативную фичу.
+ * Версия в неизвестном формате считается `0.0.0`.
+ */
+export declare const canUseNativeFeature: (platform: Environment, appVersion: string, feature: NativeFeatureKey) => boolean;

package/client/services-and-utils/native-features.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canUseNativeFeature = exports.isVersionHigherOrEqual = exports.isValidVersionFormat = void 0;
+const constants_1 = require("../constants");
+const VERSION_FORMAT_PATTERN = /^\d+\.\d+\.\d+$/;
+const isValidVersionFormat = (version) => Boolean(version) && VERSION_FORMAT_PATTERN.test(version);
+exports.isValidVersionFormat = isValidVersionFormat;
+/**
+ * Сравнивает версии формата `x.y.z` покомпонентно, как числа.
+ * Если хоть одна из версий в другом формате — возвращает `false`.
+ */
+const isVersionHigherOrEqual = (version, versionToCompare) => {
+    if (!(0, exports.isValidVersionFormat)(version) || !(0, exports.isValidVersionFormat)(versionToCompare)) {
+        return false;
+    }
+    const versionComponents = version.split('.').map(Number);
+    const versionToCompareComponents = versionToCompare.split('.').map(Number);
+    for (let i = 0; i < versionComponents.length; i++) {
+        if (versionComponents[i] !== versionToCompareComponents[i]) {
+            return versionComponents[i] > versionToCompareComponents[i];
+        }
+    }
+    return true;
+};
+exports.isVersionHigherOrEqual = isVersionHigherOrEqual;
+/**
+ * Проверяет, поддерживает ли NA указанной платформы и версии нативную фичу.
+ * Версия в неизвестном формате считается `0.0.0`.
+ */
+const canUseNativeFeature = (platform, appVersion, feature) => {
+    const { fromVersion } = constants_1.NATIVE_FEATURES_FROM_VERSION[platform][feature];
+    return (0, exports.isVersionHigherOrEqual)((0, exports.isValidVersionFormat)(appVersion) ? appVersion : '0.0.0', fromVersion);
+};
+exports.canUseNativeFeature = canUseNativeFeature;

package/client/services-and-utils/native-links.d.ts

@@ -0,0 +1,26 @@
+import { type NativeAppTarget, type PdfType } from '../types';
+/**
+ * Собирает URL для открытия диплинка NA: `alfabank:///dashboard/x`, `/x`, `alfabank://x` → `<appId>://x`.
+ * На iOS добавляет `fromCurrent=true`.
+ */
+export declare const prepareNativeDeeplinkUrl: ({ platform, appId }: NativeAppTarget, deeplink: string) => string;
+/**
+ * Собирает диплинк (без схемы) на открытие ссылки в новом WV.
+ * Результат передаётся в `prepareNativeDeeplinkUrl` или `handleNativeDeeplink`.
+ *
+ * @throws Если `link` не абсолютный http(s) URL.
+ */
+export declare const prepareOpenInNewWebviewDeeplink: (link: string, nativeTitle?: string) => string;
+/**
+ * Собирает URL на открытие ссылки в браузере.
+ * Если NA не умеет открывать ссылки в браузере — URL на открытие ссылки в новом WV.
+ *
+ * @param linksInBrowser Результат `canUseNativeFeature(platform, appVersion, 'linksInBrowser')`.
+ * @throws Если `link` не абсолютный http(s) URL.
+ */
+export declare const prepareOpenInBrowserUrl: (target: NativeAppTarget, link: string, linksInBrowser: boolean) => string;
+/**
+ * Собирает URL на открытие PDF. На iOS — диплинк на нативный pdf_viewer,
+ * на Android — исходный URL (его перехватывает NA).
+ */
+export declare const preparePdfUrl: ({ platform, appId }: NativeAppTarget, url: string, type?: PdfType, title?: string) => string;

package/client/services-and-utils/native-links.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preparePdfUrl = exports.prepareOpenInBrowserUrl = exports.prepareOpenInNewWebviewDeeplink = exports.prepareNativeDeeplinkUrl = void 0;
+const query_and_headers_keys_1 = require("../../query-and-headers-keys");
+const constants_1 = require("../constants");
+const utils_1 = require("./utils");
+const QUERY_OPEN_IN_BROWSER_KEY = 'openInBrowser';
+const QUERY_OPEN_IN_BROWSER_VALUE = 'true';
+/*
+ * Чистые функции сборки URL, по которым NA открывает свои экраны.
+ * Используются `ExternalLinksService` и экспортируются для окружений,
+ * где экземпляр `BridgeToNative` не создаётся (например, миниаппы).
+ */
+const parseUrl = (link) => {
+    const url = (0, utils_1.validateUrl)(link);
+    if (!url) {
+        throw new Error(`invalid url: ${link}`);
+    }
+    return url;
+};
+/**
+ * Собирает URL для открытия диплинка NA: `alfabank:///dashboard/x`, `/x`, `alfabank://x` → `<appId>://x`.
+ * На iOS добавляет `fromCurrent=true`.
+ */
+const prepareNativeDeeplinkUrl = ({ platform, appId }, deeplink) => {
+    const nativeUrl = `${appId}://${deeplink.replace(constants_1.DEEP_LINK_PATTERN, '')}`;
+    return platform === 'ios' ? (0, utils_1.appendFromCurrentQueryParamForIos)(nativeUrl) : nativeUrl;
+};
+exports.prepareNativeDeeplinkUrl = prepareNativeDeeplinkUrl;
+/**
+ * Собирает диплинк (без схемы) на открытие ссылки в новом WV.
+ * Результат передаётся в `prepareNativeDeeplinkUrl` или `handleNativeDeeplink`.
+ *
+ * @throws Если `link` не абсолютный http(s) URL.
+ */
+const prepareOpenInNewWebviewDeeplink = (link, nativeTitle = '') => {
+    const url = parseUrl(link);
+    if (nativeTitle) {
+        url.searchParams.set(query_and_headers_keys_1.QUERY_B2N_TITLE, nativeTitle);
+    }
+    return `webFeature?type=recommendation&url=${encodeURIComponent(url.toString())}`;
+};
+exports.prepareOpenInNewWebviewDeeplink = prepareOpenInNewWebviewDeeplink;
+/**
+ * Собирает URL на открытие ссылки в браузере.
+ * Если NA не умеет открывать ссылки в браузере — URL на открытие ссылки в новом WV.
+ *
+ * @param linksInBrowser Результат `canUseNativeFeature(platform, appVersion, 'linksInBrowser')`.
+ * @throws Если `link` не абсолютный http(s) URL.
+ */
+const prepareOpenInBrowserUrl = (target, link, linksInBrowser) => {
+    if (!linksInBrowser) {
+        return (0, exports.prepareNativeDeeplinkUrl)(target, (0, exports.prepareOpenInNewWebviewDeeplink)(link));
+    }
+    const url = parseUrl(link);
+    url.searchParams.append(QUERY_OPEN_IN_BROWSER_KEY, QUERY_OPEN_IN_BROWSER_VALUE);
+    return url.href;
+};
+exports.prepareOpenInBrowserUrl = prepareOpenInBrowserUrl;
+/**
+ * Собирает URL на открытие PDF. На iOS — диплинк на нативный pdf_viewer,
+ * на Android — исходный URL (его перехватывает NA).
+ */
+const preparePdfUrl = ({ platform, appId }, url, type = 'pdfFile', title) => {
+    if (platform !== 'ios') {
+        return url;
+    }
+    const params = new URLSearchParams();
+    params.append('type', type);
+    params.append('url', decodeURIComponent(url));
+    if (title) {
+        params.append('title', title.replace(/\s/g, '_'));
+    }
+    return (0, utils_1.appendFromCurrentQueryParamForIos)(`${appId}:///dashboard/pdf_viewer?${params.toString()}`);
+};
+exports.preparePdfUrl = preparePdfUrl;

package/client/services-and-utils/native-log-service.d.ts

@@ -0,0 +1,26 @@
+import { type Environment, type NativeFeatureContext, type NativeFeatureKey, type NoopOptions } from '../types';
+/**
+ * Обёртка для выполнения нативных вызовов с noop-режимом и логированием версионных фич
+ */
+export declare class NativeLogService {
+    private environment;
+    private appVersion;
+    private isNoop?;
+    constructor(environment: Environment, appVersion: string, isNoop?: NoopOptions["enabled"] | undefined);
+    /**
+     * Метод для вывода в консоль информации о недоступности фич,
+     * перечисленных в `NATIVE_FEATURES_FROM_VERSION` src/client/constants.ts
+     */
+    logFeatureFallback(params: {
+        feature: NativeFeatureKey;
+        fallbackReason: string;
+        payload?: unknown;
+    }): void;
+    /**
+     * Метод подменяющий нативный вызов и логирующий его, для работы в noop режиме
+     */
+    execute(action: string, fn: () => void, meta?: {
+        featureContext?: NativeFeatureContext | null;
+        payload?: unknown;
+    }): void;
+}

package/client/services-and-utils/native-log-service.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NativeLogService = void 0;
+const constants_1 = require("../constants");
+/**
+ * Обёртка для выполнения нативных вызовов с noop-режимом и логированием версионных фич
+ */
+class NativeLogService {
+    constructor(environment, appVersion, isNoop) {
+        this.environment = environment;
+        this.appVersion = appVersion;
+        this.isNoop = isNoop;
+    }
+    /**
+     * Метод для вывода в консоль информации о недоступности фич,
+     * перечисленных в `NATIVE_FEATURES_FROM_VERSION` src/client/constants.ts
+     */
+    logFeatureFallback(params) {
+        if (!this.isNoop)
+            return;
+        const { fromVersion } = constants_1.NATIVE_FEATURES_FROM_VERSION[this.environment][params.feature];
+        console.info([
+            `[B2N noop][${this.environment}][v${this.appVersion}]`,
+            `Feature: ${params.feature}`,
+            `${params.fallbackReason}`,
+            `Будет исправлено в версии: ${fromVersion}`,
+        ].join('\n'), params.payload);
+    }
+    /**
+     * Метод подменяющий нативный вызов и логирующий его, для работы в noop режиме
+     */
+    execute(action, fn, meta) {
+        var _a;
+        if (this.isNoop) {
+            if (meta === null || meta === void 0 ? void 0 : meta.featureContext) {
+                this.logFeatureFallback({
+                    feature: meta.featureContext.feature,
+                    fallbackReason: (_a = meta.featureContext.fallbackReason) !== null && _a !== void 0 ? _a : '',
+                    payload: meta.payload,
+                });
+            }
+            else {
+                console.info(`[B2N noop][${this.environment}][v${this.appVersion}] ${action}`, ...((meta === null || meta === void 0 ? void 0 : meta.payload) !== undefined ? [meta.payload] : []));
+            }
+            return;
+        }
+        fn();
+    }
+}
+exports.NativeLogService = NativeLogService;

package/client/services-and-utils/native-navigation-and-title-service.d.ts

@@ -1,4 +1,5 @@
 import { type BrowserHistoryApiWrappers, type HistoryPushStateParams, type LocationAssignParam, type LogError } from '../types';
+import { type NativeLogService } from './native-log-service';
 import { type NativeParamsService } from './native-params-service';
 /**
  * Сервис, отвечающий за взаимодействие WA с WV компонентами NA —
@@ -9,6 +10,7 @@ import { type NativeParamsService } from './native-params-service';
  */
 export declare class NativeNavigationAndTitleService {
     private nativeParamsService;
+    private nativeLogService;
     private browserHistoryApiWrappers?;
     private logError?;
     private lastSetPageSettingsParams;
@@ -16,7 +18,7 @@ export declare class NativeNavigationAndTitleService {
     private numOfBackSteps;
     private isGoBackLocked;
     private isNavigateServerSideLocked;
-    constructor(nativeParamsService: NativeParamsService, browserHistoryApiWrappers?: BrowserHistoryApiWrappers | undefined, logError?: LogError | undefined);
+    constructor(nativeParamsService: NativeParamsService, nativeLogService: NativeLogService, browserHistoryApiWrappers?: BrowserHistoryApiWrappers | undefined, logError?: LogError | undefined);
     closeWebview(): void;
     goBack(): void;
     goBackAFewSteps(stepsNumber: number, autoCloseWebview?: boolean): void;

package/client/services-and-utils/native-navigation-and-title-service.js

@@ -1,7 +1,7 @@
 "use strict";
-/* eslint max-lines: ["error", {"max": 360, "skipComments": true}] */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NativeNavigationAndTitleService = void 0;
+/* eslint max-lines: ["error", {"max": 370, "skipComments": true}] */
 const query_and_headers_keys_1 = require("../../query-and-headers-keys");
 const utils_1 = require("./utils");
 const NativeHistoryStackStub = 0;
@@ -13,8 +13,9 @@ const NativeHistoryStackStub = 0;
  * см. в документе {@link ./NAVIGATION_SCENARIOS.md}.
  */
 class NativeNavigationAndTitleService {
-    constructor(nativeParamsService, browserHistoryApiWrappers, logError) {
+    constructor(nativeParamsService, nativeLogService, browserHistoryApiWrappers, logError) {
         this.nativeParamsService = nativeParamsService;
+        this.nativeLogService = nativeLogService;
         this.browserHistoryApiWrappers = browserHistoryApiWrappers;
         this.logError = logError;
         // Здесь сохраняются параметры, которые в последний раз были отправлены
@@ -39,7 +40,7 @@ class NativeNavigationAndTitleService {
     }
     // eslint-disable-next-line class-methods-use-this -- удобней использовать метод в контексте экземпляра.
     closeWebview() {
-        (0, utils_1.closeWebviewUtil)();
+        this.nativeLogService.execute('closeWebview', () => (0, utils_1.closeWebviewUtil)());
     }
     goBack() {
         if (this.isGoBackLocked) {
@@ -57,7 +58,7 @@ class NativeNavigationAndTitleService {
         const maxStepsToBack = this.nativeHistoryStack.length - 1;
         if (stepsToBack > maxStepsToBack) {
             if (autoCloseWebview) {
-                (0, utils_1.closeWebviewUtil)();
+                this.nativeLogService.execute('closeWebview', () => (0, utils_1.closeWebviewUtil)());
                 return;
             }
             this.numOfBackSteps = maxStepsToBack;
@@ -165,7 +166,7 @@ class NativeNavigationAndTitleService {
         }
         this.numOfBackSteps = 1;
         if (this.nativeHistoryStack.length < 1) {
-            (0, utils_1.closeWebviewUtil)();
+            this.nativeLogService.execute('closeWebview', () => (0, utils_1.closeWebviewUtil)());
             return;
         }
         this.saveNativeHistoryStack();
@@ -282,13 +283,12 @@ class NativeNavigationAndTitleService {
      * с `nativeHistoryStack`.
      */
     syncHistoryWithNative() {
-        var _a;
         const { pageId, pageTitle } = this.getNativePageIdAndTitle();
         if (this.nativeParamsService.environment === 'android') {
             const narrowedPageId = pageId !== null && pageId !== void 0 ? pageId : 1;
             const paramsToSend = JSON.stringify({ pageId: narrowedPageId, pageTitle });
             if (this.lastSetPageSettingsParams !== paramsToSend) {
-                (_a = this.nativeParamsService.AndroidBridge) === null || _a === void 0 ? void 0 : _a.setPageSettings(paramsToSend);
+                this.nativeLogService.execute('syncHistoryWithNative', () => { var _a; return (_a = this.nativeParamsService.AndroidBridge) === null || _a === void 0 ? void 0 : _a.setPageSettings(paramsToSend); }, { payload: paramsToSend });
                 this.lastSetPageSettingsParams = paramsToSend;
             }
         }
@@ -297,7 +297,7 @@ class NativeNavigationAndTitleService {
             const pageIdStr = pageId ? `&pageId=${pageId}` : '';
             const paramsToSend = `ios:setPageSettings/${pageTitleStr + pageIdStr}`;
             if (this.lastSetPageSettingsParams !== paramsToSend) {
-                window.location.replace(paramsToSend);
+                this.nativeLogService.execute('syncHistoryWithNative', () => window.location.replace(paramsToSend), { payload: paramsToSend });
                 this.lastSetPageSettingsParams = paramsToSend;
             }
         }

package/client/services-and-utils/native-params-service.d.ts

@@ -1,8 +1,9 @@
-import { type Environment, type LogError, type NativeFeatureKey, type Theme } from '../types';
+import { type Environment, type LogError, type NativeFeatureKey, type NoopOptions, type Theme } from '../types';
 /**
  * Сервис, аккумулирующий детали о NA и предоставляющий методы, связанные с этим.
  */
 export declare class NativeParamsService {
+    private noop?;
     private logError?;
     AndroidBridge: {
         setPageSettings: (params: string) => void;
@@ -16,10 +17,12 @@ export declare class NativeParamsService {
     theme: Theme;
     title: string;
     webviewLaunchTime: number | null;
-    constructor(logError?: LogError | undefined);
+    constructor(noop?: NoopOptions | undefined, logError?: LogError | undefined);
     canUseNativeFeature(feature: NativeFeatureKey): boolean;
     isCurrentVersionHigherOrEqual(versionToCompare: string): boolean;
     private static isValidVersionFormat;
     private getAppId;
     private readNativeParamsCookie;
+    private resolveEnvironment;
+    private resolveAppVersion;
 }

package/client/services-and-utils/native-params-service.js

@@ -3,19 +3,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NativeParamsService = void 0;
 const query_and_headers_keys_1 = require("../../query-and-headers-keys");
 const constants_1 = require("../constants");
+const native_features_1 = require("./native-features");
 /**
  * Сервис, аккумулирующий детали о NA и предоставляющий методы, связанные с этим.
  */
 class NativeParamsService {
-    constructor(logError) {
+    constructor(noop, logError) {
+        this.noop = noop;
         this.logError = logError;
         this.AndroidBridge = window.Android;
-        this.environment = window.Android ? 'android' : 'ios';
         this.nativeParamsReadErrorFlag = false;
         const nativeParams = this.readNativeParamsCookie();
-        this.appVersion = NativeParamsService.isValidVersionFormat(nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.appVersion)
-            ? nativeParams.appVersion
-            : '0.0.0';
+        this.environment = this.resolveEnvironment();
+        this.appVersion = this.resolveAppVersion(nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.appVersion);
         this.appId = this.getAppId(nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.iosAppId);
         this.nextPageId = (nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.nextPageId) || null;
         this.originalWebviewParams = (nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.originalWebviewParams) || null;
@@ -24,28 +24,13 @@ class NativeParamsService {
         this.webviewLaunchTime = (nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.webviewLaunchTime) || null;
     }
     canUseNativeFeature(feature) {
-        const { fromVersion } = constants_1.NATIVE_FEATURES_FROM_VERSION[this.environment][feature];
-        return this.isCurrentVersionHigherOrEqual(fromVersion);
+        return (0, native_features_1.canUseNativeFeature)(this.environment, this.appVersion, feature);
     }
     isCurrentVersionHigherOrEqual(versionToCompare) {
-        if (!NativeParamsService.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;
+        return (0, native_features_1.isVersionHigherOrEqual)(this.appVersion, versionToCompare);
     }
     static isValidVersionFormat(version) {
-        if (!version)
-            return false;
-        const versionPattern = /^\d+\.\d+\.\d+$/;
-        return versionPattern.test(version);
+        return (0, native_features_1.isValidVersionFormat)(version);
     }
     getAppId(knownIosAppId) {
         if (this.environment !== 'ios') {
@@ -76,5 +61,21 @@ class NativeParamsService {
             return null;
         }
     }
+    resolveEnvironment() {
+        var _a;
+        if (((_a = this.noop) === null || _a === void 0 ? void 0 : _a.enabled) && this.noop.environment) {
+            return this.noop.environment;
+        }
+        return window.Android ? 'android' : 'ios';
+    }
+    resolveAppVersion(versionFromCookie) {
+        var _a;
+        if (((_a = this.noop) === null || _a === void 0 ? void 0 : _a.enabled) && NativeParamsService.isValidVersionFormat(this.noop.appVersion)) {
+            return this.noop.appVersion;
+        }
+        return NativeParamsService.isValidVersionFormat(versionFromCookie)
+            ? versionFromCookie
+            : '0.0.0';
+    }
 }
 exports.NativeParamsService = NativeParamsService;

package/client/services-and-utils/utils.js

@@ -26,7 +26,7 @@ exports.closeWebviewUtil = closeWebviewUtil;
 const validateUrl = (link, logError) => {
     let url;
     try {
-        url = link instanceof URL ? link : new URL(link);
+        url = new URL(link);
     }
     catch (error) {
         logError === null || logError === void 0 ? void 0 : logError('validateUrl: URL parsing error', {
@@ -35,6 +35,16 @@ const validateUrl = (link, logError) => {
         });
         return null;
     }
+    const isAllowedProtocol = url.protocol === 'https:' || url.protocol === 'http:';
+    const hasCredentials = Boolean(url.username || url.password);
+    if (!isAllowedProtocol || !url.hostname || hasCredentials) {
+        logError === null || logError === void 0 ? void 0 : logError('validateUrl: URL validation error', {
+            hostname: url.hostname,
+            link,
+            protocol: url.protocol,
+        });
+        return null;
+    }
     return url;
 };
 exports.validateUrl = validateUrl;

package/client/types.d.ts

@@ -4,11 +4,19 @@ export type BrowserHistoryApiWrappers = {
     replace?: (url: HistoryReplaceStateParams[2], state: HistoryReplaceStateParams[0]) => void;
 };
 export type Environment = 'android' | 'ios';
+export type NativeAppTarget = {
+    platform: Environment;
+    appId: string;
+};
 export type HistoryPushStateParams = Parameters<typeof window.history.pushState>;
 export type HistoryReplaceStateParams = Parameters<typeof window.history.replaceState>;
 export type LocationAssignParam = Parameters<typeof window.location.assign>[0];
 export type LogError = (b2nErrorMessage: string, originalError: unknown) => void;
 export type NativeFeatureKey = 'geolocation' | 'linksInBrowser' | 'savedBackStack';
+export type NativeFeatureContext = {
+    feature: NativeFeatureKey;
+    fallbackReason?: string;
+};
 type NativeFeaturesParams = Readonly<Record<NativeFeatureKey, {
     fromVersion: string;
 }>>;
@@ -18,4 +26,9 @@ export type NativeFeaturesFromVersion = Readonly<{
 }>;
 export type PdfType = 'pdfFile' | 'base64' | 'binary';
 export type Theme = 'light' | 'dark';
+export type NoopOptions = {
+    enabled: boolean;
+    environment?: Environment;
+    appVersion?: string;
+};
 export {};

package/package.json

@@ -1,121 +1,127 @@
 {
-    "name": "@alfalab/bridge-to-native",
-    "version": "1.4.2",
-    "license": "MIT",
-    "description": "Утилита для удобной работы веб приложения внутри нативного приложения и коммуникации с ним.",
-    "engines": {
-        "node": ">=20.19.2",
-        "npm": "please-use-yarn"
+  "name": "@alfalab/bridge-to-native",
+  "version": "1.5.1-beta.50a07d1",
+  "license": "MIT",
+  "description": "Утилита для удобной работы веб приложения внутри нативного приложения и коммуникации с ним.",
+  "engines": {
+    "node": ">=20.19.2",
+    "npm": "please-use-yarn"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/core-ds/bridge-to-native.git"
+  },
+  "exports": {
+    "./client": {
+      "import": "./client/index.js",
+      "require": "./client/index.js",
+      "types": "./client/index.d.ts"
     },
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/core-ds/bridge-to-native.git"
+    "./client/primitives": {
+      "import": "./client/primitives.js",
+      "require": "./client/primitives.js",
+      "types": "./client/primitives.d.ts"
     },
-    "exports": {
-        "./client": {
-            "import": "./client/index.js",
-            "require": "./client/index.js",
-            "types": "./client/index.d.ts"
-        },
-        "./server": {
-            "import": "./server/index.js",
-            "require": "./server/index.js",
-            "types": "./server/index.d.ts"
-        }
-    },
-    "sideEffects": false,
-    "bugs": {
-        "url": "https://github.com/core-ds/bridge-to-native/issues"
-    },
-    "scripts": {
-        "build": "yarn build:clean && yarn build:ts",
-        "build:clean": "shx rm -rf .publish",
-        "build:copy-package-json": "shx cp package.json .publish/package.json",
-        "build:ts": "tsc --build",
-        "format": "arui-presets-lint format",
-        "format:check": "arui-presets-lint format:check",
-        "lint": "yarn lint:scripts && yarn format:check",
-        "lint:fix": "yarn lint:scripts --fix && yarn format",
-        "lint:scripts": "arui-presets-lint scripts",
-        "pub": "npm publish .publish --userconfig \"../.npmrc\" --tag \"$TAG\"",
-        "release": "yarn build && yarn build:copy-package-json && yarn pub",
-        "test": "arui-scripts test --silent --collect-coverage"
-    },
-    "devDependencies": {
-        "@happy-dom/jest-environment": "18.0.1",
-        "@types/jest": "29.5.14",
-        "@types/node": "20.19.1",
-        "arui-presets-lint": "8.7.0",
-        "arui-scripts": "19.0.7",
-        "copyfiles": "2.4.1",
-        "jest-junit": "10.0.0",
-        "lint-staged": "^12.5.0",
-        "promisify-child-process": "4.1.1",
-        "shx": "0.3.4",
-        "typescript": "5.5.4"
-    },
-    "commitlint": {
-        "extends": "./node_modules/arui-presets-lint/commitlint"
-    },
-    "eslintConfig": {
-        "extends": "./node_modules/arui-presets-lint/eslint",
-        "parserOptions": {
-            "project": [
-                "./__tests__/tsconfig.json",
-                "./src/client/tsconfig.json",
-                "./src/server/tsconfig.json"
-            ]
-        },
-        "overrides": [
-            {
-                "files": [
-                    "__tests__/**/*"
-                ],
-                "rules": {
-                    "max-lines": "off"
-                }
-            }
-        ]
+    "./server": {
+      "import": "./server/index.js",
+      "require": "./server/index.js",
+      "types": "./server/index.d.ts"
+    }
+  },
+  "sideEffects": false,
+  "bugs": {
+    "url": "https://github.com/core-ds/bridge-to-native/issues"
+  },
+  "scripts": {
+    "build": "yarn build:clean && yarn build:ts",
+    "build:clean": "shx rm -rf .publish",
+    "build:copy-package-json": "shx cp package.json .publish/package.json",
+    "build:ts": "tsc --build",
+    "format": "arui-presets-lint format",
+    "format:check": "arui-presets-lint format:check",
+    "lint": "yarn lint:scripts && yarn format:check",
+    "lint:fix": "yarn lint:scripts --fix && yarn format",
+    "lint:scripts": "arui-presets-lint scripts",
+    "pub": "npm publish .publish --userconfig \"../.npmrc\" --tag \"$TAG\"",
+    "release": "yarn build && yarn build:copy-package-json && yarn pub",
+    "test": "arui-scripts test --silent --collect-coverage"
+  },
+  "devDependencies": {
+    "@happy-dom/jest-environment": "18.0.1",
+    "@types/jest": "29.5.14",
+    "@types/node": "20.19.1",
+    "arui-presets-lint": "8.7.0",
+    "arui-scripts": "19.0.7",
+    "copyfiles": "2.4.1",
+    "jest-junit": "10.0.0",
+    "lint-staged": "^12.5.0",
+    "promisify-child-process": "4.1.1",
+    "shx": "0.3.4",
+    "typescript": "5.5.4"
+  },
+  "commitlint": {
+    "extends": "./node_modules/arui-presets-lint/commitlint"
+  },
+  "eslintConfig": {
+    "extends": "./node_modules/arui-presets-lint/eslint",
+    "parserOptions": {
+      "project": [
+        "./__tests__/tsconfig.json",
+        "./src/client/tsconfig.json",
+        "./src/server/tsconfig.json"
+      ]
     },
-    "jest": {
-        "projects": [
-            {
-                "displayName": "client-tests",
-                "testEnvironment": "@happy-dom/jest-environment",
-                "testPathIgnorePatterns": [
-                    "/__tests__/server/"
-                ]
-            },
-            {
-                "displayName": "server-tests",
-                "testEnvironment": "node",
-                "testPathIgnorePatterns": [
-                    "/__tests__/client/"
-                ]
-            }
+    "overrides": [
+      {
+        "files": [
+          "__tests__/**/*"
         ],
-        "testRegex": [
-            "__tests__/.*\\.test\\.ts"
-        ],
-        "coveragePathIgnorePatterns": [
-            "/node_modules/",
-            "/src/(client|server)/index.ts"
-        ],
-        "reporters": [
-            "default",
-            "jest-junit"
+        "rules": {
+          "max-lines": "off"
+        }
+      }
+    ]
+  },
+  "jest": {
+    "projects": [
+      {
+        "displayName": "client-tests",
+        "testEnvironment": "@happy-dom/jest-environment",
+        "testPathIgnorePatterns": [
+          "/__tests__/server/"
         ]
-    },
-    "prettier": "arui-presets-lint/prettier",
-    "stylelint": {
-        "extends": "arui-presets-lint/stylelint",
-        "ignoreFiles": [
-            "coverage/**/*.js",
-            ".yarn/releases/*"
+      },
+      {
+        "displayName": "server-tests",
+        "testEnvironment": "node",
+        "testPathIgnorePatterns": [
+          "/__tests__/client/"
         ]
-    },
-    "publishConfig": {
-        "registry": "https://registry.npmjs.org"
-    },
-    "packageManager": "yarn@4.12.0"
+      }
+    ],
+    "testRegex": [
+      "__tests__/.*\\.test\\.ts"
+    ],
+    "coveragePathIgnorePatterns": [
+      "/node_modules/",
+      "/src/(client|server)/index.ts",
+      "/src/client/primitives.ts"
+    ],
+    "reporters": [
+      "default",
+      "jest-junit"
+    ]
+  },
+  "prettier": "arui-presets-lint/prettier",
+  "stylelint": {
+    "extends": "arui-presets-lint/stylelint",
+    "ignoreFiles": [
+      "coverage/**/*.js",
+      ".yarn/releases/*"
+    ]
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "packageManager": "yarn@4.12.0"
 }

package/query-and-headers-keys.js

@@ -11,6 +11,8 @@ exports.HEADER_KEY_USER_AGENT = 'user-agent';
  */
 // Ключ cookie, с помощью которого серверная часть B2N передаст на клиент информацию об NA.
 exports.COOKIE_KEY_BRIDGE_TO_NATIVE_DATA = 'bridgeToNativeData';
+// Ключ cookie, с помощью которого серверная часть B2N передаст на клиент информацию об NA.
+// export const B2N_MODE = 'b2n_mode';
 // NA на обеих платформах подмешивает этот заголовок к запросу за HTML.
 // TODO:
 // * Исследовать, делает ли оно это при запросах к прочим ресурсам;