@alfalab/bridge-to-native 1.3.2-beta.9b534a8 → 1.3.2-beta.b39ff6d

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.
  */
@@ -89,12 +89,6 @@ export declare class BridgeToNative {
      * Делает несколько шагов назад по браузерной истории и модифицирует внутреннее состояние,
      * чтобы в дальнейшем зарегистрировать этот переход в NA.
      *
-     * ВАЖНО!
-     * Метод можно использовать только в рамках истории по SPA WA! Движение назад
-     * server-side переходом на несколько шагов не поддерживается.
-     *
-     * Снять это ограничение возможно, но нужны доработки.
-     *
      * @param stepsNumber Количество шагов назад.
      *  Возможно передача как положительного, так и отрицательного числа. `0` будет проигнорирован.
      * @param autoCloseWebview Флаг — закрывать ли WV автоматически,
@@ -138,6 +132,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;
@@ -146,10 +141,6 @@ export declare class BridgeToNative {
      * чтобы корректно передать информацию экземпляру B2N следующего WA или
      * экзепляру B2N следующей страницы текущего WA (в случае multi-page application).
      *
-     * ВАЖНО!
-     * `goBackAFewStepsClientSide` можно использовать только в рамках истории по SPA WA! Движение назад
-     * server-side переходом на несколько шагов не поддерживается.
-     *
      * @param url URL для перехода внутри WA server-side навигацией.
      * @param nativeTitle Текст заголовка, для «нативной» части WV, пустая строка — отсутствие заголовка.
      */
@@ -204,6 +195,16 @@ export declare class BridgeToNative {
      *  но с помощью аргумента можно отключить этот вызов, если нужно.
      */
     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

@@ -115,12 +115,6 @@ class BridgeToNative {
      * Делает несколько шагов назад по браузерной истории и модифицирует внутреннее состояние,
      * чтобы в дальнейшем зарегистрировать этот переход в NA.
      *
-     * ВАЖНО!
-     * Метод можно использовать только в рамках истории по SPA WA! Движение назад
-     * server-side переходом на несколько шагов не поддерживается.
-     *
-     * Снять это ограничение возможно, но нужны доработки.
-     *
      * @param stepsNumber Количество шагов назад.
      *  Возможно передача как положительного, так и отрицательного числа. `0` будет проигнорирован.
      * @param autoCloseWebview Флаг — закрывать ли WV автоматически,
@@ -170,6 +164,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 = '') {
@@ -180,10 +175,6 @@ class BridgeToNative {
      * чтобы корректно передать информацию экземпляру B2N следующего WA или
      * экзепляру B2N следующей страницы текущего WA (в случае multi-page application).
      *
-     * ВАЖНО!
-     * `goBackAFewStepsClientSide` можно использовать только в рамках истории по SPA WA! Движение назад
-     * server-side переходом на несколько шагов не поддерживается.
-     *
      * @param url URL для перехода внутри WA server-side навигацией.
      * @param nativeTitle Текст заголовка, для «нативной» части WV, пустая строка — отсутствие заголовка.
      */
@@ -248,6 +239,18 @@ class BridgeToNative {
     reload(skipReload) {
         this.nativeNavigationAndTitleService.reload(skipReload);
     }
+    /**
+     * Позволяет изменить `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 находится на первом экране. Это приведёт к тому,
      * что следующее нажатие на кнопку «Назад» в NA закроет WV.

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

@@ -12,8 +12,9 @@ export declare class NativeNavigationAndTitleService {
     private browserHistoryApiWrappers?;
     private logError?;
     private nativeHistoryStack;
-    private numOfBackSteps;
     private lastSetPageSettingsParams;
+    private isGoBackLocked;
+    private isNavigateServerSideLocked;
     constructor(nativeParamsService: NativeParamsService, browserHistoryApiWrappers?: BrowserHistoryApiWrappers | undefined, logError?: LogError | undefined);
     closeWebview(): void;
     goBack(): void;
@@ -23,6 +24,9 @@ export declare class NativeNavigationAndTitleService {
     reload(skipReload?: boolean): void;
     setInitialView(nativeTitle?: string): void;
     setTitle(nativeTitle: string): void;
+    replaceHistoryState(url?: HistoryPushStateParams[2], state?: HistoryPushStateParams[0]): void;
+    private createStateWithPageId;
+    private setHistoryStatePageId;
     /**
      * Метод, вычисляющий `pageId`, который нужно послать в NA
      * для правильной синхронизации с кнопкой "Назад". Также вычисляет `pageTitle`
@@ -45,9 +49,6 @@ export declare class NativeNavigationAndTitleService {
     private initializeNativeHistoryStack;
     private initializeForNewOrigin;
     private initializeForForward;
-    private initializeFromBackwardOrReload;
-    private stackContainsCrossOriginMarker;
-    private truncateToLastCrossOriginMarker;
     /**
      * Читает и парсит `nativeHistoryStack` из SessionStorage.
      * При ошибке чтения или парсинга логирует через `logError` и пробрасывает исключение.

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

@@ -4,6 +4,7 @@ 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 NativeHistoryStackStub = 0;
 /**
  * Сервис, отвечающий за взаимодействие WA с WV компонентами NA —
  * «заголовком» и кнопкой «назад».
@@ -16,11 +17,17 @@ class NativeNavigationAndTitleService {
         this.nativeParamsService = nativeParamsService;
         this.browserHistoryApiWrappers = browserHistoryApiWrappers;
         this.logError = logError;
-        // Поле, помогающее правильно обработать переход «назад» на несколько шагов.
-        this.numOfBackSteps = 1;
         // Здесь сохраняются параметры, которые в последний раз были отправлены
         // в NA. Помогает предотвратить повторную отправку одинаковых параметров.
         this.lastSetPageSettingsParams = '';
+        // Предотвращают повторный вызов навигации, пока текущая не завершена.
+        // Без блокировки WV-браузер продолжит показывать исходную страницу,
+        // и повторный вызов может инициировать нежелательную навигацию.
+        // `isGoBackLocked` снимается в `handleClientSideNavigationBack` (popstate) для soft-навигации;
+        // при hard-навигации блокировка снимется автоматически при новой инициализации.
+        // `isNavigateServerSideLocked` не снимается — после server-side навигации всегда новая инициализация.
+        this.isGoBackLocked = false;
+        this.isNavigateServerSideLocked = false;
         this.handleClientSideNavigationBack = this.handleClientSideNavigationBack.bind(this);
         window.addEventListener('popstate', this.handleClientSideNavigationBack); // без отписки т.к. Сервис используется в течение всей жизни WA
         this.initializeNativeHistoryStack();
@@ -30,6 +37,10 @@ class NativeNavigationAndTitleService {
         (0, close_webview_util_1.closeWebviewUtil)();
     }
     goBack() {
+        if (this.isGoBackLocked) {
+            return;
+        }
+        this.isGoBackLocked = true;
         this.goBackAFewStepsClientSide(-1, true);
     }
     goBackAFewStepsClientSide(stepsNumber, autoCloseWebview = false) {
@@ -44,12 +55,8 @@ class NativeNavigationAndTitleService {
                 (0, close_webview_util_1.closeWebviewUtil)();
                 return;
             }
-            this.numOfBackSteps = maxStepsToBack;
-        }
-        else {
-            this.numOfBackSteps = stepsToBack;
         }
-        const steps = -this.numOfBackSteps;
+        const steps = -Math.min(stepsToBack, maxStepsToBack);
         if ((_a = this.browserHistoryApiWrappers) === null || _a === void 0 ? void 0 : _a.go) {
             this.browserHistoryApiWrappers.go(steps);
         }
@@ -59,36 +66,34 @@ class NativeNavigationAndTitleService {
         // Далее сработает подписка на `popstate`, см. метод `handleClientSideNavigationBack`.
     }
     navigateClientSide(url, state = null, nativeTitle = '') {
-        var _a, _b;
+        var _a;
+        const nextPageId = this.nativeHistoryStack.length + 1;
+        const stateWithPageId = this.createStateWithPageId(state, nextPageId);
         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, stateWithPageId);
         }
         else {
-            window.history.pushState(state, '', url);
+            window.history.pushState(stateWithPageId, '', url);
         }
         this.nativeHistoryStack.push(nativeTitle);
         this.saveNativeHistoryStack();
         this.syncHistoryWithNative();
     }
     navigateServerSide(link, nativeTitle = '') {
-        const url = link instanceof URL ? link : new URL(link);
-        const isCrossOrigin = url.origin !== window.location.origin;
-        if (isCrossOrigin) {
-            this.nativeHistoryStack.push(2 /* NativeHistoryStackSpecialValues.ServerSideNavigationNextOrigin */);
-        }
-        else {
-            this.nativeHistoryStack.push(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);
         }
         this.saveNativeHistoryStack();
         window.location.assign(this.prepareExternalLinkBeforeOpen(url));
     }
+    // eslint-disable-next-line class-methods-use-this -- удобней использовать метод в контексте экземпляра.
     reload(skipReload = false) {
-        this.nativeHistoryStack.push(1 /* NativeHistoryStackSpecialValues.TemporaryReloadStub */);
-        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();
@@ -104,6 +109,33 @@ class NativeNavigationAndTitleService {
         this.saveNativeHistoryStack();
         this.syncHistoryWithNative();
     }
+    replaceHistoryState(url, state = null) {
+        var _a;
+        const pageId = this.nativeHistoryStack.length;
+        const stateWithPageId = this.createStateWithPageId(state, pageId);
+        if ((_a = this.browserHistoryApiWrappers) === null || _a === void 0 ? void 0 : _a.replace) {
+            this.browserHistoryApiWrappers.replace(url, stateWithPageId);
+        }
+        else {
+            window.history.replaceState(stateWithPageId, '', url);
+        }
+    }
+    // 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 });
+    }
+    setHistoryStatePageId() {
+        var _a;
+        const pageId = this.nativeHistoryStack.length;
+        const newState = this.createStateWithPageId(window.history.state, pageId);
+        if ((_a = this.browserHistoryApiWrappers) === null || _a === void 0 ? void 0 : _a.replace) {
+            this.browserHistoryApiWrappers.replace(undefined, newState);
+        }
+        else {
+            window.history.replaceState(newState, '');
+        }
+    }
     /**
      * Метод, вычисляющий `pageId`, который нужно послать в NA
      * для правильной синхронизации с кнопкой "Назад". Также вычисляет `pageTitle`
@@ -126,9 +158,16 @@ class NativeNavigationAndTitleService {
      * Обработчик для `window.onpopstate` события. Который сработает
      * после нажатия на кнопку «Назад» в NA, вызова `history.back()` и `history.go(-x)`.
      */
-    handleClientSideNavigationBack() {
-        this.nativeHistoryStack = this.nativeHistoryStack.slice(0, -this.numOfBackSteps);
-        this.numOfBackSteps = 1;
+    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, -1);
+        }
         if (this.nativeHistoryStack.length < 1) {
             (0, close_webview_util_1.closeWebviewUtil)();
             return;
@@ -146,108 +185,56 @@ class NativeNavigationAndTitleService {
      * Подробное описание каждого сценария см. в {@link ./NAVIGATION_SCENARIOS.md}.
      */
     initializeNativeHistoryStack() {
+        var _a;
         const { nextPageId, title } = this.nativeParamsService;
         const hasSS = this.hasSavedHistoryStack();
-        console.log('-------');
-        console.log('Инициализируюсь');
-        if (nextPageId && !hasSS) {
-            // есть nextPageId + нет SS → на этом origin ранее не были.
-            console.log('есть nextPageId + нет SS → на этом origin ранее не были.');
-            this.nativeHistoryStack = this.initializeForNewOrigin(nextPageId, title);
-        }
-        else if (nextPageId && hasSS) {
-            // есть nextPageId + есть SS → forward навигация.
-            console.log('есть nextPageId + есть SS → forward навигация.');
-            this.nativeHistoryStack = this.initializeForForward(nextPageId, title);
-        }
-        else if (!nextPageId && hasSS) {
-            // нет nextPageId + есть SS → back-навигация или reload.
-            console.log('нет nextPageId + есть SS → back-навигация или reload.');
-            this.nativeHistoryStack = this.initializeFromBackwardOrReload(title);
+        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') {
+                const pageId = statePageId;
+                if (hasSS) {
+                    const savedStack = this.readSavedHistoryStack();
+                    this.nativeHistoryStack = savedStack.slice(0, pageId);
+                    this.nativeHistoryStack[this.nativeHistoryStack.length - 1] = title;
+                }
+                else {
+                    this.nativeHistoryStack = [title];
+                }
+            }
+            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 {
-            // нет nextPageId + нет SS → старт нового WV, назад идти некуда.
-            console.log('нет nextPageId + нет SS → старт нового WV, назад идти некуда.');
+        catch (_b) {
             this.nativeHistoryStack = [title];
         }
         this.saveNativeHistoryStack();
         this.syncHistoryWithNative();
+        this.setHistoryStatePageId();
     }
     // eslint-disable-next-line class-methods-use-this -- удобней использовать метод в контексте экземпляра.
     initializeForNewOrigin(nextPageId, title) {
-        const stack = new Array(nextPageId).fill(0 /* NativeHistoryStackSpecialValues.ServerSideNavigationStub */);
+        const stack = new Array(nextPageId).fill(NativeHistoryStackStub);
         stack[stack.length - 1] = title;
-        console.log('nextPageId', nextPageId);
-        console.log('newStack', stack);
         return stack;
     }
     initializeForForward(nextPageId, title) {
-        try {
-            const savedStack = this.readSavedHistoryStack();
-            const lastSaved = savedStack[savedStack.length - 1];
-            if (lastSaved === 2 /* NativeHistoryStackSpecialValues.ServerSideNavigationNextOrigin */ &&
-                savedStack.length < nextPageId) {
-                const stack = new Array(nextPageId).fill(0 /* NativeHistoryStackSpecialValues.ServerSideNavigationStub */);
-                for (let i = 0; i < savedStack.length; i++) {
-                    stack[i] = savedStack[i];
-                }
-                stack[stack.length - 1] = title;
-                console.log('nextPageId', nextPageId);
-                console.log('newStack', stack);
-                return stack;
-            }
-            if (savedStack.length === nextPageId) {
-                savedStack[savedStack.length - 1] = title;
-                console.log('nextPageId', nextPageId);
-                console.log('newStack', savedStack);
-                return savedStack;
-            }
-            return this.initializeForNewOrigin(nextPageId, title);
-        }
-        catch (_a) {
-            return this.initializeForNewOrigin(nextPageId, title);
-        }
-    }
-    initializeFromBackwardOrReload(title) {
-        try {
-            const savedStack = this.readSavedHistoryStack();
-            const lastEntry = savedStack[savedStack.length - 1];
-            if (lastEntry === 1 /* NativeHistoryStackSpecialValues.TemporaryReloadStub */) {
-                savedStack.pop();
-                if (savedStack.length === 0) {
-                    console.log('newStack', [title]);
-                    return [title];
-                }
-                console.log('newStack', savedStack);
-                return savedStack;
-            }
-            if (this.stackContainsCrossOriginMarker(savedStack)) {
-                console.log('newStack', this.truncateToLastCrossOriginMarker(savedStack));
-                return this.truncateToLastCrossOriginMarker(savedStack);
-            }
-            savedStack.pop();
-            if (savedStack.length === 0) {
-                console.log('newStack', [title]);
-                return [title];
-            }
-            console.log('newStack', savedStack);
+        const savedStack = this.readSavedHistoryStack();
+        if (savedStack.length === nextPageId) {
+            savedStack[savedStack.length - 1] = title;
             return savedStack;
         }
-        catch (_a) {
-            return [title];
-        }
-    }
-    // eslint-disable-next-line class-methods-use-this -- удобней использовать метод в контексте экземпляра.
-    stackContainsCrossOriginMarker(stack) {
-        return stack.find((el) => el === 2 /* NativeHistoryStackSpecialValues.ServerSideNavigationNextOrigin */);
-    }
-    // eslint-disable-next-line class-methods-use-this -- удобней использовать метод в контексте экземпляра.
-    truncateToLastCrossOriginMarker(stack) {
-        for (let i = stack.length - 1; i >= 0; i--) {
-            if (stack[i] === 2 /* NativeHistoryStackSpecialValues.ServerSideNavigationNextOrigin */) {
-                return stack.slice(0, i);
-            }
+        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;
     }
     /**
@@ -260,7 +247,6 @@ class NativeNavigationAndTitleService {
             if (!serialized) {
                 throw new Error(`${query_and_headers_keys_1.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK} sessionStorage expected not to be null`);
             }
-            console.log('serializedStack', serialized);
             return JSON.parse(serialized);
         }
         catch (e) {
@@ -300,10 +286,6 @@ class NativeNavigationAndTitleService {
      */
     saveNativeHistoryStack() {
         const serializedNativeHistoryStack = JSON.stringify(this.nativeHistoryStack);
-        console.log('-------');
-        console.log('сохраняю стек');
-        console.log('стек', this.nativeHistoryStack);
-        console.log('сериализованный стек', serializedNativeHistoryStack);
         sessionStorage.setItem(query_and_headers_keys_1.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK, serializedNativeHistoryStack);
     }
     /**

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,6 +1,6 @@
 {
   "name": "@alfalab/bridge-to-native",
-  "version": "1.3.2-beta.9b534a8",
+  "version": "1.3.2-beta.b39ff6d",
   "license": "MIT",
   "description": "Утилита для удобной работы веб приложения внутри нативного приложения и коммуникации с ним.",
   "engines": {

package/query-and-headers-keys.d.ts

@@ -4,6 +4,7 @@ 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,11 +3,11 @@
  * Ключи стандартных заголовков.
  */
 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_RELOAD = 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';
@@ -23,6 +23,8 @@ exports.COOKIE_KEY_BRIDGE_TO_NATIVE_RELOAD = 'bridgeToNativeReload';
 exports.HEADER_KEY_NATIVE_APPVERSION = 'app-version';
 // Ключ заголовка, в котором передается время старта открытия WV экрана в формате timestamp
 exports.HEADER_KEY_WV_LAUNCH_TIME = 'webview-launch-time';
+// Ключ в history.state, хранящий текущий pageId для корректной back-навигации.
+exports.HISTORY_STATE_KEY_B2N_PAGE_ID = 'b2n-pageId';
 // Флаг, предписывающий клиентскому коду B2N начать связь
 // с нативным приложением с указанного в этом параметре id, а не с 1.
 // Необходимо для server-side навигации.