feat(*): fixes after review

src/client/index.ts

@@ -0,0 +1,3 @@
+export { BridgeToNative } from './bridge-to-native';
+export { NativeParams, Theme, Environment, NativeFeatureKey, PdfType } from './types';
+export { getNativeParamsFromCookies } from './utils';

src/client/types.ts

@@ -1,13 +1,6 @@
-export type NativeParams = {
-    appVersion: string;
-    title?: string;
-    // В ранних версиях iOS приложение не пробрасывет схему приложения в URL в прод окружении.
-    // Для таких версий есть мэппинг `./constants` → `versionToIosAppId`.
-    iosAppId?: string;
-    theme: string;
-    nextPageId: number | null;
-    originalWebviewParams: string;
-};
+import { NativeParamsType } from "../shared/types";
+
+export type NativeParams = NativeParamsType;
 
 export type NativeFeatureKey =
     // Возможность работы с геолокацией.

src/client/utils.ts

@@ -1,5 +1,6 @@
 import { Environment } from './types';
 import { ANDROID_APP_ID } from './constants';
+import { extractNativeParamsFromCookies } from "../shared/utils";
 
 /**
  * Разделяет веб ссылку на компоненты
@@ -76,3 +77,8 @@ export const getAppId = (environment: Environment, iosAppId?: string) => {
 
     return null;
 };
+
+/**
+ * Возвращает объект с `webview-параметрами` из cookies
+ */
+export const getNativeParamsFromCookies = (): Record<string, unknown> | null => extractNativeParamsFromCookies(document.cookie);

src/index.ts

@@ -1,2 +1,2 @@
-export { BridgeToNative } from './client/bridge-to-native';
-export { NativeParams, Theme, Environment, NativeFeatureKey, PdfType } from './client/types';
+export * from './client'
+export * from './server';

src/server/constants.ts

@@ -1,13 +1,7 @@
 export const THEME_QUERY = 'theme';
 export const TITLE = 'title';
-
 export const WEBVIEW_IOS_APP_ID_QUERY = 'applicationId';
 export const WEBVIEW_IOS_APP_VERSION_QUERY = 'device_app_version';
 export const WEBVIEW_WITHOUT_LAYOUT_QUERY = 'without_layout';
 export const WEBVIEW_NEXT_PAGE_ID_QUERY = 'nextPageId';
-
-export const CAPSULE_UA_SUBSTR = 'Capsule';
-export const AKEY_UA_SUBSTR = 'AKEY';
-export const VOSKHOD_UA_SUBSTR = 'VOSKHOD';
-
 export const NATIVE_PARAMS_COOKIE_NAME = 'app_native_params';

src/server/extract-and-join-original-webview-params.ts

