@alfalab/bridge-to-native 1.5.0 → 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,4 +1,3 @@
 export { BridgeToNative } from './bridge-to-native';
-export { canUseNativeFeature } from './services-and-utils/native-features';
-export { prepareNativeDeeplinkUrl, prepareOpenInBrowserUrl, prepareOpenInNewWebviewDeeplink, preparePdfUrl, } from './services-and-utils/native-links';
+export { canUseNativeFeature, isVersionHigherOrEqual, prepareNativeDeeplinkUrl, prepareOpenInBrowserUrl, prepareOpenInNewWebviewDeeplink, preparePdfUrl, } from './primitives';
 export type { Environment, NativeAppTarget, NativeFeatureKey, PdfType } from './types';

package/client/index.js

@@ -1,12 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.preparePdfUrl = exports.prepareOpenInNewWebviewDeeplink = exports.prepareOpenInBrowserUrl = exports.prepareNativeDeeplinkUrl = exports.canUseNativeFeature = 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 native_features_1 = require("./services-and-utils/native-features");
-Object.defineProperty(exports, "canUseNativeFeature", { enumerable: true, get: function () { return native_features_1.canUseNativeFeature; } });
-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; } });
+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,9 +7,10 @@ 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;
@@ -20,5 +22,6 @@ export declare class ExternalLinksService {
      * Чистые функции сборки URL бросают ту же ошибку, но без логирования.
      */
     private validateUrlOrThrow;
+    private logBrowserFallback;
     private navigateByNativeApp;
 }

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

@@ -9,8 +9,9 @@ const CANCEL_NEW_CALLS_TO_NA_TIME = 150;
  * и связанных с этим действий.
  */
 class ExternalLinksService {
-    constructor(nativeParamsService, logError) {
+    constructor(nativeParamsService, nativeLogService, logError) {
         this.nativeParamsService = nativeParamsService;
+        this.nativeLogService = nativeLogService;
         this.logError = logError;
         this.navigationByNativeAppInProgress = false;
     }
@@ -21,16 +22,19 @@ class ExternalLinksService {
         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)}`;
         }
         this.validateUrlOrThrow(link);
@@ -41,17 +45,29 @@ class ExternalLinksService {
             return;
         }
         this.validateUrlOrThrow(link);
-        this.navigateByNativeApp((0, native_links_1.prepareOpenInBrowserUrl)(this.nativeAppTarget, link, this.nativeParamsService.canUseNativeFeature('linksInBrowser')));
+        const linksInBrowser = this.nativeParamsService.canUseNativeFeature('linksInBrowser');
+        if (!linksInBrowser) {
+            this.logBrowserFallback(link);
+        }
+        this.navigateByNativeApp((0, native_links_1.prepareOpenInBrowserUrl)(this.nativeAppTarget, link, linksInBrowser), 'openInBrowser');
     }
     openInNewWebview(link, nativeTitle = '', closeCurrentWebview = false) {
         this.validateUrlOrThrow(link);
+        if (this.nativeParamsService.environment === 'android' &&
+            !this.nativeParamsService.canUseNativeFeature('savedBackStack')) {
+            this.nativeLogService.logFeatureFallback({
+                feature: 'savedBackStack',
+                fallbackReason: 'Открытие нового webview в Android приведет к закрытию текущего',
+                payload: { link },
+            });
+        }
         this.handleNativeDeeplink((0, native_links_1.prepareOpenInNewWebviewDeeplink)(link, nativeTitle), closeCurrentWebview);
     }
     openPdf(url, type = 'pdfFile', title) {
         if (this.navigationByNativeAppInProgress) {
             return;
         }
-        this.navigateByNativeApp((0, native_links_1.preparePdfUrl)(this.nativeAppTarget, url, type, title));
+        this.navigateByNativeApp((0, native_links_1.preparePdfUrl)(this.nativeAppTarget, url, type, title), 'openPdf');
     }
     get nativeAppTarget() {
         return {
@@ -68,12 +84,21 @@ class ExternalLinksService {
             throw new Error(`invalid url: ${link}`);
         }
     }
-    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-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

@@ -8,15 +8,14 @@ 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;
@@ -62,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/types.d.ts

@@ -13,6 +13,10 @@ export type HistoryReplaceStateParams = Parameters<typeof window.history.replace
 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;
 }>>;
@@ -22,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.5.0",
-    "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:
 // * Исследовать, делает ли оно это при запросах к прочим ресурсам;