@alfalab/bridge-to-native 0.2.2 → 1.0.1

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

@@ -0,0 +1,70 @@
+ 
+import { type BrowserHistoryApiWrappers, type HistoryPushStateParams, type LocationAssignParam, type LogError } from '../types';
+import { type NativeParamsService } from './native-params-service';
+/**
+ * Сервис, отвечающий за взаимодействие WA с WV компонентами NA —
+ * «заголовком» и кнопкой «назад».
+ */
+export declare class NativeNavigationAndTitleService {
+    private nativeParamsService;
+    private browserHistoryApiWrappers?;
+    private logError?;
+    private nativeHistoryStack;
+    private numOfBackSteps;
+    private lastSetPageSettingsParams;
+    constructor(nativeParamsService: NativeParamsService, browserHistoryApiWrappers?: BrowserHistoryApiWrappers | undefined, logError?: LogError | undefined);
+    closeWebview(): void;
+    goBack(): void;
+    goBackAFewStepsClientSide(stepsNumber: number, autoCloseWebview?: boolean): void;
+    navigateClientSide(url: HistoryPushStateParams[2], state?: HistoryPushStateParams[0], nativeTitle?: string): void;
+    navigateServerSide(link: LocationAssignParam, nativeTitle?: string): void;
+    reload(): void;
+    setInitialView(nativeTitle?: string): void;
+    setTitle(nativeTitle: string): void;
+    /**
+     * Метод, вычисляющий `pageId`, который нужно послать в NA
+     * для правильной синхронизации с кнопкой "Назад". Также вычисляет `pageTitle`
+     * для отправки в NA.
+     *
+     * @returns Правильный pageId и pageTitle.
+     */
+    private getNativePageIdAndTitle;
+    /**
+     * Обработчик для `window.onpopstate` события. Который сработает
+     * после нажатия на кнопку «Назад» в NA, вызова `history.back()` и `history.go(-x)`.
+     */
+    private handleClientSideNavigationBack;
+    private static hasSavedHistoryStack;
+    /**
+     * Инициализирует `nativeHistoryStack`, учитывая варианты:
+     * - Инициализация при открытии WV (Сценарий 1);
+     * - Инициализация при server-side навигации в рамках одной WV-сессии (Сценарий 2);
+     * - Инициализация при server-side переходе «назад» по истории (Сценарий 3).
+     */
+    private initializeNativeHistoryStack;
+    /**
+     * Подготавливает ссылку для корректного перехода server-side навигацией.
+     *
+     * @param url URL для перехода внутри WA server-side навигацией.
+     * @return Подготовленная ссылка для экземпляра B2N следующего WA или
+     * экзепляра B2N следующей страницы текущего WA
+     */
+    private prepareExternalLinkBeforeOpen;
+    /**
+     * Читает сохраннённый в sessionStorage `nativeHistoryStack`,
+     * снова сохраняет его в sessionStorage, уменьшая список на одну запись,
+     * на случай, если будет дальнейший переход назад server-side навигацией.
+     *
+     * @returns Актуальное состояние `nativeHistoryStack` из sessionStorage.
+     */
+    private readAndUpdateNativeHistoryStackSessionStorage;
+    /**
+     * Сохранение состояния связи текущего WA с NA при server-side навигации в sessionStorage.
+     */
+    private saveNativeHistoryStack;
+    /**
+     * Синхронизирует состояние истории переходов и заголовок с NA в соответствии
+     * с `nativeHistoryStack`.
+     */
+    private syncHistoryWithNative;
+}

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