@@ -18,11 +18,11 @@ const webviewInitParamsDictionary = [
 ];
 
 /**
- * Данная утилита извлекает из Fastify.Query все известные
+ * Данная утилита извлекает из запроса все известные
  * сервисные query параметры которые добавляются к url внутри
  * webview при первой инициализации и собирает их в query строку.
  *
- * @param query - Fastify.Query в формате объекта
+ * @param query - Query в формате объекта
  * @return строка query параметров в формате: "title=Title&theme=dark..."
  * */
 export const extractAndJoinOriginalWebviewParams = (

src/server/detect-and-extract-native-params.ts → src/server/extract-native-params.ts

@@ -5,36 +5,32 @@ import {
     WEBVIEW_IOS_APP_VERSION_QUERY,
     WEBVIEW_NEXT_PAGE_ID_QUERY,
     WEBVIEW_WITHOUT_LAYOUT_QUERY,
-    NATIVE_PARAMS_COOKIE_NAME
 } from './constants';
 
 import { extractAppVersion } from './utils';
 
 import { extractAndJoinOriginalWebviewParams } from './extract-and-join-original-webview-params';
-import { checkIsWebview } from './check-is-webview';
 import { iosAppIdPattern, versionPattern } from './reg-exp-patterns';
 import { EmptyNativeParams, NativeParams, RequestHeaderType } from "./types";
+import {isWebviewEnvironment} from "./is-webview-environment";
 
 /**
  * Вытаскивает из query и headers все детали для вебвью.
  *
  * @returns Примечание по `appVersion`: В вебвью окружении версия всегда имеет формат `x.x.x`.
  */
 
-export const detectAndExtractNativeParams = (
-    request: RequestHeaderType,
-    addCookie?: (cookieKey: string, cookieValue: string) => void
-): EmptyNativeParams | NativeParams => {
-    const isWebview = checkIsWebview(request);
+export const extractNativeParams = (
+    request: RequestHeaderType
+):  NativeParams | null => {
 
-    if (!isWebview) {
-        return { isWebview } as EmptyNativeParams;
+    if(!isWebviewEnvironment(request)) {
+        return null;
     }
 
     const {
         [THEME_QUERY]: themeQuery,
-        // При желании через диплинк на вебвью можно передать желаемый заголовок,
-        // который АО установит в верхней АМ панели при загрузке АО.
+        // При желании через диплинк на вебвью можно передать желаемый заголовок
         // По умолчанию нужна именно пустая строка.
         [TITLE]: title = '',
         // Говорят, этого может и не быть в урле. Формат `com.xxxxxxxxx.app`.
@@ -57,7 +53,7 @@ export const detectAndExtractNativeParams = (
         iosAppId = appIdSubsting;
     }
 
-    // Определяем версию АМ из query или заголовка.
+    // Определяем версию приложения из query или заголовка.
     let appVersion = '0.0.0';
 
     const appVersionFromHeaders = extractAppVersion(request);
@@ -76,17 +72,13 @@ export const detectAndExtractNativeParams = (
     const nativeParams = {
         appVersion,
         iosAppId,
-        isWebview,
+        isWebview: true,
         theme: themeQuery === 'dark' ? 'dark' : 'light',
         title,
         withoutLayout: withoutLayoutQuery === 'true',
         originalWebviewParams,
         nextPageId: nextPageId ? Number(nextPageId) : null,
     } as NativeParams;
 
-    if(addCookie) {
-        addCookie(NATIVE_PARAMS_COOKIE_NAME, encodeURIComponent(JSON.stringify(nativeParams)));
-    }
-
     return nativeParams;
 };

src/server/index.ts

@@ -1,5 +1,4 @@
-export * from './detect-and-extract-native-params';
-export * from './check-is-webview';
+export * from './is-webview-environment';
+export * from './extract-native-params';
+export * from './set-native-params-cookie';
 export * from './types';
-export * from './reg-exp-patterns';
-export * from './extract-and-join-original-webview-params';

src/server/check-is-webview.ts → src/server/is-webview-environment.ts

@@ -1,8 +1,7 @@
 import {
     extractAppVersion,
     extractUserAgent,
-    isAkeyWebview,
-    extractNativeParamsFromCookies
+    extractNativeParamsFromCookieHeader
 } from './utils';
 import { RequestHeaderType } from './types';
 import { versionPattern, webviewUaIOSPattern } from './reg-exp-patterns';
@@ -11,10 +10,6 @@ export const isWebviewByUserAgent = (
     userAgent: string,
     appVersion: string | undefined,
 ) => {
-    if (userAgent && isAkeyWebview(userAgent)) {
-        return false;
-    }
-
     return (
         (appVersion && versionPattern.test(appVersion)) || !!userAgent?.match(webviewUaIOSPattern)
     );
@@ -23,14 +18,14 @@ export const isWebviewByUserAgent = (
 export const isWebviewByCookies = (nativeParamsFromCookies: Record<string, any> | null) => {
     return !!(nativeParamsFromCookies && nativeParamsFromCookies.isWebview)
 }
-export const checkIsWebview = (
+export const isWebviewEnvironment = (
     request: RequestHeaderType,
 ): boolean => {
     const userAgent = extractUserAgent(request);
 
     // `app-version` в заголовках – индикатор вебвью. В iOS есть только в первом запросе от webview
     const appVersion = extractAppVersion(request);
-    const nativeParamsFromCookies = extractNativeParamsFromCookies(request);
+    const nativeParams = extractNativeParamsFromCookieHeader(request);
 
-    return isWebviewByCookies(nativeParamsFromCookies) || isWebviewByUserAgent(userAgent, appVersion);
+    return isWebviewByCookies(nativeParams) || isWebviewByUserAgent(userAgent, appVersion);
 };

src/server/set-native-params-cookie.ts

@@ -0,0 +1,6 @@
+import {NATIVE_PARAMS_COOKIE_NAME} from "./constants";
+
+export const setNativeParamsCookie = (params: Record<string, string>, setCookie: (name: string, value: string) => void): void => {
+    setCookie(NATIVE_PARAMS_COOKIE_NAME, encodeURIComponent(JSON.stringify(params)))
+}
+

src/server/types.ts

@@ -1,16 +1,11 @@
+import type { NativeParamsType } from '../shared/types';
 export type RequestHeaderType = Record<string, any>;
 
 export type EmptyNativeParams = {
     isWebview: false;
 };
 
-export type NativeParams = {
-    appVersion: string;
-    iosAppId?: string;
+export type NativeParams = NativeParamsType & {
     isWebview: true;
-    theme: 'dark' | 'light';
-    title: string;
     withoutLayout: boolean;
-    originalWebviewParams: string;
-    nextPageId: number | null;
 };

src/server/utils.ts

@@ -1,10 +1,5 @@
-import {
-    CAPSULE_UA_SUBSTR,
-    AKEY_UA_SUBSTR,
-    VOSKHOD_UA_SUBSTR,
-    NATIVE_PARAMS_COOKIE_NAME
-} from './constants';
 import { RequestHeaderType } from './types';
+import { extractNativeParamsFromCookies } from "../shared/utils";
 
 /**
  * Заголовок с версией приложения, который посылает вебвью из AM Android
@@ -28,32 +23,6 @@ export function extractUserAgent(request: RequestHeaderType): string {
 /**
  * Возвращает объект с `webview-параметрами` из cookies
  */
-export function extractNativeParamsFromCookies(request: RequestHeaderType): Record<string, string> | null {
-    const cookieHeader = request.headers['cookie'];
-
-    if (!cookieHeader) {
-        return {};
-    }
-
-    const cookiesArray = cookieHeader.split('; ');
-    const cookieString = cookiesArray.find((cookie: string) => cookie.startsWith(`${NATIVE_PARAMS_COOKIE_NAME}=`));
-
-    if (!cookieString) return null;
-
-    const [, value] = cookieString.split('=');
-
-    try {
-        return JSON.parse(decodeURIComponent(value));
-    } catch {
-        return null;
-    }
+export function extractNativeParamsFromCookieHeader(request: RequestHeaderType): Record<string, unknown> | null {
+    return extractNativeParamsFromCookies(request.headers['cookie'])
 }
-
-
-/**
- * Проверка по юзерагенту на сервере
- */
-export const isAkeyWebview = (userAgent: string) =>
-    userAgent.includes(CAPSULE_UA_SUBSTR) ||
-    userAgent.includes(AKEY_UA_SUBSTR) ||
-    userAgent.includes(VOSKHOD_UA_SUBSTR);

src/shared/types.ts

@@ -0,0 +1,10 @@
+export type NativeParamsType = {
+    appVersion: string;
+    title?: string;
+    // В ранних версиях iOS приложение не пробрасывет схему приложения в URL в прод окружении.
+    // Для таких версий есть мэппинг `./constants` → `versionToIosAppId`.
+    iosAppId?: string;
+    theme: string;
+    nextPageId: number | null;
+    originalWebviewParams: string;
+};

src/shared/utils.ts

@@ -0,0 +1,24 @@
+import { NATIVE_PARAMS_COOKIE_NAME } from "../server/constants";
+
+/**
+ * Возвращает объект с `webview-параметрами` из cookies
+ */
+export function extractNativeParamsFromCookies(cookies?: string): Record<string, unknown> | null {
+
+    if (!cookies) {
+        return null;
+    }
+
+    const cookiesArray = cookies.split('; ');
+    const cookieString = cookiesArray.find((cookie: string) => cookie.startsWith(`${NATIVE_PARAMS_COOKIE_NAME}=`));
+
+    if (!cookieString) return null;
+
+    const [, value] = cookieString.split('=');
+
+    try {
+        return JSON.parse(decodeURIComponent(value));
+    } catch {
+        return null;
+    }
+}