@alfalab/bridge-to-native 1.3.2 → 1.4.0-beta.7b254fa

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

@@ -1,5 +1,5 @@
  
-import { type BrowserHistoryApiWrappers, type HistoryPushStateParams, type LocationAssignParam, type LogError, type NativeFeatureKey, type PdfType } from './types';
+import { type BrowserHistoryApiWrappers, type HistoryPushStateParams, type HistoryReplaceStateParams, type LocationAssignParam, type LogError, type NativeFeatureKey, type PdfType } from './types';
 /**
  * Сервис, предоставляет методы для WA, работающего внутри NA.
  */
@@ -90,16 +90,27 @@ export declare class BridgeToNative {
      * чтобы в дальнейшем зарегистрировать этот переход в NA.
      *
      * ВАЖНО!
-     * Метод можно использовать только в рамках истории по SPA WA! Движение назад
-     * server-side переходом на несколько шагов не поддерживается.
+     * До версии `1.4.0` метод назывался `goBackAFewStepsClientSide` и его можно
+     * было использовать только в рамках SPA истории.
      *
-     * Снять это ограничение возможно, но нужны доработки.
+     * После переименования этот метод можно использовать без ограничей, НО С УСЛОВИЕМ,
+     * что в потребителях B2N нет прямых вызовов `history.replaceState` (или оберток над ним,
+     * типа `history.replace` из ReactRouter). А вместо прямых вызовов используется
+     * метод B2N `replaceHistoryState`. Который под капотом вызывает `history.replaceState`
+     * или вашу собственную «обертку» над ним (см. `browserHistoryApiWrappers` в конструкторе).
+     *
+     * Если это условие не соблюдается, как и раньше, метод можно использовать
+     * только в рамках истории по SPA WA.
      *
      * @param stepsNumber Количество шагов назад.
      *  Возможно передача как положительного, так и отрицательного числа. `0` будет проигнорирован.
      * @param autoCloseWebview Флаг — закрывать ли WV автоматически,
      *  если переданное кол-во шагов будет больше, чем записей в истории.
      */
+    goBackAFewSteps(stepsNumber: number, autoCloseWebview?: boolean): void;
+    /**
+     * @deprecated Используйте `goBackAFewSteps`.
+     */
     goBackAFewStepsClientSide(stepsNumber: number, autoCloseWebview?: boolean): void;
     /**
      * Вызывает обработчик диплинков NA для обработки переданного диплинка.
@@ -138,6 +149,7 @@ export declare class BridgeToNative {
      *
      * @param url URL для перехода внутри WA client-side навигацией.
      * @param state <https://developer.mozilla.org/en-US/docs/Web/API/History/state> для новой записи в истории.
+     *  Должен быть объектом или `null`. Примитивы (строка, число и т.п.) будут потеряны.
      * @param nativeTitle Текст заголовка, для «нативной» части WV, пустая строка — отсутствие заголовка.
      */
     navigateClientSide(url: HistoryPushStateParams[2], state?: HistoryPushStateParams[0], nativeTitle?: string): void;
@@ -147,15 +159,13 @@ export declare class BridgeToNative {
      * экзепляру B2N следующей страницы текущего WA (в случае multi-page application).
      *
      * ВАЖНО!
+     * С версии `1.4.0` появилась возможность использовать `goBackAFewSteps`
+     * через границу server-side (hard) навигации (включая переходы на другие origin).
+     * Но с условием, см. описание `goBackAFewSteps`.
      *
-     * Не поддерживаются такие сценарии:
-     *
-     * 1. Микс client-side навигации и server-side навигации в рамках одного WA.
-     *  т.е. одно WA должно использовать либо только `navigateClientSide`, либо только `navigateServerSide`.
-     * 2. Старт в WA 1 → переход к WA 2 → переход к WA 1,
-     *  т.е. при использовании server-side навигации, история переходов разных WA не должна смешиваться.
-     *
-     * Снять эти ограничения возможно, но нужны доработки.
+     * ВАЖНО!
+     * До версии `1.4.0` метод имел ограничения, которые останутся, если переходить на WA,
+     * которое использует B2N версии < `1.4.0`.
      *
      * @param url URL для перехода внутри WA server-side навигацией.
      * @param nativeTitle Текст заголовка, для «нативной» части WV, пустая строка — отсутствие заголовка.
@@ -204,12 +214,20 @@ export declare class BridgeToNative {
      */
     openPdf(url: string, type?: PdfType, title?: string): void;
     /**
-     * Для перезагрузки страницы необходимо использовать этот метод.
-     * Иначе синхронизация состояния с NA будет потеряна.
-     * По умолчанию метод сам делает location.reload,
-     * но с помощью аргумента можно отключить этот вызов
+     * @deprecated Используйте `window.location.reload()` напрямую.
+     * B2N больше не требует специального метода для перезагрузки.
      */
     reload(skipReload?: boolean): void;
+    /**
+     * Позволяет изменить `history.state` и/или URL текущей записи без потери служебного свойства B2N.
+     * Используйте этот метод вместо прямого вызова `history.replaceState`.
+     * Прямой вызов `history.replaceState` приведёт к потере `b2n-pageId` и нарушит работу навигации.
+     *
+     * @param url URL для замены.
+     * @param state <https://developer.mozilla.org/en-US/docs/Web/API/History/state>.
+     *  Должен быть объектом или `null`. Примитивы (строка, число и т.п.) будут потеряны.
+     */
+    replaceHistoryState(url?: HistoryReplaceStateParams[2], state?: HistoryReplaceStateParams[0]): void;
     /**
      * Информирует NA, что WA находится на первом экране. Это приведёт к тому,
      * что следующее нажатие на кнопку «Назад» в NA закроет WV.

package/client/bridge-to-native.js

@@ -116,18 +116,31 @@ class BridgeToNative {
      * чтобы в дальнейшем зарегистрировать этот переход в NA.
      *
      * ВАЖНО!
-     * Метод можно использовать только в рамках истории по SPA WA! Движение назад
-     * server-side переходом на несколько шагов не поддерживается.
+     * До версии `1.4.0` метод назывался `goBackAFewStepsClientSide` и его можно
+     * было использовать только в рамках SPA истории.
      *
-     * Снять это ограничение возможно, но нужны доработки.
+     * После переименования этот метод можно использовать без ограничей, НО С УСЛОВИЕМ,
+     * что в потребителях B2N нет прямых вызовов `history.replaceState` (или оберток над ним,
+     * типа `history.replace` из ReactRouter). А вместо прямых вызовов используется
+     * метод B2N `replaceHistoryState`. Который под капотом вызывает `history.replaceState`
+     * или вашу собственную «обертку» над ним (см. `browserHistoryApiWrappers` в конструкторе).
+     *
+     * Если это условие не соблюдается, как и раньше, метод можно использовать
+     * только в рамках истории по SPA WA.
      *
      * @param stepsNumber Количество шагов назад.
      *  Возможно передача как положительного, так и отрицательного числа. `0` будет проигнорирован.
      * @param autoCloseWebview Флаг — закрывать ли WV автоматически,
      *  если переданное кол-во шагов будет больше, чем записей в истории.
      */
+    goBackAFewSteps(stepsNumber, autoCloseWebview = false) {
+        this.nativeNavigationAndTitleService.goBackAFewSteps(stepsNumber, autoCloseWebview);
+    }
+    /**
+     * @deprecated Используйте `goBackAFewSteps`.
+     */
     goBackAFewStepsClientSide(stepsNumber, autoCloseWebview = false) {
-        this.nativeNavigationAndTitleService.goBackAFewStepsClientSide(stepsNumber, autoCloseWebview);
+        this.goBackAFewSteps(stepsNumber, autoCloseWebview);
     }
     /**
      * Вызывает обработчик диплинков NA для обработки переданного диплинка.
@@ -170,6 +183,7 @@ class BridgeToNative {
      *
      * @param url URL для перехода внутри WA client-side навигацией.
      * @param state <https://developer.mozilla.org/en-US/docs/Web/API/History/state> для новой записи в истории.
+     *  Должен быть объектом или `null`. Примитивы (строка, число и т.п.) будут потеряны.
      * @param nativeTitle Текст заголовка, для «нативной» части WV, пустая строка — отсутствие заголовка.
      */
     navigateClientSide(url, state, nativeTitle = '') {
@@ -181,15 +195,13 @@ class BridgeToNative {
      * экзепляру B2N следующей страницы текущего WA (в случае multi-page application).
      *
      * ВАЖНО!
+     * С версии `1.4.0` появилась возможность использовать `goBackAFewSteps`
+     * через границу server-side (hard) навигации (включая переходы на другие origin).
+     * Но с условием, см. описание `goBackAFewSteps`.
      *
-     * Не поддерживаются такие сценарии:
-     *
-     * 1. Микс client-side навигации и server-side навигации в рамках одного WA.
-     *  т.е. одно WA должно использовать либо только `navigateClientSide`, либо только `navigateServerSide`.
-     * 2. Старт в WA 1 → переход к WA 2 → переход к WA 1,
-     *  т.е. при использовании server-side навигации, история переходов разных WA не должна смешиваться.
-     *
-     * Снять эти ограничения возможно, но нужны доработки.
+     * ВАЖНО!
+     * До версии `1.4.0` метод имел ограничения, которые останутся, если переходить на WA,
+     * которое использует B2N версии < `1.4.0`.
      *
      * @param url URL для перехода внутри WA server-side навигацией.
      * @param nativeTitle Текст заголовка, для «нативной» части WV, пустая строка — отсутствие заголовка.
@@ -246,13 +258,26 @@ class BridgeToNative {
         this.externalLinksService.openPdf(url, type, title);
     }
     /**
-     * Для перезагрузки страницы необходимо использовать этот метод.
-     * Иначе синхронизация состояния с NA будет потеряна.
-     * По умолчанию метод сам делает location.reload,
-     * но с помощью аргумента можно отключить этот вызов
+     * @deprecated Используйте `window.location.reload()` напрямую.
+     * B2N больше не требует специального метода для перезагрузки.
      */
+    // eslint-disable-next-line class-methods-use-this -- метод оставлен для обратной совместимости.
     reload(skipReload) {
-        this.nativeNavigationAndTitleService.reload(skipReload);
+        if (!skipReload) {
+            window.location.reload();
+        }
+    }
+    /**
+     * Позволяет изменить `history.state` и/или URL текущей записи без потери служебного свойства B2N.
+     * Используйте этот метод вместо прямого вызова `history.replaceState`.
+     * Прямой вызов `history.replaceState` приведёт к потере `b2n-pageId` и нарушит работу навигации.
+     *
+     * @param url URL для замены.
+     * @param state <https://developer.mozilla.org/en-US/docs/Web/API/History/state>.
+     *  Должен быть объектом или `null`. Примитивы (строка, число и т.п.) будут потеряны.
+     */
+    replaceHistoryState(url, state = null) {
+        this.nativeNavigationAndTitleService.replaceHistoryState(url, state);
     }
     /**
      * Информирует NA, что WA находится на первом экране. Это приведёт к тому,

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

@@ -6,10 +6,12 @@ import { type NativeParamsService } from './native-params-service';
  */
 export declare class ExternalLinksService {
     private nativeParamsService;
+    private navigationByNativeAppInProgress;
     constructor(nativeParamsService: NativeParamsService);
     handleNativeDeeplink(deeplink: string, closeWebviewBeforeCallNativeDeeplinkHandler?: boolean): void;
     getHrefToOpenInBrowser(link: string): string;
     openInBrowser(link: string): void;
     openInNewWebview(link: string, nativeTitle?: string, closeCurrentWebview?: boolean): void;
     openPdf(url: string, type?: PdfType, title?: string): void;
+    private navigateByNativeApp;
 }

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

@@ -3,7 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExternalLinksService = void 0;
 const query_and_headers_keys_1 = require("../../query-and-headers-keys");
 const constants_1 = require("../constants");
-const close_webview_util_1 = require("./close-webview-util");
+const 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';
 /**
@@ -13,18 +14,26 @@ const QUERY_OPEN_IN_BROWSER_VALUE = 'true';
 class ExternalLinksService {
     constructor(nativeParamsService) {
         this.nativeParamsService = nativeParamsService;
+        this.navigationByNativeAppInProgress = false;
     }
     handleNativeDeeplink(deeplink, closeWebviewBeforeCallNativeDeeplinkHandler = false) {
+        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;
         if (closeWebviewBeforeCallNativeDeeplinkHandler &&
             this.nativeParamsService.canUseNativeFeature('savedBackStack')) {
-            (0, close_webview_util_1.closeWebviewUtil)();
+            (0, utils_1.closeWebviewUtil)();
             // Проверено, ОС получает диплинк и передаёт его NA, не смотря на то,
             // что это происходит в следующей макрозадаче после команды на закрытие WV.
-            setTimeout(() => window.location.replace(`${this.nativeParamsService.appId}://${clearedDeeplinkPath}`), 0);
+            setTimeout(() => window.location.replace(preparedNativeUrl), 0);
             return;
         }
-        window.location.replace(`${this.nativeParamsService.appId}://${clearedDeeplinkPath}`);
+        this.navigateByNativeApp(preparedNativeUrl);
     }
     getHrefToOpenInBrowser(link) {
         if (!this.nativeParamsService.canUseNativeFeature('linksInBrowser')) {
@@ -35,13 +44,16 @@ class ExternalLinksService {
         return url.href;
     }
     openInBrowser(link) {
+        if (this.navigationByNativeAppInProgress) {
+            return;
+        }
         if (!this.nativeParamsService.canUseNativeFeature('linksInBrowser')) {
             this.openInNewWebview(link);
             return;
         }
         const url = new URL(link);
         url.searchParams.append(QUERY_OPEN_IN_BROWSER_KEY, QUERY_OPEN_IN_BROWSER_VALUE);
-        window.location.replace(url.href);
+        this.navigateByNativeApp(url.href);
     }
     openInNewWebview(link, nativeTitle = '', closeCurrentWebview = false) {
         const url = new URL(link);
@@ -51,6 +63,9 @@ class ExternalLinksService {
         this.handleNativeDeeplink(`/webFeature?type=recommendation&url=${encodeURIComponent(url.toString())}`, closeCurrentWebview);
     }
     openPdf(url, type = 'pdfFile', title) {
+        if (this.navigationByNativeAppInProgress) {
+            return;
+        }
         let replaceUrl = url;
         if (this.nativeParamsService.environment === 'ios') {
             const params = new URLSearchParams();
@@ -62,10 +77,18 @@ class ExternalLinksService {
             const paramsStr = params.toString();
             replaceUrl = `${this.nativeParamsService.appId}:///dashboard/pdf_viewer?${paramsStr}`;
         }
-        const windowObjectReference = window.open(replaceUrl);
-        if (windowObjectReference === null) {
-            window.location.replace(replaceUrl);
-        }
+        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);
     }
 }
 exports.ExternalLinksService = ExternalLinksService;

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

@@ -1,24 +1,28 @@
- 
 import { type BrowserHistoryApiWrappers, type HistoryPushStateParams, type LocationAssignParam, type LogError } from '../types';
 import { type NativeParamsService } from './native-params-service';
 /**
  * Сервис, отвечающий за взаимодействие WA с WV компонентами NA —
  * «заголовком» и кнопкой «назад».
+ *
+ * Подробное описание сценариев навигации и логики восстановления состояния при hard навигации
+ * см. в документе {@link ./NAVIGATION_SCENARIOS.md}.
  */
 export declare class NativeNavigationAndTitleService {
     private nativeParamsService;
     private browserHistoryApiWrappers?;
     private logError?;
+    private lastSetPageSettingsParams;
     private nativeHistoryStack;
     private numOfBackSteps;
-    private lastSetPageSettingsParams;
+    private isGoBackLocked;
+    private isNavigateServerSideLocked;
     constructor(nativeParamsService: NativeParamsService, browserHistoryApiWrappers?: BrowserHistoryApiWrappers | undefined, logError?: LogError | undefined);
     closeWebview(): void;
     goBack(): void;
-    goBackAFewStepsClientSide(stepsNumber: number, autoCloseWebview?: boolean): void;
+    goBackAFewSteps(stepsNumber: number, autoCloseWebview?: boolean): void;
     navigateClientSide(url: HistoryPushStateParams[2], state?: HistoryPushStateParams[0], nativeTitle?: string): void;
     navigateServerSide(link: LocationAssignParam, nativeTitle?: string): void;
-    reload(skipReload?: boolean): void;
+    replaceHistoryState(url?: HistoryPushStateParams[2], state?: HistoryPushStateParams[0]): void;
     setInitialView(nativeTitle?: string): void;
     setTitle(nativeTitle: string): void;
     /**
@@ -34,14 +38,11 @@ export declare class NativeNavigationAndTitleService {
      * после нажатия на кнопку «Назад» в NA, вызова `history.back()` и `history.go(-x)`.
      */
     private handleClientSideNavigationBack;
-    private static hasSavedHistoryStack;
-    /**
-     * Инициализирует `nativeHistoryStack`, учитывая варианты:
-     * - Инициализация при открытии WV (Сценарий 1);
-     * - Инициализация при server-side навигации в рамках одной WV-сессии (Сценарий 2);
-     * - Инициализация при server-side переходе «назад» по истории (Сценарий 3).
-     */
+    private hasSavedHistoryStack;
     private initializeNativeHistoryStack;
+    private initializeForBackward;
+    private initializeForNewOrigin;
+    private initializeForForward;
     /**
      * Подготавливает ссылку для корректного перехода server-side навигацией.
      *
@@ -50,22 +51,17 @@ export declare class NativeNavigationAndTitleService {
      * экзепляра B2N следующей страницы текущего WA
      */
     private prepareExternalLinkBeforeOpen;
-    private static shouldInitializeFromNextPageId;
-    /**
-     * Читает сохраннённый в sessionStorage `nativeHistoryStack`,
-     * снова сохраняет его в sessionStorage, уменьшая список на одну запись,
-     * на случай, если будет дальнейший переход назад server-side навигацией.
-     *
-     * @returns Актуальное состояние `nativeHistoryStack` из sessionStorage.
-     */
-    private readAndUpdateNativeHistoryStackSessionStorage;
     /**
-     * Сохранение состояния связи текущего WA с NA при server-side навигации в sessionStorage.
+     * Читает и парсит `nativeHistoryStack` из SessionStorage.
+     * При ошибке чтения или парсинга логирует через `logError` и пробрасывает исключение.
      */
+    private readSavedHistoryStack;
     private saveNativeHistoryStack;
     /**
      * Синхронизирует состояние истории переходов и заголовок с NA в соответствии
      * с `nativeHistoryStack`.
      */
     private syncHistoryWithNative;
+    private setHistoryStatePageId;
+    private createStateWithPageId;
 }

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

@@ -1,35 +1,54 @@
 "use strict";
-/* eslint max-lines: ["error", {"skipComments": true}] */ // Много комментариев.
+/* eslint max-lines: ["error", {"max": 350, "skipComments": true}] */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NativeNavigationAndTitleService = void 0;
 const query_and_headers_keys_1 = require("../../query-and-headers-keys");
-const close_webview_util_1 = require("./close-webview-util");
+const utils_1 = require("./utils");
+const NativeHistoryStackStub = 0;
 /**
  * Сервис, отвечающий за взаимодействие WA с WV компонентами NA —
  * «заголовком» и кнопкой «назад».
+ *
+ * Подробное описание сценариев навигации и логики восстановления состояния при hard навигации
+ * см. в документе {@link ./NAVIGATION_SCENARIOS.md}.
  */
 class NativeNavigationAndTitleService {
     constructor(nativeParamsService, browserHistoryApiWrappers, logError) {
         this.nativeParamsService = nativeParamsService;
         this.browserHistoryApiWrappers = browserHistoryApiWrappers;
         this.logError = logError;
-        // Поле, помогающее правильно обработать переход «назад» на несколько шагов.
-        this.numOfBackSteps = 1;
         // Здесь сохраняются параметры, которые в последний раз были отправлены
         // в NA. Помогает предотвратить повторную отправку одинаковых параметров.
         this.lastSetPageSettingsParams = '';
+        // Поле для фолбэк сценария, чтобы не ломать обратную совместимость в версии `1.4.0`.
+        // Фолбэк сцерий используется для потребителей B2N, которые используют
+        // прямые вызовы `history.replaceState` (или обертки над ним, типа `history.replace` из ReactRouter)
+        // вместо нового метода B2N `replaceHistoryState`
+        this.numOfBackSteps = 1;
+        // Предотвращают повторный вызов навигации, пока текущая не завершена.
+        // Без блокировки WV-браузер продолжит показывать исходную страницу,
+        // и повторный вызов может инициировать нежелательную навигацию.
+        // `isGoBackLocked` снимается в `handleClientSideNavigationBack` (popstate) для soft-навигации;
+        // при hard-навигации блокировка снимется автоматически при новой инициализации.
+        this.isGoBackLocked = false;
+        // `isNavigateServerSideLocked` не снимается — после server-side навигации всегда новая инициализация.
+        this.isNavigateServerSideLocked = false;
         this.handleClientSideNavigationBack = this.handleClientSideNavigationBack.bind(this);
         window.addEventListener('popstate', this.handleClientSideNavigationBack); // без отписки т.к. Сервис используется в течение всей жизни WA
         this.initializeNativeHistoryStack();
     }
     // eslint-disable-next-line class-methods-use-this -- удобней использовать метод в контексте экземпляра.
     closeWebview() {
-        (0, close_webview_util_1.closeWebviewUtil)();
+        (0, utils_1.closeWebviewUtil)();
     }
     goBack() {
-        this.goBackAFewStepsClientSide(-1, true);
+        if (this.isGoBackLocked) {
+            return;
+        }
+        this.isGoBackLocked = true;
+        this.goBackAFewSteps(-1, true);
     }
-    goBackAFewStepsClientSide(stepsNumber, autoCloseWebview = false) {
+    goBackAFewSteps(stepsNumber, autoCloseWebview = false) {
         var _a;
         if (!stepsNumber) {
             return;
@@ -38,7 +57,7 @@ class NativeNavigationAndTitleService {
         const maxStepsToBack = this.nativeHistoryStack.length - 1;
         if (stepsToBack > maxStepsToBack) {
             if (autoCloseWebview) {
-                (0, close_webview_util_1.closeWebviewUtil)();
+                (0, utils_1.closeWebviewUtil)();
                 return;
             }
             this.numOfBackSteps = maxStepsToBack;
@@ -56,41 +75,49 @@ class NativeNavigationAndTitleService {
         // Далее сработает подписка на `popstate`, см. метод `handleClientSideNavigationBack`.
     }
     navigateClientSide(url, state = null, nativeTitle = '') {
-        var _a, _b;
+        var _a;
         if ((_a = this.browserHistoryApiWrappers) === null || _a === void 0 ? void 0 : _a.push) {
-            (_b = this.browserHistoryApiWrappers) === null || _b === void 0 ? void 0 : _b.push(url, state);
+            this.browserHistoryApiWrappers.push(url, state);
         }
         else {
             window.history.pushState(state, '', url);
         }
+        this.setHistoryStatePageId(true);
         this.nativeHistoryStack.push(nativeTitle);
+        this.saveNativeHistoryStack();
         this.syncHistoryWithNative();
     }
     navigateServerSide(link, nativeTitle = '') {
+        if (this.isNavigateServerSideLocked) {
+            return;
+        }
+        this.isNavigateServerSideLocked = true;
         const url = link instanceof URL ? link : new URL(link);
+        this.nativeHistoryStack.push(nativeTitle || '');
         if (nativeTitle) {
             url.searchParams.set(query_and_headers_keys_1.QUERY_B2N_TITLE, nativeTitle);
         }
-        // TODO: Предыдущая реализация на iOS открывала новое WV. Возможно, что-то плохо работало,
-        // обязательно протестировать.
         this.saveNativeHistoryStack();
         window.location.assign(this.prepareExternalLinkBeforeOpen(url));
     }
-    reload(skipReload = false) {
-        this.nativeHistoryStack.push(1 /* NativeHistoryStackSpecialValues.TemporaryReloadStub */); // небольшой костыль, чтобы переиспользовать server-side сценарий
-        this.saveNativeHistoryStack();
-        // информация для серверной стороны B2N, что происходит `reload` и парсить запрос на предмет NA параметров не нужно (в нем их скорее всего не будет)
-        document.cookie = `${query_and_headers_keys_1.COOKIE_KEY_BRIDGE_TO_NATIVE_RELOAD}=true; Path=/`;
-        if (!skipReload) {
-            window.location.reload();
+    replaceHistoryState(url, state = null) {
+        var _a;
+        if ((_a = this.browserHistoryApiWrappers) === null || _a === void 0 ? void 0 : _a.replace) {
+            this.browserHistoryApiWrappers.replace(url, state);
         }
+        else {
+            window.history.replaceState(state, '', url);
+        }
+        this.setHistoryStatePageId();
     }
     setInitialView(nativeTitle = '') {
         this.nativeHistoryStack = [nativeTitle];
+        this.saveNativeHistoryStack();
         this.syncHistoryWithNative();
     }
     setTitle(nativeTitle) {
         this.nativeHistoryStack[this.nativeHistoryStack.length - 1] = nativeTitle;
+        this.saveNativeHistoryStack();
         this.syncHistoryWithNative();
     }
     /**
@@ -115,52 +142,81 @@ class NativeNavigationAndTitleService {
      * Обработчик для `window.onpopstate` события. Который сработает
      * после нажатия на кнопку «Назад» в NA, вызова `history.back()` и `history.go(-x)`.
      */
-    handleClientSideNavigationBack() {
-        this.nativeHistoryStack = this.nativeHistoryStack.slice(0, -this.numOfBackSteps);
+    handleClientSideNavigationBack(event) {
+        var _a;
+        this.isGoBackLocked = false;
+        const statePageId = (_a = event === null || event === void 0 ? void 0 : event.state) === null || _a === void 0 ? void 0 : _a[query_and_headers_keys_1.HISTORY_STATE_KEY_B2N_PAGE_ID];
+        if (typeof statePageId === 'number') {
+            this.nativeHistoryStack = this.nativeHistoryStack.slice(0, statePageId);
+        }
+        else {
+            this.nativeHistoryStack = this.nativeHistoryStack.slice(0, -this.numOfBackSteps);
+        }
         this.numOfBackSteps = 1;
         if (this.nativeHistoryStack.length < 1) {
-            (0, close_webview_util_1.closeWebviewUtil)();
+            (0, utils_1.closeWebviewUtil)();
             return;
         }
+        this.saveNativeHistoryStack();
         this.syncHistoryWithNative();
     }
-    static hasSavedHistoryStack() {
+    // eslint-disable-next-line class-methods-use-this -- удобней использовать метод в контексте экземпляра.
+    hasSavedHistoryStack() {
         return sessionStorage.getItem(query_and_headers_keys_1.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK) !== null;
     }
-    /**
-     * Инициализирует `nativeHistoryStack`, учитывая варианты:
-     * - Инициализация при открытии WV (Сценарий 1);
-     * - Инициализация при server-side навигации в рамках одной WV-сессии (Сценарий 2);
-     * - Инициализация при server-side переходе «назад» по истории (Сценарий 3).
-     */
     initializeNativeHistoryStack() {
+        var _a;
         const { nextPageId, title } = this.nativeParamsService;
-        if (nextPageId &&
-            NativeNavigationAndTitleService.shouldInitializeFromNextPageId(nextPageId)) {
-            // Сценарий 2 – `nextPageId` ставит метод `this.navigateServerSide`,
-            // т.е. это инициализация сразу после перехода server-side навигацией.
-            // Если в sessionStorage уже есть стек, используем `nextPageId` только для прямого
-            // перехода "вперёд", когда он на 1 больше сохранённой глубины истории.
-            this.nativeHistoryStack = new Array(nextPageId).fill(0 /* NativeHistoryStackSpecialValues.ServerSideNavigationStub */);
-            this.nativeHistoryStack[this.nativeHistoryStack.length - 1] = title;
-        }
-        else if (NativeNavigationAndTitleService.hasSavedHistoryStack()) {
-            // Сценарий 3 - в sessionStorage есть сохранённый nativeHistoryStack,
-            // значит это инициализация сразу после перехода назад server-side навигацией,
-            // или инициализация после использования метода `reload`.
-            try {
-                this.nativeHistoryStack = this.readAndUpdateNativeHistoryStackSessionStorage();
+        const hasSS = this.hasSavedHistoryStack();
+        const statePageId = (_a = window.history.state) === null || _a === void 0 ? void 0 : _a[query_and_headers_keys_1.HISTORY_STATE_KEY_B2N_PAGE_ID];
+        try {
+            if (typeof statePageId === 'number') {
+                this.nativeHistoryStack = this.initializeForBackward(statePageId, title);
             }
-            catch (_a) {
-                this.nativeHistoryStack = [''];
+            else if (nextPageId && !hasSS) {
+                this.nativeHistoryStack = this.initializeForNewOrigin(nextPageId, title);
+            }
+            else if (nextPageId && hasSS) {
+                this.nativeHistoryStack = this.initializeForForward(nextPageId, title);
+            }
+            else {
+                this.nativeHistoryStack = [title];
             }
         }
-        else {
-            // Сценарий 1 - запись в sessionStorage ставит метод `this.navigateServerSide`,
-            // её нет, значит это инициализация сразу после открытия нового WV.
+        catch (_b) {
             this.nativeHistoryStack = [title];
         }
+        this.saveNativeHistoryStack();
         this.syncHistoryWithNative();
+        this.setHistoryStatePageId();
+    }
+    initializeForBackward(pageId, title) {
+        if (!this.hasSavedHistoryStack()) {
+            return [title];
+        }
+        const savedStack = this.readSavedHistoryStack();
+        const stack = savedStack.slice(0, pageId);
+        stack[stack.length - 1] = title;
+        return stack;
+    }
+    // eslint-disable-next-line class-methods-use-this -- удобней использовать метод в контексте экземпляра.
+    initializeForNewOrigin(nextPageId, title) {
+        const stack = new Array(nextPageId).fill(NativeHistoryStackStub);
+        stack[stack.length - 1] = title;
+        return stack;
+    }
+    initializeForForward(nextPageId, title) {
+        const savedStack = this.readSavedHistoryStack();
+        if (savedStack.length === nextPageId) {
+            savedStack[savedStack.length - 1] = title;
+            return savedStack;
+        }
+        const stack = new Array(nextPageId).fill(NativeHistoryStackStub);
+        for (let i = 0; i < savedStack.length && i < nextPageId; i++) {
+            stack[i] = savedStack[i];
+        }
+        stack[stack.length - 1] = title;
+        return stack;
     }
     /**
      * Подготавливает ссылку для корректного перехода server-side навигацией.
@@ -183,59 +239,29 @@ class NativeNavigationAndTitleService {
         // Таким образом гарантируется, что версию приложения будет видеть следующее WA
         // (заголовок `app-version` может отсутствовать при server-side переходах).
         modifiedUrl.searchParams.set(query_and_headers_keys_1.QUERY_NATIVE_IOS_APPVERSION, appVersion);
-        modifiedUrl.searchParams.set(query_and_headers_keys_1.QUERY_B2N_NEXT_PAGEID, (currentPageId + 1).toString());
+        modifiedUrl.searchParams.set(query_and_headers_keys_1.QUERY_B2N_NEXT_PAGEID, currentPageId.toString());
         return modifiedUrl;
     }
-    static shouldInitializeFromNextPageId(nextPageId) {
-        if (!NativeNavigationAndTitleService.hasSavedHistoryStack()) {
-            return true;
-        }
-        try {
-            const serializedNativeHistoryStack = sessionStorage.getItem(query_and_headers_keys_1.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK);
-            if (!serializedNativeHistoryStack) {
-                return true;
-            }
-            return (nextPageId ===
-                JSON.parse(serializedNativeHistoryStack).length +
-                    1);
-        }
-        catch (_a) {
-            return true;
-        }
-    }
     /**
-     * Читает сохраннённый в sessionStorage `nativeHistoryStack`,
-     * снова сохраняет его в sessionStorage, уменьшая список на одну запись,
-     * на случай, если будет дальнейший переход назад server-side навигацией.
-     *
-     * @returns Актуальное состояние `nativeHistoryStack` из sessionStorage.
+     * Читает и парсит `nativeHistoryStack` из SessionStorage.
+     * При ошибке чтения или парсинга логирует через `logError` и пробрасывает исключение.
      */
-    readAndUpdateNativeHistoryStackSessionStorage() {
+    readSavedHistoryStack() {
+        const serialized = sessionStorage.getItem(query_and_headers_keys_1.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK);
         try {
-            const serializedNativeHistoryStack = sessionStorage.getItem(query_and_headers_keys_1.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK);
-            if (!serializedNativeHistoryStack) {
-                throw new Error();
+            if (!serialized) {
+                throw new Error(`${query_and_headers_keys_1.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK} sessionStorage expected not to be null`);
             }
-            const nativeHistoryStack = JSON.parse(serializedNativeHistoryStack); // происходит внутри оператора `catch`, поэтому кастинг типа приемлем
-            const nativeHistoryStackToSerialize = nativeHistoryStack.slice(0, -1);
-            sessionStorage.setItem(query_and_headers_keys_1.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK, JSON.stringify(nativeHistoryStackToSerialize));
-            if (nativeHistoryStack[nativeHistoryStack.length - 1] ===
-                1 /* NativeHistoryStackSpecialValues.TemporaryReloadStub */) {
-                return nativeHistoryStack.slice(0, -1);
-            }
-            return nativeHistoryStack;
+            return JSON.parse(serialized);
         }
         catch (e) {
             if (this.logError) {
-                this.logError('Клиентский код B2N не смог восстановить `nativeHistoryStack` из sessionStorage. ' +
-                    'Могут возникнуть проблемы с кнопкой «Назад» в NA.', e);
+                this.logError(`Клиентский код B2N не смог получить ${query_and_headers_keys_1.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK} из sessionStorage
+                    Могут возникнуть проблемы с кнопкой «Назад» в NA.`, e);
             }
-            throw new Error();
+            throw e;
         }
     }
-    /**
-     * Сохранение состояния связи текущего WA с NA при server-side навигации в sessionStorage.
-     */
     saveNativeHistoryStack() {
         const serializedNativeHistoryStack = JSON.stringify(this.nativeHistoryStack);
         sessionStorage.setItem(query_and_headers_keys_1.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK, serializedNativeHistoryStack);
@@ -265,5 +291,20 @@ class NativeNavigationAndTitleService {
             }
         }
     }
+    setHistoryStatePageId(useNextPageId = false) {
+        const pageId = useNextPageId
+            ? this.nativeHistoryStack.length + 1
+            : this.nativeHistoryStack.length;
+        const newState = this.createStateWithPageId(window.history.state, pageId);
+        // `b2n-pageId` всегда записывается на верхний уровень через нативный `replaceState`,
+        // а не через wrapper, чтобы wrapper (например, React Router / history) не мог обернуть
+        // его внутрь своего формата и скрыть от B2N при чтении `history.state`.
+        window.history.replaceState(newState, '');
+    }
+    // eslint-disable-next-line class-methods-use-this -- удобней использовать метод в контексте экземпляра.
+    createStateWithPageId(state, pageId) {
+        const isPlainObject = (v) => v !== null && v !== undefined && typeof v === 'object' && !Array.isArray(v);
+        return Object.assign(Object.assign({}, (isPlainObject(state) ? state : {})), { [query_and_headers_keys_1.HISTORY_STATE_KEY_B2N_PAGE_ID]: pageId });
+    }
 }
 exports.NativeNavigationAndTitleService = NativeNavigationAndTitleService;

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

@@ -0,0 +1,2 @@
+export declare function appendFromCurrentQueryParamForIos(nativeUrl: string): string;
+export declare const closeWebviewUtil: () => void;

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

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.closeWebviewUtil = void 0;
+exports.appendFromCurrentQueryParamForIos = appendFromCurrentQueryParamForIos;
+const QUERY_CLOSE_WEBVIEW_KEY = 'closeWebView';
+const QUERY_CLOSE_WEBVIEW_VALUE = 'true';
+const QUERY_FROM_CURRENT_KEY = 'fromCurrent';
+const QUERY_FROM_CURRENT_VALUE = 'true';
+function appendFromCurrentQueryParamForIos(nativeUrl) {
+    const qIndex = nativeUrl.indexOf('?');
+    if (qIndex === -1) {
+        return `${nativeUrl}?${QUERY_FROM_CURRENT_KEY}=${QUERY_FROM_CURRENT_VALUE}`;
+    }
+    const base = nativeUrl.slice(0, qIndex);
+    const query = nativeUrl.slice(qIndex + 1);
+    const params = new URLSearchParams(query);
+    params.set(QUERY_FROM_CURRENT_KEY, QUERY_FROM_CURRENT_VALUE);
+    return `${base}?${params.toString()}`;
+}
+const closeWebviewUtil = () => {
+    const originalPageUrl = new URL(window.location.href);
+    originalPageUrl.searchParams.set(QUERY_CLOSE_WEBVIEW_KEY, QUERY_CLOSE_WEBVIEW_VALUE);
+    window.location.href = originalPageUrl.toString();
+};
+exports.closeWebviewUtil = closeWebviewUtil;

package/client/types.d.ts

@@ -1,9 +1,11 @@
 export type BrowserHistoryApiWrappers = {
     push?: (url: HistoryPushStateParams[2], state: HistoryPushStateParams[0]) => void;
     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';

package/package.json

@@ -1,121 +1,121 @@
 {
-    "name": "@alfalab/bridge-to-native",
-    "version": "1.3.2",
-    "license": "MIT",
-    "description": "Утилита для удобной работы веб приложения внутри нативного приложения и коммуникации с ним.",
-    "engines": {
-        "node": ">=20.19.2",
-        "npm": "please-use-yarn"
+  "name": "@alfalab/bridge-to-native",
+  "version": "1.4.0-beta.7b254fa",
+  "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"
+    "./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"
+      ]
     },
-    "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"
-                }
-            }
-        ]
-    },
-    "jest": {
-        "projects": [
-            {
-                "displayName": "client-tests",
-                "testEnvironment": "@happy-dom/jest-environment",
-                "testPathIgnorePatterns": [
-                    "/__tests__/server/"
-                ]
-            },
-            {
-                "displayName": "server-tests",
-                "testEnvironment": "node",
-                "testPathIgnorePatterns": [
-                    "/__tests__/client/"
-                ]
-            }
-        ],
-        "testRegex": [
-            "__tests__/.*\\.test\\.ts"
+    "overrides": [
+      {
+        "files": [
+          "__tests__/**/*"
         ],
-        "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"
+    ],
+    "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.d.ts

@@ -1,9 +1,9 @@
 export declare const HEADER_KEY_COOKIE = "cookie";
 export declare const HEADER_KEY_USER_AGENT = "user-agent";
 export declare const COOKIE_KEY_BRIDGE_TO_NATIVE_DATA = "bridgeToNativeData";
-export declare const COOKIE_KEY_BRIDGE_TO_NATIVE_RELOAD = "bridgeToNativeReload";
 export declare const HEADER_KEY_NATIVE_APPVERSION = "app-version";
 export declare const HEADER_KEY_WV_LAUNCH_TIME = "webview-launch-time";
+export declare const HISTORY_STATE_KEY_B2N_PAGE_ID = "b2n-pageId";
 export declare const QUERY_B2N_NEXT_PAGEID = "b2n-next-page-id";
 export declare const QUERY_B2N_TITLE = "b2n-title";
 export declare const QUERY_B2N_TITLE_DEPRECATED = "title";

package/query-and-headers-keys.js

@@ -3,32 +3,33 @@
  * Ключи стандартных заголовков.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK = exports.QUERY_NATIVE_THEME = exports.QUERY_NATIVE_IOS_APPVERSION = exports.QUERY_NATIVE_IOS_APPID = exports.QUERY_B2N_TITLE_DEPRECATED = exports.QUERY_B2N_TITLE = exports.QUERY_B2N_NEXT_PAGEID = exports.HEADER_KEY_WV_LAUNCH_TIME = exports.HEADER_KEY_NATIVE_APPVERSION = exports.COOKIE_KEY_BRIDGE_TO_NATIVE_RELOAD = exports.COOKIE_KEY_BRIDGE_TO_NATIVE_DATA = exports.HEADER_KEY_USER_AGENT = exports.HEADER_KEY_COOKIE = void 0;
+exports.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK = exports.QUERY_NATIVE_THEME = exports.QUERY_NATIVE_IOS_APPVERSION = exports.QUERY_NATIVE_IOS_APPID = exports.QUERY_B2N_TITLE_DEPRECATED = exports.QUERY_B2N_TITLE = exports.QUERY_B2N_NEXT_PAGEID = exports.HISTORY_STATE_KEY_B2N_PAGE_ID = exports.HEADER_KEY_WV_LAUNCH_TIME = exports.HEADER_KEY_NATIVE_APPVERSION = exports.COOKIE_KEY_BRIDGE_TO_NATIVE_DATA = exports.HEADER_KEY_USER_AGENT = exports.HEADER_KEY_COOKIE = void 0;
 exports.HEADER_KEY_COOKIE = 'cookie';
 exports.HEADER_KEY_USER_AGENT = 'user-agent';
 /*
- * Ключи заголовков и query-параметров, которые использует B2N.
+ * Ключи заголовков, query-параметров и пр., которые использует B2N.
  */
 // Ключ cookie, с помощью которого серверная часть B2N передаст на клиент информацию об NA.
 exports.COOKIE_KEY_BRIDGE_TO_NATIVE_DATA = 'bridgeToNativeData';
-// Ключ cookie, указывающий, что запрос выполнен после вызова `bridgeToNative.reload()`.
-// Используется для предотвращения перезаписи cookie bridgeToNativeData, чтобы сохранить
-// актуальные параметры нативного приложения
-exports.COOKIE_KEY_BRIDGE_TO_NATIVE_RELOAD = 'bridgeToNativeReload';
-// Нативное приложение на обеих платформах подмешивает этот заголовок к запросу за HTML.
+// NA на обеих платформах подмешивает этот заголовок к запросу за HTML.
 // TODO:
 // * Исследовать, делает ли оно это при запросах к прочим ресурсам;
 // * Есть подозрение на некоторую нестабильность — возможно делает это
 //  только для первого документа в вебвью-сессии. Исследовать.
 exports.HEADER_KEY_NATIVE_APPVERSION = 'app-version';
-// Ключ заголовка, в котором передается время старта открытия WV экрана в формате timestamp
+// Ключ заголовка, в котором NA передаёт время старта открытия WV экрана в формате timestamp.
 exports.HEADER_KEY_WV_LAUNCH_TIME = 'webview-launch-time';
+// Ключ в history.state, который B2N использует для хранения текущего `pageId`
+// чтобы иметь возможность корректно синхронизироваться с NA после back-навигации.
+exports.HISTORY_STATE_KEY_B2N_PAGE_ID = 'b2n-pageId';
 // Флаг, предписывающий клиентскому коду B2N начать связь
 // с нативным приложением с указанного в этом параметре id, а не с 1.
-// Необходимо для server-side навигации.
+// Необходимо для server-side (hard) навигации.
 exports.QUERY_B2N_NEXT_PAGEID = 'b2n-next-page-id';
-// Query-параметр, с помощью которого можно передать начальное значение
+// Query-параметр, который можно подмешать к URL в диплинке на открытие WV,
+// и с помощью которого можно передать начальное значение
 // для нативного заголовка — в область, которую не рендерит веб.
+// Также некоторые методы навигации B2N используют эту сущность.
 exports.QUERY_B2N_TITLE = 'b2n-title';
 // Deprecated вариант query-параметра 'b2n-title'
 // (т.к. `title` часто может использоваться самим веб-приложением).
@@ -36,18 +37,18 @@ exports.QUERY_B2N_TITLE = 'b2n-title';
 exports.QUERY_B2N_TITLE_DEPRECATED = 'title';
 // NA на iOS передаёт в этом параметре схему,
 // под которым оно зарегистрировано в OS.
-// Известные проблемы:
-// * В старых версиях отсутствует, клиентский код использует хардкод (см. `src/client/constants.ts`);
-// * В тестовых сборках часто нарушена связь!!! Между фактической схемой
-//  и схемой, которая приходит в этом параметре.
-//  Нужно просить iOS разработчика собрать сборку нормально.
+// Некоторые особенности:
+// * В старых версиях отсутствует, клиентский код использует хардкод
+// (см. `VERSION_TO_IOS_APP_ID` в `src/client/constants.ts`);
+// * Тестить WV на iOS надо на группе «B»!!! Иначе NA будет присылать в WA неверную схему,
+//   что приведёт к неработоспособности методов, связанных с передачей диплинков в NA.
+// * В сборках для Симулятора, схема всегда `aweassist`.
 exports.QUERY_NATIVE_IOS_APPID = 'applicationId';
-// Исторически NA на iOS передаёт в этом параметре свою версию.
-// B2N сознательно переиспользует этот query и для server-side переходов в Android,
+// NA на iOS передаёт в этом параметре свою версию.
+// B2N сознательно переиспользует этот query и для server-side (hard) переходов в Android,
 // чтобы не вводить отдельный служебный параметр только для переноса версии между WA.
 exports.QUERY_NATIVE_IOS_APPVERSION = 'device_app_version';
 // NA на обеих платформах в этом параметре передаёт активную тему (светлая/тёмная).
 exports.QUERY_NATIVE_THEME = 'theme';
-// Ключ sesseionStorage, с помощью которого клиентская часть B2N сохраняет своё состояние
-// при server-side навигации.
+// Ключ sessionStorage,в котором клиентская часть B2N сохраняет состояние синхронизации с NA.
 exports.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK = 'bridgeToNativeHistoryStack';

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

@@ -19,21 +19,9 @@ const utils_1 = require("./utils");
 function prepareNativeAppDetailsForClient(request, setResponseHeader) {
     // Поскольку вебвью модули имеют особенность сохранять сессионную куку подолгу,
     // даже после перезагрузки устройства или обновления приложения/ОС, ее значение
-    // актуализируется при каждом запросе на сервер. Исключением является вызов `reload()`.
-    // В этом случае функция возвращает объект с параметрами, полученными из
-    // ранее сохраненной куки, но перезаписываться кука не будет, потому что:
-    // 1) Данных NA в запросе с большой вероятностью не будет;
-    // 2) клиентская сторона сохранит всё, что нужно в SessionStorage
+    // актуализируется при каждом запросе на сервер.
     const cookieHeader = (0, utils_1.getHeaderValue)(request, query_and_headers_keys_1.HEADER_KEY_COOKIE);
     const nativeParamsFromCookie = (0, utils_1.readNativeParamsFromCookie)(cookieHeader);
-    const hasReloadFlag = cookieHeader?.includes(`${query_and_headers_keys_1.COOKIE_KEY_BRIDGE_TO_NATIVE_RELOAD}=true`);
-    if (hasReloadFlag) {
-        setResponseHeader('Set-Cookie', `${query_and_headers_keys_1.COOKIE_KEY_BRIDGE_TO_NATIVE_RELOAD}=false; Max-Age=0; Path=/`);
-        if (nativeParamsFromCookie) {
-            return nativeParamsFromCookie;
-        }
-        return buildNativeParams(request);
-    }
     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=/`);

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

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

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

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