@@ -0,0 +1,236 @@
+"use strict";
+/* eslint max-lines: ["error", {"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");
+/**
+ * Сервис, отвечающий за взаимодействие WA с WV компонентами NA —
+ * «заголовком» и кнопкой «назад».
+ */
+class NativeNavigationAndTitleService {
+    constructor(nativeParamsService, browserHistoryApiWrappers, logError) {
+        this.nativeParamsService = nativeParamsService;
+        this.browserHistoryApiWrappers = browserHistoryApiWrappers;
+        this.logError = logError;
+        // Поле, помогающее правильно обработать переход «назад» на несколько шагов.
+        this.numOfBackSteps = 1;
+        // Здесь сохраняются параметры, которые в последний раз были отправлены
+        // в NA. Помогает предотвратить повторную отправку одинаковых параметров.
+        this.lastSetPageSettingsParams = '';
+        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)();
+    }
+    goBack() {
+        this.goBackAFewStepsClientSide(-1, true);
+    }
+    goBackAFewStepsClientSide(stepsNumber, autoCloseWebview = false) {
+        var _a;
+        if (!stepsNumber) {
+            return;
+        }
+        const stepsToBack = Math.abs(stepsNumber);
+        const maxStepsToBack = this.nativeHistoryStack.length - 1;
+        if (stepsToBack > maxStepsToBack) {
+            if (autoCloseWebview) {
+                (0, close_webview_util_1.closeWebviewUtil)();
+                return;
+            }
+            this.numOfBackSteps = maxStepsToBack;
+        }
+        else {
+            this.numOfBackSteps = stepsToBack;
+        }
+        const steps = -this.numOfBackSteps;
+        if ((_a = this.browserHistoryApiWrappers) === null || _a === void 0 ? void 0 : _a.go) {
+            this.browserHistoryApiWrappers.go(steps);
+        }
+        else {
+            window.history.go(steps);
+        }
+        // Далее сработает подписка на `popstate`, см. метод `handleClientSideNavigationBack`.
+    }
+    navigateClientSide(url, state = null, nativeTitle = '') {
+        var _a, _b;
+        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);
+        }
+        else {
+            window.history.pushState(state, '', url);
+        }
+        this.nativeHistoryStack.push(nativeTitle);
+        this.syncHistoryWithNative();
+    }
+    navigateServerSide(link, nativeTitle = '') {
+        const url = link instanceof URL ? link : new URL(link);
+        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() {
+        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=/`;
+    }
+    setInitialView(nativeTitle = '') {
+        this.nativeHistoryStack = [nativeTitle];
+        this.syncHistoryWithNative();
+    }
+    setTitle(nativeTitle) {
+        this.nativeHistoryStack[this.nativeHistoryStack.length - 1] = nativeTitle;
+        this.syncHistoryWithNative();
+    }
+    /**
+     * Метод, вычисляющий `pageId`, который нужно послать в NA
+     * для правильной синхронизации с кнопкой "Назад". Также вычисляет `pageTitle`
+     * для отправки в NA.
+     *
+     * @returns Правильный pageId и pageTitle.
+     */
+    getNativePageIdAndTitle() {
+        // * В iOS для "первой" страницы не нужно слать `pageId`.
+        // * В Android важно, чтобы `pageId` «первой» страницы
+        //  всегда был одинаковый.
+        const stackSize = this.nativeHistoryStack.length;
+        const pageTitle = this.nativeHistoryStack[this.nativeHistoryStack.length - 1];
+        if (this.nativeParamsService.environment === 'android') {
+            return { pageId: stackSize <= 1 ? 1 : stackSize, pageTitle };
+        }
+        return { pageId: stackSize <= 1 ? null : stackSize, pageTitle };
+    }
+    /**
+     * Обработчик для `window.onpopstate` события. Который сработает
+     * после нажатия на кнопку «Назад» в NA, вызова `history.back()` и `history.go(-x)`.
+     */
+    handleClientSideNavigationBack() {
+        this.nativeHistoryStack = this.nativeHistoryStack.slice(0, -this.numOfBackSteps);
+        this.numOfBackSteps = 1;
+        if (this.nativeHistoryStack.length < 1) {
+            (0, close_webview_util_1.closeWebviewUtil)();
+            return;
+        }
+        this.syncHistoryWithNative();
+    }
+    static 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() {
+        const { nextPageId, title } = this.nativeParamsService;
+        if (nextPageId) {
+            // Сценарий 2 – `nextPageId` ставит метод `this.navigateServerSide`,
+            // т.е. это инициализация сразу после перехода server-side навигацией.
+            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();
+            }
+            catch (_a) {
+                this.nativeHistoryStack = [''];
+            }
+        }
+        else {
+            // Сценарий 1 - запись в sessionStorage ставит метод `this.navigateServerSide`,
+            // её нет, значит это инициализация сразу после открытия нового WV.
+            this.nativeHistoryStack = [title];
+        }
+        this.syncHistoryWithNative();
+    }
+    /**
+     * Подготавливает ссылку для корректного перехода server-side навигацией.
+     *
+     * @param url URL для перехода внутри WA server-side навигацией.
+     * @return Подготовленная ссылка для экземпляра B2N следующего WA или
+     * экзепляра B2N следующей страницы текущего WA
+     */
+    prepareExternalLinkBeforeOpen(url) {
+        const currentPageId = this.nativeHistoryStack.length;
+        const divider = new URL(url).searchParams.toString() ? '&' : '?';
+        const modifiedUrl = new URL(`${url}${divider}${this.nativeParamsService.originalWebviewParams}`);
+        modifiedUrl.searchParams.set(query_and_headers_keys_1.QUERY_B2N_NEXT_PAGEID, (currentPageId + 1).toString());
+        return modifiedUrl;
+    }
+    /**
+     * Читает сохраннённый в sessionStorage `nativeHistoryStack`,
+     * снова сохраняет его в sessionStorage, уменьшая список на одну запись,
+     * на случай, если будет дальнейший переход назад server-side навигацией.
+     *
+     * @returns Актуальное состояние `nativeHistoryStack` из sessionStorage.
+     */
+    readAndUpdateNativeHistoryStackSessionStorage() {
+        try {
+            const serializedNativeHistoryStack = sessionStorage.getItem(query_and_headers_keys_1.SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK);
+            if (!serializedNativeHistoryStack) {
+                throw new Error();
+            }
+            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;
+        }
+        catch (e) {
+            if (this.logError) {
+                this.logError('Клиентский код B2N не смог восстановить `nativeHistoryStack` из sessionStorage. ' +
+                    'Могут возникнуть проблемы с кнопкой «Назад» в NA.', e);
+            }
+            throw new Error();
+        }
+    }
+    /**
+     * Сохранение состояния связи текущего 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);
+    }
+    /**
+     * Синхронизирует состояние истории переходов и заголовок с NA в соответствии
+     * с `nativeHistoryStack`.
+     */
+    syncHistoryWithNative() {
+        var _a;
+        const { pageId, pageTitle } = this.getNativePageIdAndTitle();
+        if (this.nativeParamsService.environment === 'android') {
+            const narrowedPageId = pageId !== null && pageId !== void 0 ? pageId : 1;
+            const paramsToSend = JSON.stringify({ pageId: narrowedPageId, pageTitle });
+            if (this.lastSetPageSettingsParams !== paramsToSend) {
+                (_a = this.nativeParamsService.AndroidBridge) === null || _a === void 0 ? void 0 : _a.setPageSettings(paramsToSend);
+                this.lastSetPageSettingsParams = paramsToSend;
+            }
+        }
+        else {
+            const pageTitleStr = `?pageTitle=${encodeURIComponent(pageTitle)}`;
+            const pageIdStr = pageId ? `&pageId=${pageId}` : '';
+            const paramsToSend = `ios:setPageSettings/${pageTitleStr + pageIdStr}`;
+            if (this.lastSetPageSettingsParams !== paramsToSend) {
+                window.location.replace(paramsToSend);
+                this.lastSetPageSettingsParams = paramsToSend;
+            }
+        }
+    }
+}
+exports.NativeNavigationAndTitleService = NativeNavigationAndTitleService;

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

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

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

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NativeParamsService = void 0;
+const query_and_headers_keys_1 = require("../../query-and-headers-keys");
+const constants_1 = require("../constants");
+/**
+ * Сервис, аккумулирующий детали о NA и предоставляющий методы, связанные с этим.
+ */
+class NativeParamsService {
+    constructor(logError) {
+        this.logError = logError;
+        this.AndroidBridge = window.Android;
+        this.environment = window.Android ? 'android' : 'ios';
+        this.nativeParamsReadErrorFlag = false;
+        const nativeParams = this.readNativeParamsCookie();
+        this.appVersion = NativeParamsService.isValidVersionFormat(nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.appVersion)
+            ? nativeParams.appVersion
+            : '0.0.0';
+        this.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;
+        this.theme = (nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.theme) === 'dark' ? 'dark' : 'light';
+        this.title = (nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.title) || '';
+    }
+    canUseNativeFeature(feature) {
+        const { fromVersion } = constants_1.NATIVE_FEATURES_FROM_VERSION[this.environment][feature];
+        return this.isCurrentVersionHigherOrEqual(fromVersion);
+    }
+    isCurrentVersionHigherOrEqual(versionToCompare) {
+        if (!NativeParamsService.isValidVersionFormat(versionToCompare)) {
+            return false;
+        }
+        const matchPattern = /(\d+)\.(\d+)\.(\d+)/;
+        const [, ...appVersionComponents] = this.appVersion.match(matchPattern); // Формат версии проверен в конструкторе, можно смело убирать `null` из типа.
+        const [, ...versionToCompareComponents] = versionToCompare.match(matchPattern);
+        for (let i = 0; i < appVersionComponents.length; i++) {
+            if (appVersionComponents[i] !== versionToCompareComponents[i]) {
+                return appVersionComponents[i] >= versionToCompareComponents[i];
+            }
+        }
+        return true;
+    }
+    static isValidVersionFormat(version) {
+        if (!version)
+            return false;
+        const versionPattern = /^\d+\.\d+\.\d+$/;
+        return versionPattern.test(version);
+    }
+    getAppId(knownIosAppId) {
+        if (this.environment !== 'ios') {
+            return constants_1.ANDROID_APP_ID;
+        }
+        if (knownIosAppId) {
+            return knownIosAppId;
+        }
+        const keys = Object.keys(constants_1.VERSION_TO_IOS_APP_ID);
+        const rightKey = [...keys].reverse().find((version) => this.isCurrentVersionHigherOrEqual(version)) ||
+            keys[0];
+        return constants_1.VERSION_TO_IOS_APP_ID[rightKey];
+    }
+    readNativeParamsCookie() {
+        var _a;
+        const allCookies = document.cookie.split(';');
+        const nativeParamsCookie = allCookies.find((c) => c.trim().startsWith(query_and_headers_keys_1.COOKIE_KEY_BRIDGE_TO_NATIVE_DATA));
+        try {
+            const deserializedNativeParams = decodeURIComponent((_a = nativeParamsCookie === null || nativeParamsCookie === void 0 ? void 0 : nativeParamsCookie.split('=')[1]) !== null && _a !== void 0 ? _a : '');
+            return JSON.parse(deserializedNativeParams);
+        }
+        catch (e) {
+            this.nativeParamsReadErrorFlag = true;
+            if (this.logError) {
+                this.logError('Клиентский код B2N не смог получить информацию о NA из cookie. ' +
+                    'Некоторые методы B2N могут работать некорректно', e);
+            }
+            return null;
+        }
+    }
+}
+exports.NativeParamsService = NativeParamsService;

package/client/types.d.ts

@@ -0,0 +1,19 @@
+export type BrowserHistoryApiWrappers = {
+    push?: (url: HistoryPushStateParams[2], state: HistoryPushStateParams[0]) => void;
+    go?: (delta: number) => void;
+};
+export type Environment = 'android' | 'ios';
+export type HistoryPushStateParams = Parameters<typeof window.history.pushState>;
+export type LocationAssignParam = Parameters<typeof window.location.assign>[0];
+export type LogError = (b2nErrorMessage: string, originalError: unknown) => void;
+export type NativeFeatureKey = 'geolocation' | 'linksInBrowser' | 'savedBackStack';
+type NativeFeaturesParams = Readonly<Record<NativeFeatureKey, {
+    fromVersion: string;
+}>>;
+export type NativeFeaturesFromVersion = Readonly<{
+    android: NativeFeaturesParams;
+    ios: NativeFeaturesParams;
+}>;
+export type PdfType = 'pdfFile' | 'base64' | 'binary';
+export type Theme = 'light' | 'dark';
+export {};

package/client/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,121 +1,121 @@
 {
-    "license": "UNLICENSED",
     "name": "@alfalab/bridge-to-native",
-    "version": "0.2.2",
+    "version": "1.0.1",
+    "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"
     },
-    "main": "./index.js",
-    "module": "./esm/index.js",
     "exports": {
-        ".": {
-            "import": "./esm/index.js",
-            "require": "./index.js"
+        "./client": {
+            "import": "./client/index.js",
+            "require": "./client/index.js",
+            "types": "./client/index.d.ts"
         },
-        "./*": {
-            "import": "./esm/*",
-            "require": "./*"
+        "./server": {
+            "import": "./server/index.js",
+            "require": "./server/index.js",
+            "types": "./server/index.d.ts"
         }
     },
     "sideEffects": false,
-    "files": [
-        "*"
-    ],
     "bugs": {
         "url": "https://github.com/core-ds/bridge-to-native/issues"
     },
-    "description": "Утилита для удобной работы веб приложения внутри нативного приложения и коммуникации с ним.",
     "scripts": {
-        "build": "yarn compile",
+        "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",
         "changelog": "bash bin/fill-changelog-file-and-notify-github.sh",
-        "compile": "yarn compile:clean && yarn compile:ts && yarn compile:ts:esm && yarn compile:copy-resources",
-        "compile:copy-package-json": "shx cp package.json .publish/package.json",
-        "compile:copy-resources": "yarn copyfiles -e \"**/*.{[jt]s*(x),snap}\" -e \"**/*.json\" -u 1 \"src/**/*\" .publish",
-        "compile:clean": "shx rm -rf .publish",
-        "compile:ts": "tsc --project tsconfig.build.json",
-        "compile:ts:esm": "tsc --project tsconfig.build.esm.json",
-        "lint:scripts": "eslint \"**/*.{js,jsx,ts,tsx}\" --ext .js,.jsx,.ts,.tsx",
-        "lint": "yarn lint:scripts && prettier --check \"./src/*.{ts,tsx,js,jsx,json}\"",
-        "lint:fix": "yarn lint:scripts --fix",
+        "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\"",
-        "format": "prettier --write \"./**/*.{ts,tsx,js,jsx,css,json}\"",
-        "test": "jest --silent --collect-coverage",
-        "release": "yarn build && npm version \"$VERSION\" --no-git-tag-version && yarn compile:copy-package-json && yarn pub"
+        "release": "yarn build && npm version \"$VERSION\" --no-git-tag-version && yarn build:copy-package-json && yarn pub",
+        "test": "arui-scripts test --silent --collect-coverage"
     },
-    "dependencies": {},
     "devDependencies": {
-        "@types/jest": "27.5.2",
-        "@types/node": "14.14.22",
-        "@typescript-eslint/eslint-plugin": "^5.30.6",
-        "@typescript-eslint/parser": "^5.30.6",
-        "arui-presets-lint": "6.2.0",
-        "arui-scripts": "15.10.3",
+        "@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",
-        "eslint": "^8.20.0",
-        "eslint-config-airbnb": "^19.0.4",
-        "eslint-config-airbnb-typescript": "^17.0.0",
-        "eslint-config-prettier": "^8.5.0",
-        "eslint-import-resolver-typescript": "~3.1.5",
-        "eslint-plugin-dirnames": "^1.0.3",
-        "eslint-plugin-import": "^2.26.0",
-        "eslint-plugin-simple-import-sort": "^7.0.0",
-        "eslint-plugin-unicorn": "^42.0.0",
-        "husky": "^4.3.8",
-        "jest": "27.5.1",
         "jest-junit": "10.0.0",
         "lint-staged": "^12.5.0",
-        "prettier": "^2.7.1",
         "promisify-child-process": "4.1.1",
-        "stylelint": "^14.9.1",
-        "stylelint-config-prettier": "^9.0.3",
-        "ts-jest": "25.3.1",
-        "typescript": "4.5.5",
-        "shx": "0.3.4"
+        "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"
+                }
+            }
+        ]
     },
-    "peerDependencies": {},
     "jest": {
-        "preset": "arui-scripts",
-        "testEnvironment": "jsdom",
-        "testRegex": "/test/.*\\.ts$",
-        "moduleFileExtensions": [
-            "ts",
-            "js"
+        "projects": [
+            {
+                "displayName": "client-tests",
+                "testEnvironment": "@happy-dom/jest-environment",
+                "testPathIgnorePatterns": [
+                    "/__tests__/server/"
+                ]
+            },
+            {
+                "displayName": "server-tests",
+                "testEnvironment": "node",
+                "testPathIgnorePatterns": [
+                    "/__tests__/client/"
+                ]
+            }
         ],
-        "coveragePathIgnorePatterns": [
-            "/node_modules/",
-            "/test/",
-            "/src/index.ts"
-        ],
-        "transformIgnorePatterns": [
-            "node_modules/(?!(uuid)/)"
+        "testRegex": [
+            "__tests__/.*\\.test\\.ts"
         ],
-        "testPathIgnorePatterns": [
+        "coveragePathIgnorePatterns": [
             "/node_modules/",
-            "/test/mock"
+            "/src/(client|server)/index.ts"
         ],
         "reporters": [
-            "jest-junit",
-            "default"
+            "default",
+            "jest-junit"
         ]
     },
-    "jest-junit": {
-        "output": "./test-results.xml"
-    },
     "prettier": "arui-presets-lint/prettier",
-    "eslintConfig": {
-        "extends": "./node_modules/arui-presets-lint/eslint"
-    },
     "stylelint": {
         "extends": "arui-presets-lint/stylelint",
         "ignoreFiles": [
             "coverage/**/*.js"
         ]
     },
-    "commitlint": {
-        "extends": "./node_modules/arui-presets-lint/commitlint"
-    },
     "publishConfig": {
         "registry": "https://registry.npmjs.org"
-    }
+    },
+    "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
 }

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

@@ -0,0 +1,12 @@
+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 QUERY_B2N_NEXT_PAGEID = "b2n-next-page-id";
+export declare const QUERY_B2N_TITLE = "b2n-title";
+export declare const QUERY_B2N_TITLE_DEPRECATED = "title";
+export declare const QUERY_NATIVE_IOS_APPID = "applicationId";
+export declare const QUERY_NATIVE_IOS_APPVERSION = "device_app_version";
+export declare const QUERY_NATIVE_THEME = "theme";
+export declare const SS_KEY_BRIDGE_TO_NATIVE_HISTORY_STACK = "bridgeToNativeHistoryStack";