@alfalab/bridge-to-native 1.4.1-beta.52a0437 → 1.4.1-beta.720f0f8

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

@@ -1,5 +1,6 @@
  
-import { type BrowserHistoryApiWrappers, type HistoryPushStateParams, type HistoryReplaceStateParams, type LocationAssignParam, type LogError, type NativeFeatureKey, type NoopOptions, type PdfType } from './types';
+import { type NoopOptions } from '../types';
+import { type BrowserHistoryApiWrappers, type HistoryPushStateParams, type HistoryReplaceStateParams, type LocationAssignParam, type LogError, type NativeFeatureKey, type PdfType } from './types';
 /**
  * Сервис, предоставляет методы для WA, работающего внутри NA.
  */
@@ -21,7 +22,7 @@ export declare class BridgeToNative {
         noop?: NoopOptions;
     } | undefined);
     private nativeParamsService;
-    private nativeExecuteService;
+    private nativeLogService;
     private externalLinksService;
     private nativeNavigationAndTitleService;
     /**
@@ -35,7 +36,7 @@ export declare class BridgeToNative {
     /**
      * Платформа, в окружении которой работает NA и WA.
      */
-    get environment(): import("./types").Environment;
+    get environment(): import("../types").Environment;
     /**
      * Индикатор проблемы чтения данных о NA. Если `true`, используются умолчания,
      * возможно ошибочные (например, версия будет `0.0.0`).

package/client/bridge-to-native.js

@@ -3,7 +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_execute_service_1 = require("./services-and-utils/native-execute-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");
 /**
@@ -24,9 +24,9 @@ class BridgeToNative {
         var _a, _b, _c, _d, _e, _f;
         this.options = options;
         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.nativeExecuteService = new native_execute_service_1.NativeExecuteService((_d = (_c = this.options) === null || _c === void 0 ? void 0 : _c.noop) === null || _d === void 0 ? void 0 : _d.enabled, this.nativeParamsService.environment);
-        this.externalLinksService = new external_links_service_1.ExternalLinksService(this.nativeParamsService, this.nativeExecuteService);
-        this.nativeNavigationAndTitleService = new native_navigation_and_title_service_1.NativeNavigationAndTitleService(this.nativeParamsService, this.nativeExecuteService, (_e = this.options) === null || _e === void 0 ? void 0 : _e.browserHistoryApiWrappers, (_f = this.options) === null || _f === void 0 ? void 0 : _f.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);
+        this.nativeNavigationAndTitleService = new native_navigation_and_title_service_1.NativeNavigationAndTitleService(this.nativeParamsService, this.nativeLogService, (_e = this.options) === null || _e === void 0 ? void 0 : _e.browserHistoryApiWrappers, (_f = this.options) === null || _f === void 0 ? void 0 : _f.logError);
     }
     /**
      * Схема NA.

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

@@ -1,5 +1,5 @@
 import { type PdfType } from '../types';
-import { type NativeExecuteService } from './native-execute-service';
+import { type NativeLogService } from './native-log-service';
 import { type NativeParamsService } from './native-params-service';
 /**
  * Сервис, предоставляющий методы для открытия внешних для текущего WA экранов
@@ -7,9 +7,9 @@ import { type NativeParamsService } from './native-params-service';
  */
 export declare class ExternalLinksService {
     private nativeParamsService;
-    private nativeExecuteService;
+    private nativeLogService;
     private navigationByNativeAppInProgress;
-    constructor(nativeParamsService: NativeParamsService, nativeExecuteService: NativeExecuteService);
+    constructor(nativeParamsService: NativeParamsService, nativeLogService: NativeLogService);
     handleNativeDeeplink(deeplink: string, closeWebviewBeforeCallNativeDeeplinkHandler?: boolean): void;
     getHrefToOpenInBrowser(link: string): string;
     openInBrowser(link: string): void;

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

@@ -12,9 +12,9 @@ const QUERY_OPEN_IN_BROWSER_VALUE = 'true';
  * и связанных с этим действий.
  */
 class ExternalLinksService {
-    constructor(nativeParamsService, nativeExecuteService) {
+    constructor(nativeParamsService, nativeLogService) {
         this.nativeParamsService = nativeParamsService;
-        this.nativeExecuteService = nativeExecuteService;
+        this.nativeLogService = nativeLogService;
         this.navigationByNativeAppInProgress = false;
     }
     handleNativeDeeplink(deeplink, closeWebviewBeforeCallNativeDeeplinkHandler = false) {
@@ -28,18 +28,37 @@ class ExternalLinksService {
             : originalNativeUrl;
         if (closeWebviewBeforeCallNativeDeeplinkHandler &&
             this.nativeParamsService.canUseNativeFeature('savedBackStack')) {
-            this.nativeExecuteService.execute('closeWebview', () => (0, utils_1.closeWebviewUtil)());
+            this.nativeLogService.execute('closeWebview', () => (0, utils_1.closeWebviewUtil)());
             // Проверено, ОС получает диплинк и передаёт его NA, не смотря на то,
             // что это происходит в следующей макрозадаче после команды на закрытие WV.
-            this.nativeExecuteService.execute('nativeDeeplink', () => {
+            this.nativeLogService.execute('nativeDeeplink', () => {
                 setTimeout(() => window.location.replace(preparedNativeUrl), 0);
-            }, { deeplink: preparedNativeUrl });
+            }, { payload: { deeplink: preparedNativeUrl } });
             return;
         }
-        this.nativeExecuteService.execute('nativeDeeplink', () => this.navigateByNativeApp(preparedNativeUrl), { deeplink: preparedNativeUrl });
+        let featureContext = null;
+        const { fromVersion } = constants_1.NATIVE_FEATURES_FROM_VERSION[this.nativeParamsService.environment].savedBackStack;
+        if (this.nativeParamsService.environment === 'android' &&
+            !this.nativeParamsService.isCurrentVersionHigherOrEqual(fromVersion)) {
+            featureContext = {
+                feature: 'savedBackStack',
+                fallbackReason: 'Открытие нового webview в Android приведет к закрытию текущего',
+            };
+        }
+        this.nativeLogService.execute('nativeDeeplink', () => this.navigateByNativeApp(preparedNativeUrl), {
+            payload: { deeplink: preparedNativeUrl },
+            featureContext: featureContext !== null && featureContext !== void 0 ? featureContext : null,
+        });
     }
     getHrefToOpenInBrowser(link) {
         if (!this.nativeParamsService.canUseNativeFeature('linksInBrowser')) {
+            if ((this, this.nativeParamsService.environment === 'android')) {
+                this.nativeLogService.logFeatureFallback({
+                    feature: 'linksInBrowser',
+                    fallbackReason: 'Открытие в браузере технически недоступно, будет открыто в новом webview',
+                    payload: { link },
+                });
+            }
             return `${this.nativeParamsService.appId}://webFeature?type=recommendation&url=${encodeURIComponent(link)}`;
         }
         const url = new URL(link);
@@ -51,12 +70,21 @@ class ExternalLinksService {
             return;
         }
         if (!this.nativeParamsService.canUseNativeFeature('linksInBrowser')) {
+            if ((this, this.nativeParamsService.environment === 'android')) {
+                this.nativeLogService.logFeatureFallback({
+                    feature: 'linksInBrowser',
+                    fallbackReason: 'Открытие в браузере технически недоступно, будет открыто в новом webview',
+                    payload: { link },
+                });
+            }
             this.openInNewWebview(link);
             return;
         }
         const url = new URL(link);
         url.searchParams.append(QUERY_OPEN_IN_BROWSER_KEY, QUERY_OPEN_IN_BROWSER_VALUE);
-        this.nativeExecuteService.execute('openInBrowser', () => this.navigateByNativeApp(url.href), { url: url.href });
+        this.nativeLogService.execute('openInBrowser', () => this.navigateByNativeApp(url.href), {
+            payload: { url: url.href },
+        });
     }
     openInNewWebview(link, nativeTitle = '', closeCurrentWebview = false) {
         const url = new URL(link);
@@ -84,7 +112,9 @@ class ExternalLinksService {
             this.nativeParamsService.environment === 'ios'
                 ? (0, utils_1.appendFromCurrentQueryParamForIos)(replaceUrl)
                 : replaceUrl;
-        this.nativeExecuteService.execute('openPdf ', () => this.navigateByNativeApp(replaceUrl), { replaceUrl });
+        this.nativeLogService.execute('openPdf ', () => this.navigateByNativeApp(replaceUrl), {
+            payload: { replaceUrl },
+        });
     }
     navigateByNativeApp(url) {
         this.navigationByNativeAppInProgress = true;

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

@@ -0,0 +1,27 @@
+import { type Environment, type NoopOptions } from '../../types';
+import { type NativeFeatureContext, type NativeFeatureKey } 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,5 +1,5 @@
 import { type BrowserHistoryApiWrappers, type HistoryPushStateParams, type LocationAssignParam, type LogError } from '../types';
-import { type NativeExecuteService } from './native-execute-service';
+import { type NativeLogService } from './native-log-service';
 import { type NativeParamsService } from './native-params-service';
 /**
  * Сервис, отвечающий за взаимодействие WA с WV компонентами NA —
@@ -10,7 +10,7 @@ import { type NativeParamsService } from './native-params-service';
  */
 export declare class NativeNavigationAndTitleService {
     private nativeParamsService;
-    private nativeExecuteService;
+    private nativeLogService;
     private browserHistoryApiWrappers?;
     private logError?;
     private lastSetPageSettingsParams;
@@ -18,7 +18,7 @@ export declare class NativeNavigationAndTitleService {
     private numOfBackSteps;
     private isGoBackLocked;
     private isNavigateServerSideLocked;
-    constructor(nativeParamsService: NativeParamsService, nativeExecuteService: NativeExecuteService, 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

@@ -13,9 +13,9 @@ const NativeHistoryStackStub = 0;
  * см. в документе {@link ./NAVIGATION_SCENARIOS.md}.
  */
 class NativeNavigationAndTitleService {
-    constructor(nativeParamsService, nativeExecuteService, browserHistoryApiWrappers, logError) {
+    constructor(nativeParamsService, nativeLogService, browserHistoryApiWrappers, logError) {
         this.nativeParamsService = nativeParamsService;
-        this.nativeExecuteService = nativeExecuteService;
+        this.nativeLogService = nativeLogService;
         this.browserHistoryApiWrappers = browserHistoryApiWrappers;
         this.logError = logError;
         // Здесь сохраняются параметры, которые в последний раз были отправлены
@@ -272,13 +272,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) {
-                this.nativeExecuteService.execute('syncHistoryWithNative', () => { var _a; return (_a = this.nativeParamsService.AndroidBridge) === null || _a === void 0 ? void 0 : _a.setPageSettings(paramsToSend); }, { 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;
             }
         }
@@ -287,7 +286,7 @@ class NativeNavigationAndTitleService {
             const pageIdStr = pageId ? `&pageId=${pageId}` : '';
             const paramsToSend = `ios:setPageSettings/${pageTitleStr + pageIdStr}`;
             if (this.lastSetPageSettingsParams !== paramsToSend) {
-                (_a = this.nativeExecuteService) === null || _a === void 0 ? void 0 : _a.execute('syncHistoryWithNative', () => window.location.replace(paramsToSend), { 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,4 +1,5 @@
-import { type Environment, type LogError, type NativeFeatureKey, type NoopOptions, type Theme } from '../types';
+import { type Environment, type NoopOptions } from '../../types';
+import { type LogError, type NativeFeatureKey, type Theme } from '../types';
 /**
  * Сервис, аккумулирующий детали о NA и предоставляющий методы, связанные с этим.
  */
@@ -24,4 +25,5 @@ export declare class NativeParamsService {
     private getAppId;
     private readNativeParamsCookie;
     private resolveEnvironment;
+    private resolveAppVersion;
 }

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

@@ -14,9 +14,7 @@ class NativeParamsService {
         this.nativeParamsReadErrorFlag = false;
         const nativeParams = this.readNativeParamsCookie();
         this.environment = this.resolveEnvironment();
-        this.appVersion = NativeParamsService.isValidVersionFormat(nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.appVersion)
-            ? nativeParams.appVersion
-            : '0.0.0';
+        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;
@@ -84,5 +82,14 @@ class NativeParamsService {
         }
         return window.Android ? 'android' : 'ios';
     }
+    resolveAppVersion(versionFromCookie) {
+        var _a;
+        if (((_a = this.noop) === null || _a === void 0 ? void 0 : _a.enabled) && this.noop.appVersion) {
+            return this.noop.appVersion;
+        }
+        return NativeParamsService.isValidVersionFormat(versionFromCookie)
+            ? versionFromCookie
+            : '0.0.0';
+    }
 }
 exports.NativeParamsService = NativeParamsService;

package/client/types.d.ts

@@ -3,12 +3,15 @@ export type BrowserHistoryApiWrappers = {
     go?: (delta: number) => void;
     replace?: (url: HistoryReplaceStateParams[2], state: HistoryReplaceStateParams[0]) => void;
 };
-export type Environment = 'android' | 'ios';
 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,8 +21,4 @@ export type NativeFeaturesFromVersion = Readonly<{
 }>;
 export type PdfType = 'pdfFile' | 'base64' | 'binary';
 export type Theme = 'light' | 'dark';
-export type NoopOptions = {
-    enabled: boolean;
-    environment?: Environment;
-};
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfalab/bridge-to-native",
-  "version": "1.4.1-beta.52a0437",
+  "version": "1.4.1-beta.720f0f8",
   "license": "MIT",
   "description": "Утилита для удобной работы веб приложения внутри нативного приложения и коммуникации с ним.",
   "engines": {

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:
 // * Исследовать, делает ли оно это при запросах к прочим ресурсам;

package/server/is-webview-env.js

@@ -10,23 +10,21 @@ const utils_1 = require("./utils");
  * @param request Объект запроса (Request или IncomingMessage).
  */
 function isWebviewEnv(request) {
-    const appVersion = (0, utils_1.getHeaderValue)(request, query_and_headers_keys_1.HEADER_KEY_NATIVE_APPVERSION);
-    const userAgent = (0, utils_1.getHeaderValue)(request, query_and_headers_keys_1.HEADER_KEY_USER_AGENT);
-    const isWebviewByHeaders = 
-    // `app-version` в заголовках — основной индикатор запроса из вебвью.
-    (appVersion && regexp_patterns_1.versionPattern.test(appVersion)) ||
-        // Проверка «на всякий случай» для iOS — нет уверенности,
-        // что `app-version` стабильно и на всех версиях есть во всех запросах из вебвью.
-        (userAgent && regexp_patterns_1.webviewUaIOSPattern.test(userAgent));
-    if (isWebviewByHeaders)
-        return true;
-    const isBrowserEnv = userAgent && !regexp_patterns_1.webviewUaIOSPattern.test(userAgent) && !appVersion;
-    if (isBrowserEnv)
-        return false;
     // Выставленная ранее кука — однозначный индикатор вебвью окружения.
     const cookieHeader = (0, utils_1.getHeaderValue)(request, query_and_headers_keys_1.HEADER_KEY_COOKIE);
     if ((0, utils_1.hasBridgeToNativeDataCookie)(cookieHeader)) {
         return true;
     }
+    const appVersion = (0, utils_1.getHeaderValue)(request, query_and_headers_keys_1.HEADER_KEY_NATIVE_APPVERSION);
+    // `app-version` в заголовках — основной индикатор запроса из вебвью.
+    if (appVersion && regexp_patterns_1.versionPattern.test(appVersion)) {
+        return true;
+    }
+    const userAgent = (0, utils_1.getHeaderValue)(request, query_and_headers_keys_1.HEADER_KEY_USER_AGENT);
+    // Проверка «на всякий случай» для iOS — нет уверенности,
+    // что `app-version` стабильно и на всех версиях есть во всех запросах из вебвью.
+    if (userAgent && regexp_patterns_1.webviewUaIOSPattern.test(userAgent)) {
+        return true;
+    }
     return false;
 }

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

@@ -1,4 +1,4 @@
-import { type NativeParams } from '../types';
+import { type NativeParams, type NoopOptions } from '../types';
 import { type UniversalRequest } from './types';
 /**
  * Парсит запрос, доставая из него данные о нативном приложении,
@@ -11,4 +11,4 @@ import { type UniversalRequest } from './types';
  *  Нужно передать функцию, которая средствами используемого веб-сервера добавит заголовок в ответ.
  *  b2native с её помощью добавит `Set-Cookie` заголовок с некоторыми данными для своего клиентского кода.
  */
-export declare function prepareNativeAppDetailsForClient(request: UniversalRequest, setResponseHeader: (headerKey: string, headerValue: string) => void): Partial<NativeParams>;
+export declare function prepareNativeAppDetailsForClient(request: UniversalRequest, setResponseHeader: (headerKey: string, headerValue: string) => void, noop?: NoopOptions): Partial<NativeParams>;

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

@@ -16,15 +16,17 @@ const utils_1 = require("./utils");
  *  Нужно передать функцию, которая средствами используемого веб-сервера добавит заголовок в ответ.
  *  b2native с её помощью добавит `Set-Cookie` заголовок с некоторыми данными для своего клиентского кода.
  */
-function prepareNativeAppDetailsForClient(request, setResponseHeader) {
+function prepareNativeAppDetailsForClient(request, setResponseHeader, noop) {
     // Поскольку вебвью модули имеют особенность сохранять сессионную куку подолгу,
     // даже после перезагрузки устройства или обновления приложения/ОС, ее значение
     // актуализируется при каждом запросе на сервер.
     const cookieHeader = (0, utils_1.getHeaderValue)(request, query_and_headers_keys_1.HEADER_KEY_COOKIE);
     const nativeParamsFromCookie = (0, utils_1.readNativeParamsFromCookie)(cookieHeader);
     const nativeParams = buildNativeParams(request, nativeParamsFromCookie);
-    const serializedNativeParams = encodeURIComponent(JSON.stringify(nativeParams));
-    setResponseHeader('Set-Cookie', `${query_and_headers_keys_1.COOKIE_KEY_BRIDGE_TO_NATIVE_DATA}=${serializedNativeParams}; Path=/`);
+    if (!noop?.enabled) {
+        const serializedNativeParams = encodeURIComponent(JSON.stringify(nativeParams));
+        setResponseHeader('Set-Cookie', `${query_and_headers_keys_1.COOKIE_KEY_BRIDGE_TO_NATIVE_DATA}=${serializedNativeParams}; Path=/`);
+    }
     return nativeParams;
 }
 function buildNativeParams(request, nativeParamsFromCookie) {

package/server/utils.js

@@ -74,6 +74,8 @@ const getBridgeToNativeDataCookie = (cookieHeader) => {
     return undefined;
 };
 exports.getBridgeToNativeDataCookie = getBridgeToNativeDataCookie;
+// export const getBridgeToNativeDataCookie = (cookieHeader: string | null) =>
+//     getCookieValue(cookieHeader, COOKIE_KEY_BRIDGE_TO_NATIVE_DATA);
 /**
  * Возвращает десериализованные данные из `bridgeToNativeData` cookie.
  */
@@ -89,3 +91,10 @@ function readNativeParamsFromCookie(cookieHeader) {
         return null;
     }
 }
+// export function readModeFromCookie(cookieHeader: string | null) {
+//     const mode = getCookieValue(cookieHeader, B2N_MODE);
+//     if (!mode) {
+//         return null;
+//     }
+//     return mode as 'noop' | 'native';
+// }

package/types.d.ts

@@ -7,3 +7,9 @@ export type NativeParams = {
     originalWebviewParams: string;
     webviewLaunchTime?: number;
 };
+export type Environment = 'android' | 'ios';
+export type NoopOptions = {
+    enabled: boolean;
+    environment?: Environment;
+    appVersion?: string;
+};

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

@@ -1,7 +0,0 @@
-import { type Environment, type NoopOptions } from '../types';
-export declare class NativeExecuteService {
-    private isNoop?;
-    private environment?;
-    constructor(isNoop?: NoopOptions["enabled"] | undefined, environment?: Environment | undefined);
-    execute(action: string, fn: () => void, payload?: unknown): void;
-}

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

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NativeExecuteService = void 0;
-class NativeExecuteService {
-    constructor(isNoop, environment) {
-        this.isNoop = isNoop;
-        this.environment = environment;
-    }
-    execute(action, fn, payload) {
-        if (this.isNoop) {
-            console.info(`[B2N noop][${this.environment}] ${action}`, payload);
-            return;
-        }
-        fn();
-    }
-}
-exports.NativeExecuteService = NativeExecuteService;