@alfalab/bridge-to-native 1.0.2 → 1.2.0

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

@@ -46,6 +46,10 @@ export declare class BridgeToNative {
      * Тема (светлая/тёмная), в котором работает NA.
      */
     get theme(): import("./types").Theme;
+    /**
+     * Время старта открытия WV экрана в формате timestamp. Значение никак не меняется в процессе всей жизни WV экрана.
+     */
+    get webviewLaunchTime(): number | null;
     /**
      * Метод, проверяющий, можно ли использовать ли указанную функциональность
      * в текущей версии NA.

package/client/bridge-to-native.js

@@ -62,6 +62,12 @@ class BridgeToNative {
     get theme() {
         return this.nativeParamsService.theme;
     }
+    /**
+     * Время старта открытия WV экрана в формате timestamp. Значение никак не меняется в процессе всей жизни WV экрана.
+     */
+    get webviewLaunchTime() {
+        return this.nativeParamsService.webviewLaunchTime;
+    }
     /**
      * Метод, проверяющий, можно ли использовать ли указанную функциональность
      * в текущей версии NA.

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

@@ -15,6 +15,7 @@ export declare class NativeParamsService {
     originalWebviewParams: string | null;
     theme: Theme;
     title: string;
+    webviewLaunchTime: number | null;
     constructor(logError?: LogError | undefined);
     canUseNativeFeature(feature: NativeFeatureKey): boolean;
     isCurrentVersionHigherOrEqual(versionToCompare: string): boolean;

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

@@ -21,6 +21,7 @@ class NativeParamsService {
         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) || '';
+        this.webviewLaunchTime = (nativeParams === null || nativeParams === void 0 ? void 0 : nativeParams.webviewLaunchTime) || null;
     }
     canUseNativeFeature(feature) {
         const { fromVersion } = constants_1.NATIVE_FEATURES_FROM_VERSION[this.environment][feature];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@alfalab/bridge-to-native",
-    "version": "1.0.2",
+    "version": "1.2.0",
     "license": "MIT",
     "description": "Утилита для удобной работы веб приложения внутри нативного приложения и коммуникации с ним.",
     "engines": {
@@ -111,11 +111,12 @@
     "stylelint": {
         "extends": "arui-presets-lint/stylelint",
         "ignoreFiles": [
-            "coverage/**/*.js"
+            "coverage/**/*.js",
+            ".yarn/releases/*"
         ]
     },
     "publishConfig": {
         "registry": "https://registry.npmjs.org"
     },
-    "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
+    "packageManager": "yarn@4.12.0"
 }

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

@@ -3,6 +3,7 @@ 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 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,7 +3,7 @@
  * Ключи стандартных заголовков.
  */
 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_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.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';
 /*
@@ -21,6 +21,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';
 // Флаг, предписывающий клиентскому коду B2N начать связь
 // с нативным приложением с указанного в этом параметре id, а не с 1.
 // Необходимо для server-side навигации.

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

@@ -54,6 +54,7 @@ function parseRequest(request) {
         query_and_headers_keys_1.QUERY_B2N_TITLE_DEPRECATED,
     ]);
     const appVersionFromHeaders = (0, utils_1.getHeaderValue)(request, query_and_headers_keys_1.HEADER_KEY_NATIVE_APPVERSION);
+    const webviewLaunchTime = (0, utils_1.parseHeaderTimestamp)((0, utils_1.getHeaderValue)(request, query_and_headers_keys_1.HEADER_KEY_WV_LAUNCH_TIME));
     const nativeParams = {
         originalWebviewParams,
         theme: theme || 'light',
@@ -84,6 +85,9 @@ function parseRequest(request) {
     else if (typeof deprecatedTitle === 'string') {
         nativeParams.title = deprecatedTitle;
     }
+    if (webviewLaunchTime) {
+        nativeParams.webviewLaunchTime = webviewLaunchTime;
+    }
     return nativeParams;
 }
 // Возвращает результат сравнения темы полученной, из query-параметров

package/server/utils.d.ts

@@ -23,3 +23,9 @@ export declare function getQueryValues(request: UniversalRequest, queryKeys: str
  */
 export declare function hasBridgeToNativeDataCookie(cookieHeader: string | null): boolean;
 export declare function parseCookies(cookieHeader: string): Record<string, string>;
+/**
+ * Преобразует значение из заголовка в timestamp
+ *
+ * @param headerValue Значение заголовка
+ */
+export declare function parseHeaderTimestamp(headerValue: string | number | null): number | null;

package/server/utils.js

@@ -4,6 +4,7 @@ exports.getHeaderValue = getHeaderValue;
 exports.getQueryValues = getQueryValues;
 exports.hasBridgeToNativeDataCookie = hasBridgeToNativeDataCookie;
 exports.parseCookies = parseCookies;
+exports.parseHeaderTimestamp = parseHeaderTimestamp;
 const regexp_patterns_1 = require("./regexp-patterns");
 /**
  * На основе объекта запроса любого типа возвращает
@@ -51,3 +52,14 @@ function parseCookies(cookieHeader) {
         return acc;
     }, {});
 }
+/**
+ * Преобразует значение из заголовка в timestamp
+ *
+ * @param headerValue Значение заголовка
+ */
+function parseHeaderTimestamp(headerValue) {
+    if (!headerValue || (typeof headerValue === 'string' && !headerValue?.trim()))
+        return null;
+    const timestamp = Number(headerValue);
+    return Number.isFinite(timestamp) ? timestamp : null;
+}

package/types.d.ts

@@ -5,4 +5,5 @@ export type NativeParams = {
     theme: string;
     nextPageId: number | null;
     originalWebviewParams: string;
+    webviewLaunchTime?: number;
 };