@alfalab/bridge-to-native 1.5.1-beta.82667a7 → 1.5.2-beta.b951ff8

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

@@ -1,5 +1,5 @@
  
-import { type BrowserHistoryApiWrappers, type HapticsOptions, type HistoryPushStateParams, type HistoryReplaceStateParams, type LocationAssignParam, type LogError, type NativeFeatureKey, type PdfType, type SheetDragArea } from './types';
+import { type BrowserHistoryApiWrappers, type HistoryPushStateParams, type HistoryReplaceStateParams, type LocationAssignParam, type LogError, type NativeFeatureKey, type PdfType, type WebFeaturesGeoConfiguration, type WebFeaturesHapticsOptions, type WebFeaturesSheetDragArea } from './types';
 /**
  * Сервис, предоставляет методы для WA, работающего внутри NA.
  */
@@ -18,10 +18,11 @@ export declare class BridgeToNative {
         browserHistoryApiWrappers?: BrowserHistoryApiWrappers;
         logError?: LogError;
     } | undefined);
-    private nativeMessagesService;
     private nativeParamsService;
     private externalLinksService;
     private nativeNavigationAndTitleService;
+    private nativeBridgeService;
+    private webFeaturesService;
     /**
      * Схема NA.
      */
@@ -79,6 +80,16 @@ export declare class BridgeToNative {
      *  ресурс в новом WV.
      */
     getHrefToOpenInBrowser(link: string): string;
+    /**
+     * Запрашивает текущую конфигурацию геолокации WebFeatures.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении возвращённый промис будет отклонён.
+     *
+     * @returns Промис с `permission` и `userCoordinate` (`null`, если доступ не разрешён).
+     */
+    getGeoConfiguration(): Promise<WebFeaturesGeoConfiguration>;
     /**
      * Делает один шаг назад по браузерной истории и модифицирует внутреннее состояние B2N,
      * чтобы в дальнейшем зарегистрировать этот переход в NA.
@@ -243,34 +254,46 @@ export declare class BridgeToNative {
      */
     setTitle(nativeTitle: string): void;
     /**
-     * Возвращает статус доступа к геолокации и, при наличии разрешения, координаты пользователя
+     * Воспроизводит тактильный отклик WebFeatures.
      *
-     * @param data пустой объект или null
-     */
-    getGeoConfiguration(data?: Record<string, never> | null): Promise<import("./types").GeoConfiguration>;
-    /**
-     * Воспроизводит тактильный отклик
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
+     * Управляется нативным фича-тоглом `webViewHapticsIOS`.
      *
-     * @param type Тип тактильного отклика
-     * @param intensity Интенсивность в диапазоне 0...1. Применяется только для impact-типов.Если не передана — используется значение по умолчанию
+     * @param options.type Тип тактильного отклика.
+     * @param options.intensity Интенсивность `0...1` (только для impact-типов).
+     *  B2N пробрасывает значение в натив без валидации диапазона.
      */
-    vibrate(options: HapticsOptions): void;
+    vibrate(options: WebFeaturesHapticsOptions): void;
     /**
-     * Задаёт область шторы, за которую можно её перетаскивать
+     * Задаёт область нативной шторы, за которую можно её перетаскивать.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
      *
-     * @param area Область шторы, за которую можно её перетаскивать
-     * - `wholeSheet` — вся штора (значение по умолчанию в нативе);
-     * - `navigationBar` — только навигационная панель шторы.
+     * @param area Область перетаскивания шторы.
      */
-    setSheetDragArea(area: SheetDragArea): void;
+    setSheetDragArea(area: WebFeaturesSheetDragArea): void;
     /**
-     * Скрывает нативный таббар
+     * Скрывает нативный таббар.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
+     * Управляется нативным фича-тоглом `mainSuperAppIOS`.
      */
     hideTabbar(): void;
     /**
-     * Показывает нативный таббар и, при переданном selectedId, выбирает вкладку
+     * Показывает нативный таббар и, при переданном `selectedId`, выбирает вкладку.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
+     * Управляется нативным фича-тоглом `mainSuperAppIOS`.
      *
-     * @param selectedId id вкладки, которую выбрать при показе таббара. Если null или не передан — текущая вкладка не меняется
+     * @param selectedId id вкладки, которую выбрать при показе.
      */
-    showTabbar(selectedId?: string | null): void;
+    showTabbar(selectedId?: string): void;
 }

package/client/bridge-to-native.js

@@ -3,9 +3,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BridgeToNative = void 0;
 const external_links_service_1 = require("./services-and-utils/external-links-service");
-const native_messages_service_1 = require("./services-and-utils/native-messages-service");
+const native_bridge_service_1 = require("./services-and-utils/native-bridge-service");
 const native_navigation_and_title_service_1 = require("./services-and-utils/native-navigation-and-title-service");
 const native_params_service_1 = require("./services-and-utils/native-params-service");
+const web_features_service_1 = require("./services-and-utils/web-features-service");
 /**
  * Сервис, предоставляет методы для WA, работающего внутри NA.
  */
@@ -20,12 +21,13 @@ class BridgeToNative {
      *  если не передать, B2N не будет логировать ошибки.
      */
     constructor(options) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         this.options = options;
-        this.nativeMessagesService = new native_messages_service_1.NativeMessagesService();
         this.nativeParamsService = new native_params_service_1.NativeParamsService((_a = this.options) === null || _a === void 0 ? void 0 : _a.logError);
         this.externalLinksService = new external_links_service_1.ExternalLinksService(this.nativeParamsService, (_b = this.options) === null || _b === void 0 ? void 0 : _b.logError);
         this.nativeNavigationAndTitleService = new native_navigation_and_title_service_1.NativeNavigationAndTitleService(this.nativeParamsService, (_c = this.options) === null || _c === void 0 ? void 0 : _c.browserHistoryApiWrappers, (_d = this.options) === null || _d === void 0 ? void 0 : _d.logError);
+        this.nativeBridgeService = new native_bridge_service_1.NativeBridgeService((_e = this.options) === null || _e === void 0 ? void 0 : _e.logError);
+        this.webFeaturesService = new web_features_service_1.WebFeaturesService(this.nativeParamsService, this.nativeBridgeService);
     }
     /**
      * Схема NA.
@@ -104,6 +106,18 @@ class BridgeToNative {
     getHrefToOpenInBrowser(link) {
         return this.externalLinksService.getHrefToOpenInBrowser(link);
     }
+    /**
+     * Запрашивает текущую конфигурацию геолокации WebFeatures.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении возвращённый промис будет отклонён.
+     *
+     * @returns Промис с `permission` и `userCoordinate` (`null`, если доступ не разрешён).
+     */
+    getGeoConfiguration() {
+        return this.webFeaturesService.getGeoConfiguration();
+    }
     /**
      * Делает один шаг назад по браузерной истории и модифицирует внутреннее состояние B2N,
      * чтобы в дальнейшем зарегистрировать этот переход в NA.
@@ -299,45 +313,55 @@ class BridgeToNative {
         this.nativeNavigationAndTitleService.setTitle(nativeTitle);
     }
     /**
-     * Возвращает статус доступа к геолокации и, при наличии разрешения, координаты пользователя
+     * Воспроизводит тактильный отклик WebFeatures.
      *
-     * @param data пустой объект или null
-     */
-    getGeoConfiguration(data = {}) {
-        return this.nativeMessagesService.getGeoConfiguration(data);
-    }
-    /**
-     * Воспроизводит тактильный отклик
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
+     * Управляется нативным фича-тоглом `webViewHapticsIOS`.
      *
-     * @param type Тип тактильного отклика
-     * @param intensity Интенсивность в диапазоне 0...1. Применяется только для impact-типов.Если не передана — используется значение по умолчанию
+     * @param options.type Тип тактильного отклика.
+     * @param options.intensity Интенсивность `0...1` (только для impact-типов).
+     *  B2N пробрасывает значение в натив без валидации диапазона.
      */
     vibrate(options) {
-        this.nativeMessagesService.vibrate(options);
+        this.webFeaturesService.vibrate(options);
     }
     /**
-     * Задаёт область шторы, за которую можно её перетаскивать
+     * Задаёт область нативной шторы, за которую можно её перетаскивать.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
      *
-     * @param area Область шторы, за которую можно её перетаскивать
-     * - `wholeSheet` — вся штора (значение по умолчанию в нативе);
-     * - `navigationBar` — только навигационная панель шторы.
+     * @param area Область перетаскивания шторы.
      */
     setSheetDragArea(area) {
-        this.nativeMessagesService.setSheetDragArea(area);
+        this.webFeaturesService.setSheetDragArea(area);
     }
     /**
-     * Скрывает нативный таббар
+     * Скрывает нативный таббар.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
+     * Управляется нативным фича-тоглом `mainSuperAppIOS`.
      */
     hideTabbar() {
-        this.nativeMessagesService.hideTabbar();
+        this.webFeaturesService.hideTabbar();
     }
     /**
-     * Показывает нативный таббар и, при переданном selectedId, выбирает вкладку
+     * Показывает нативный таббар и, при переданном `selectedId`, выбирает вкладку.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
+     * Управляется нативным фича-тоглом `mainSuperAppIOS`.
      *
-     * @param selectedId id вкладки, которую выбрать при показе таббара. Если null или не передан — текущая вкладка не меняется
+     * @param selectedId id вкладки, которую выбрать при показе.
      */
     showTabbar(selectedId) {
-        this.nativeMessagesService.showTabbar(selectedId);
+        this.webFeaturesService.showTabbar(selectedId);
     }
 }
 exports.BridgeToNative = BridgeToNative;

package/client/constants.d.ts

@@ -1,4 +1,4 @@
-import { type NativeFeaturesFromVersion } from './types';
+import { type NativeFeaturesFromVersion, type WebFeatureAction } from './types';
 export declare const ANDROID_APP_ID = "alfabank";
 export declare const DEEP_LINK_PATTERN: RegExp;
 export declare const NATIVE_FEATURES_FROM_VERSION: NativeFeaturesFromVersion;
@@ -11,3 +11,6 @@ export declare const VERSION_TO_IOS_APP_ID: {
     readonly '13.5.0': "assistmekz";
     readonly '14.5.0': "smartfinancementor";
 };
+export declare const WEB_FEATURES_FROM_VERSION: Readonly<Record<WebFeatureAction, {
+    fromVersion: string;
+}>>;

package/client/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VERSION_TO_IOS_APP_ID = exports.NATIVE_FEATURES_FROM_VERSION = exports.DEEP_LINK_PATTERN = exports.ANDROID_APP_ID = void 0;
+exports.WEB_FEATURES_FROM_VERSION = exports.VERSION_TO_IOS_APP_ID = exports.NATIVE_FEATURES_FROM_VERSION = exports.DEEP_LINK_PATTERN = exports.ANDROID_APP_ID = void 0;
 exports.ANDROID_APP_ID = 'alfabank';
 exports.DEEP_LINK_PATTERN = /^(\/|alfabank:\/{3}dashboard\/|alfabank:\/{3}|alfabank:\/{2}|https:\/{2}online.alfabank.ru\/)/;
 exports.NATIVE_FEATURES_FROM_VERSION = {
@@ -28,3 +28,10 @@ exports.VERSION_TO_IOS_APP_ID = {
     '13.5.0': 'assistmekz',
     '14.5.0': 'smartfinancementor',
 };
+exports.WEB_FEATURES_FROM_VERSION = {
+    'geo.configuration': { fromVersion: '17.0.0' },
+    'haptics.vibrate': { fromVersion: '17.0.0' },
+    'sheet.setDragArea': { fromVersion: '17.0.0' },
+    'tabbar.hide': { fromVersion: '17.0.0' },
+    'tabbar.show': { fromVersion: '17.0.0' },
+};

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

@@ -0,0 +1,38 @@
+import { type LogError, type WebFeatureAction } from '../types';
+export declare const CALL_TIMEOUT_MS = 10000;
+/**
+ * Сервис-транспорт для взаимодействия WA с NA через WebFeatures-мост.
+ *
+ * Отправляет сообщения (`send` / `call`) и обрабатывает асинхронные ответы на `call`
+ * через `window.webBridge.callback`.
+ *
+ * Отправляет сообщения напрямую через мост соответствующей платформы.
+ */
+export declare class NativeBridgeService {
+    private logError?;
+    private pendingCalls;
+    private savedCallback?;
+    constructor(logError?: LogError | undefined);
+    /**
+     * Отправляет fire-and-forget сообщение в NA (без ожидания ответа).
+     */
+    send(action: WebFeatureAction, data: unknown): void;
+    /**
+     * Отправляет сообщение типа `call` и возвращает промис с ответом NA.
+     *
+     * @throws Если транспорт недоступен или ответ не пришёл за {@link CALL_TIMEOUT_MS}.
+     */
+    call<Data>(action: WebFeatureAction, data: unknown): Promise<Data>;
+    private handleCallback;
+    /**
+     * Проверяет доступность транспорта для указанного типа сообщения.
+     */
+    private hasTransport;
+    /**
+     * Отправляет тело сообщения доступным транспортом.
+     *
+     * @returns `true`, если сообщение удалось передать.
+     */
+    private dispatch;
+    private reportNoTransport;
+}

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

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NativeBridgeService = exports.CALL_TIMEOUT_MS = void 0;
+exports.CALL_TIMEOUT_MS = 10000;
+const BRIDGE_KIND_SEND = 'send';
+const BRIDGE_KIND_CALL = 'call';
+let requestIdCounter = 0;
+const generateRequestId = () => {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    requestIdCounter += 1;
+    return String(requestIdCounter);
+};
+/**
+ * Сервис-транспорт для взаимодействия WA с NA через WebFeatures-мост.
+ *
+ * Отправляет сообщения (`send` / `call`) и обрабатывает асинхронные ответы на `call`
+ * через `window.webBridge.callback`.
+ *
+ * Отправляет сообщения напрямую через мост соответствующей платформы.
+ */
+class NativeBridgeService {
+    constructor(logError) {
+        var _a;
+        this.logError = logError;
+        this.pendingCalls = new Map();
+        this.handleCallback = this.handleCallback.bind(this);
+        this.savedCallback = (_a = window.webBridge) === null || _a === void 0 ? void 0 : _a.callback;
+        window.webBridge = Object.assign(Object.assign({}, window.webBridge), { callback: this.handleCallback });
+    }
+    /**
+     * Отправляет fire-and-forget сообщение в NA (без ожидания ответа).
+     */
+    send(action, data) {
+        const body = {
+            kind: BRIDGE_KIND_SEND,
+            action,
+            requestId: generateRequestId(),
+            data,
+        };
+        if (!this.dispatch(body)) {
+            this.reportNoTransport('send', action);
+        }
+    }
+    /**
+     * Отправляет сообщение типа `call` и возвращает промис с ответом NA.
+     *
+     * @throws Если транспорт недоступен или ответ не пришёл за {@link CALL_TIMEOUT_MS}.
+     */
+    call(action, data) {
+        const requestId = generateRequestId();
+        const body = {
+            kind: BRIDGE_KIND_CALL,
+            action,
+            requestId,
+            data,
+        };
+        if (!this.hasTransport(BRIDGE_KIND_CALL)) {
+            this.reportNoTransport('call', action);
+            return Promise.reject(new Error(`NativeBridgeService: transport is not available for "${action}"`));
+        }
+        return new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+                this.pendingCalls.delete(requestId);
+                reject(new Error(`NativeBridgeService: request "${action}" timed out`));
+            }, exports.CALL_TIMEOUT_MS);
+            this.pendingCalls.set(requestId, {
+                resolve: resolve,
+                reject,
+                timeoutId,
+            });
+            this.dispatch(body);
+        });
+    }
+    handleCallback(requestId, payload) {
+        var _a;
+        const pending = this.pendingCalls.get(requestId);
+        if (!pending) {
+            (_a = this.savedCallback) === null || _a === void 0 ? void 0 : _a.call(this, requestId, payload);
+            return;
+        }
+        clearTimeout(pending.timeoutId);
+        this.pendingCalls.delete(requestId);
+        if (payload.error) {
+            const error = new Error(payload.error.message);
+            error.code = payload.error.code;
+            pending.reject(error);
+            return;
+        }
+        pending.resolve(payload.data);
+    }
+    /**
+     * Проверяет доступность транспорта для указанного типа сообщения.
+     */
+    // eslint-disable-next-line class-methods-use-this -- единая точка доступа к глобалам window.
+    hasTransport(kind) {
+        var _a, _b, _c, _d, _e;
+        return Boolean(((_c = (_b = (_a = window.webkit) === null || _a === void 0 ? void 0 : _a.messageHandlers) === null || _b === void 0 ? void 0 : _b.bridge) === null || _c === void 0 ? void 0 : _c.postMessage) ||
+            (kind === BRIDGE_KIND_CALL
+                ? typeof ((_d = window.Android) === null || _d === void 0 ? void 0 : _d.call) === 'function'
+                : typeof ((_e = window.Android) === null || _e === void 0 ? void 0 : _e.send) === 'function'));
+    }
+    /**
+     * Отправляет тело сообщения доступным транспортом.
+     *
+     * @returns `true`, если сообщение удалось передать.
+     */
+    // eslint-disable-next-line class-methods-use-this -- единая точка доступа к глобалам window.
+    dispatch(body) {
+        var _a, _b, _c, _d, _e;
+        if ((_c = (_b = (_a = window.webkit) === null || _a === void 0 ? void 0 : _a.messageHandlers) === null || _b === void 0 ? void 0 : _b.bridge) === null || _c === void 0 ? void 0 : _c.postMessage) {
+            window.webkit.messageHandlers.bridge.postMessage(body);
+            return true;
+        }
+        if (body.kind === BRIDGE_KIND_CALL && typeof ((_d = window.Android) === null || _d === void 0 ? void 0 : _d.call) === 'function') {
+            window.Android.call(JSON.stringify(body));
+            return true;
+        }
+        if (body.kind === BRIDGE_KIND_SEND && typeof ((_e = window.Android) === null || _e === void 0 ? void 0 : _e.send) === 'function') {
+            window.Android.send(JSON.stringify(body));
+            return true;
+        }
+        return false;
+    }
+    reportNoTransport(kind, action) {
+        var _a;
+        const message = `NativeBridgeService: native bridge is not available, "${action}" (${kind}) was not sent`;
+        (_a = this.logError) === null || _a === void 0 ? void 0 : _a.call(this, message, { action, kind });
+        // eslint-disable-next-line no-console -- сообщаем потребителю о недоступности моста.
+        console.error(message);
+    }
+}
+exports.NativeBridgeService = NativeBridgeService;

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

@@ -1,4 +1,4 @@
-import { type Environment, type NativeFeatureKey } from '../types';
+import { type Environment, type NativeFeatureKey, type WebFeatureAction } from '../types';
 export declare const isValidVersionFormat: (version?: string) => version is string;
 /**
  * Сравнивает версии формата `x.y.z` покомпонентно, как числа.
@@ -10,3 +10,8 @@ export declare const isVersionHigherOrEqual: (version: string, versionToCompare:
  * Версия в неизвестном формате считается `0.0.0`.
  */
 export declare const canUseNativeFeature: (platform: Environment, appVersion: string, feature: NativeFeatureKey) => boolean;
+/**
+ * Проверяет, поддерживает ли NA указанной платформы и версии фичу WebFeatures.
+ * Фичи WebFeatures доступны только на iOS. Версия в неизвестном формате считается `0.0.0`.
+ */
+export declare const canUseWebFeature: (platform: Environment, appVersion: string, action: WebFeatureAction) => boolean;

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.canUseNativeFeature = exports.isVersionHigherOrEqual = exports.isValidVersionFormat = void 0;
+exports.canUseWebFeature = exports.canUseNativeFeature = exports.isVersionHigherOrEqual = exports.isValidVersionFormat = void 0;
 const constants_1 = require("../constants");
 const VERSION_FORMAT_PATTERN = /^\d+\.\d+\.\d+$/;
 const isValidVersionFormat = (version) => Boolean(version) && VERSION_FORMAT_PATTERN.test(version);
@@ -32,3 +32,15 @@ const canUseNativeFeature = (platform, appVersion, feature) => {
     return (0, exports.isVersionHigherOrEqual)((0, exports.isValidVersionFormat)(appVersion) ? appVersion : '0.0.0', fromVersion);
 };
 exports.canUseNativeFeature = canUseNativeFeature;
+/**
+ * Проверяет, поддерживает ли NA указанной платформы и версии фичу WebFeatures.
+ * Фичи WebFeatures доступны только на iOS. Версия в неизвестном формате считается `0.0.0`.
+ */
+const canUseWebFeature = (platform, appVersion, action) => {
+    if (platform !== 'ios') {
+        return false;
+    }
+    const { fromVersion } = constants_1.WEB_FEATURES_FROM_VERSION[action];
+    return (0, exports.isVersionHigherOrEqual)((0, exports.isValidVersionFormat)(appVersion) ? appVersion : '0.0.0', fromVersion);
+};
+exports.canUseWebFeature = canUseWebFeature;

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

@@ -5,9 +5,9 @@ import { type Environment, type LogError, type NativeFeatureKey, type Theme } fr
 export declare class NativeParamsService {
     private logError?;
     AndroidBridge: {
-        call?: (message: string) => void;
-        send?: (message: string) => void;
         setPageSettings: (params: string) => void;
+        call?: (body: string) => void;
+        send?: (body: string) => void;
     } | undefined;
     appId: string;
     appVersion: string;

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

@@ -1,22 +1,4 @@
-import { type GeoConfiguration, type LogError, type NativeBridgeMessage } from '../types';
+import { type LogError } from '../types';
 export declare function appendFromCurrentQueryParamForIos(nativeUrl: string): string;
 export declare const closeWebviewUtil: () => void;
 export declare const validateUrl: (link: URL | string, logError?: LogError) => URL | null;
-/**
- * Map для сопоставления запросов посланных в натив и ответов от него.
- * Сопоставление происходит по requestId.
- * Сейчас запрос с типом call только один - это geo.configuration.
- */
-export declare const pendingRequests: Map<string, {
-    resolve: (data: GeoConfiguration) => void;
-    reject: (error: unknown) => void;
-}>;
-/**
- * Универсальная функция для отправки сообщений в нативное приложение
- * (Сигнатуры функций натива в iOS и Android отличаются)
- */
-export declare const sendMessage: (message: NativeBridgeMessage) => void;
-/**
- * Добавляет обработчик webBridge.callback который будет вызываться нативом
- */
-export declare const installCallback: () => void;

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.installCallback = exports.sendMessage = exports.pendingRequests = exports.validateUrl = exports.closeWebviewUtil = void 0;
+exports.validateUrl = exports.closeWebviewUtil = void 0;
 exports.appendFromCurrentQueryParamForIos = appendFromCurrentQueryParamForIos;
 const QUERY_CLOSE_WEBVIEW_KEY = 'closeWebView';
 const QUERY_CLOSE_WEBVIEW_VALUE = 'true';
@@ -48,64 +48,3 @@ const validateUrl = (link, logError) => {
     return url;
 };
 exports.validateUrl = validateUrl;
-/**
- * Map для сопоставления запросов посланных в натив и ответов от него.
- * Сопоставление происходит по requestId.
- * Сейчас запрос с типом call только один - это geo.configuration.
- */
-exports.pendingRequests = new Map();
-/**
- * Универсальная функция для отправки сообщений в нативное приложение
- * (Сигнатуры функций натива в iOS и Android отличаются)
- */
-const sendMessage = (message) => {
-    var _a, _b, _c;
-    const android = window.Android;
-    if (message.kind === 'call' && typeof (android === null || android === void 0 ? void 0 : android.call) === 'function') {
-        android.call(JSON.stringify(message));
-    }
-    else if (message.kind === 'send' && typeof (android === null || android === void 0 ? void 0 : android.send) === 'function') {
-        android.send(JSON.stringify(message));
-    }
-    else if ((_c = (_b = (_a = window.webkit) === null || _a === void 0 ? void 0 : _a.messageHandlers) === null || _b === void 0 ? void 0 : _b.bridge) === null || _c === void 0 ? void 0 : _c.postMessage) {
-        window.webkit.messageHandlers.bridge.postMessage(message);
-    }
-    else {
-        throw new Error('Native bridge is not available');
-    }
-};
-exports.sendMessage = sendMessage;
-/**
- * Находит ожидающий запрос по requestId, удаляет его из pendingRequests и завершает Promise:
- * успешно с данными или с ошибкой. Если в ответе отсутствуют и данные, и ошибка, отклоняет Promise.
- *
- * Ответы с неизвестным requestId, включая повторные ответы и ответы после тайм-аута, игнорируются.
- *
- * @param requestId Уникальный uuid исходного call-запроса, возвращённый нативом.
- * @param response Ответ натива: data содержит конфигурацию геолокации
- * либо error содержит ошибку. По контракту одно из этих полей равно null.
- */
-const callback = (requestId, response) => {
-    var _a;
-    const pending = exports.pendingRequests.get(requestId);
-    if (!pending)
-        return;
-    exports.pendingRequests.delete(requestId);
-    if (response.error) {
-        pending.reject(Object.assign(new Error((_a = response.error.message) !== null && _a !== void 0 ? _a : 'Native bridge Geolocation error'), response.error));
-    }
-    else if (response.data) {
-        pending.resolve(response.data);
-    }
-    else {
-        pending.reject(new Error('Native bridge returned no Geolocation data'));
-    }
-};
-/**
- * Добавляет обработчик webBridge.callback который будет вызываться нативом
- */
-const installCallback = () => {
-    window.webBridge = window.webBridge || {};
-    window.webBridge.callback = callback;
-};
-exports.installCallback = installCallback;

package/client/services-and-utils/web-features-service.d.ts

@@ -0,0 +1,37 @@
+import { type WebFeaturesGeoConfiguration, type WebFeaturesHapticsOptions, type WebFeaturesSheetDragArea } from '../types';
+import { type NativeBridgeService } from './native-bridge-service';
+import { type NativeParamsService } from './native-params-service';
+/**
+ * Доменный сервис фич WebFeatures (iOS, АМ ≥ 17.0.0).
+ *
+ * Инкапсулирует гейт доступности по платформе и версии NA и формирует
+ * данные для вызовов через {@link NativeBridgeService}.
+ */
+export declare class WebFeaturesService {
+    private nativeParamsService;
+    private nativeBridgeService;
+    constructor(nativeParamsService: NativeParamsService, nativeBridgeService: NativeBridgeService);
+    /**
+     * Возвращает статус доступа к геолокации и, при наличии разрешения, координаты пользователя
+     *
+     * @throws Если фича недоступна в текущем окружении или NA вернул ошибку.
+     */
+    getGeoConfiguration(): Promise<WebFeaturesGeoConfiguration>;
+    /**
+     * Воспроизводит тактильный отклик.
+     */
+    vibrate({ type, intensity }: WebFeaturesHapticsOptions): void;
+    /**
+     * Задаёт область шторы, за которую можно её перетаскивать.
+     */
+    setSheetDragArea(area: WebFeaturesSheetDragArea): void;
+    /**
+     * Скрывает нативный таббар.
+     */
+    hideTabbar(): void;
+    /**
+     * Показывает нативный таббар и, при переданном `selectedId`, выбирает вкладку.
+     */
+    showTabbar(selectedId?: string): void;
+    private isAvailable;
+}

package/client/services-and-utils/web-features-service.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebFeaturesService = void 0;
+const native_features_1 = require("./native-features");
+/**
+ * Доменный сервис фич WebFeatures (iOS, АМ ≥ 17.0.0).
+ *
+ * Инкапсулирует гейт доступности по платформе и версии NA и формирует
+ * данные для вызовов через {@link NativeBridgeService}.
+ */
+class WebFeaturesService {
+    constructor(nativeParamsService, nativeBridgeService) {
+        this.nativeParamsService = nativeParamsService;
+        this.nativeBridgeService = nativeBridgeService;
+    }
+    /**
+     * Возвращает статус доступа к геолокации и, при наличии разрешения, координаты пользователя
+     *
+     * @throws Если фича недоступна в текущем окружении или NA вернул ошибку.
+     */
+    getGeoConfiguration() {
+        if (!this.isAvailable('geo.configuration')) {
+            return Promise.reject(new Error('WebFeatures: geo.configuration is unavailable in this environment'));
+        }
+        return this.nativeBridgeService.call('geo.configuration', {});
+    }
+    /**
+     * Воспроизводит тактильный отклик.
+     */
+    vibrate({ type, intensity }) {
+        if (!this.isAvailable('haptics.vibrate')) {
+            return;
+        }
+        this.nativeBridgeService.send('haptics.vibrate', Object.assign({ type }, (intensity === undefined ? {} : { intensity })));
+    }
+    /**
+     * Задаёт область шторы, за которую можно её перетаскивать.
+     */
+    setSheetDragArea(area) {
+        if (!this.isAvailable('sheet.setDragArea')) {
+            return;
+        }
+        this.nativeBridgeService.send('sheet.setDragArea', { area });
+    }
+    /**
+     * Скрывает нативный таббар.
+     */
+    hideTabbar() {
+        if (!this.isAvailable('tabbar.hide')) {
+            return;
+        }
+        this.nativeBridgeService.send('tabbar.hide', {});
+    }
+    /**
+     * Показывает нативный таббар и, при переданном `selectedId`, выбирает вкладку.
+     */
+    showTabbar(selectedId) {
+        if (!this.isAvailable('tabbar.show')) {
+            return;
+        }
+        this.nativeBridgeService.send('tabbar.show', selectedId === undefined ? {} : { selectedId });
+    }
+    isAvailable(action) {
+        return (0, native_features_1.canUseWebFeature)(this.nativeParamsService.environment, this.nativeParamsService.appVersion, action);
+    }
+}
+exports.WebFeaturesService = WebFeaturesService;

package/client/types.d.ts

@@ -22,36 +22,27 @@ export type NativeFeaturesFromVersion = Readonly<{
 }>;
 export type PdfType = 'pdfFile' | 'base64' | 'binary';
 export type Theme = 'light' | 'dark';
-export type NativeBridgeMessage = {
-    kind: 'call' | 'send';
-    action: string;
-    requestId: string;
-    data: object | null;
+export type WebFeatureAction = 'geo.configuration' | 'haptics.vibrate' | 'sheet.setDragArea' | 'tabbar.hide' | 'tabbar.show';
+export type WebFeaturesGeoPermission = 'allowed' | 'denied' | 'notDetermined' | 'restricted';
+export type WebFeaturesUserCoordinate = {
+    latitude: number;
+    longitude: number;
 };
-export type NativeBridgeResponse = {
-    data: GeoConfiguration | null;
-    error: {
-        code: number;
-        message?: string;
-        details?: unknown;
-    } | null;
+export type WebFeaturesGeoConfiguration = {
+    permission: WebFeaturesGeoPermission;
+    userCoordinate: WebFeaturesUserCoordinate | null;
 };
-export type HapticsOptions = {
-    type: 'light' | 'medium' | 'heavy' | 'soft' | 'rigid' | 'success' | 'warning' | 'error' | 'selection';
+export type WebFeaturesHapticsType = 'light' | 'medium' | 'heavy' | 'soft' | 'rigid' | 'success' | 'warning' | 'error' | 'selection';
+export type WebFeaturesHapticsOptions = {
+    type: WebFeaturesHapticsType;
     intensity?: number;
 };
-export type GeoConfiguration = {
-    /**
-     * allowed — доступ разрешён;
-     * denied — доступ запрещён;
-     * notDetermined — пользователь ещё не принял решение;
-     * restricted — доступ ограничен
-     */
-    permission: 'allowed' | 'denied' | 'notDetermined' | 'restricted';
-    userCoordinate: {
-        latitude: number;
-        longitude: number;
+export type WebFeaturesSheetDragArea = 'wholeSheet' | 'navigationBar';
+export type WebFeaturesCallbackPayload = {
+    data: unknown;
+    error: {
+        code: number;
+        message: string;
     } | null;
 };
-export type SheetDragArea = 'wholeSheet' | 'navigationBar';
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfalab/bridge-to-native",
-  "version": "1.5.1-beta.82667a7",
+  "version": "1.5.2-beta.b951ff8",
   "license": "MIT",
   "description": "Утилита для удобной работы веб приложения внутри нативного приложения и коммуникации с ним.",
   "engines": {
@@ -64,6 +64,11 @@
   },
   "eslintConfig": {
     "extends": "./node_modules/arui-presets-lint/eslint",
+    "settings": {
+      "react": {
+        "version": "18.0.0"
+      }
+    },
     "parserOptions": {
       "project": [
         "./__tests__/tsconfig.json",

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

@@ -1,9 +0,0 @@
-import { type GeoConfiguration, type HapticsOptions, type SheetDragArea } from '../types';
-export declare class NativeMessagesService {
-    getGeoConfiguration(data?: Record<string, never> | null): Promise<GeoConfiguration>;
-    vibrate(options: HapticsOptions): void;
-    setSheetDragArea(area: SheetDragArea): void;
-    hideTabbar(): void;
-    showTabbar(selectedId?: string | null): void;
-    private send;
-}

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

@@ -1,63 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NativeMessagesService = void 0;
-const utils_1 = require("./utils");
-class NativeMessagesService {
-    // eslint-disable-next-line class-methods-use-this
-    getGeoConfiguration(data = {}) {
-        return new Promise((resolve, reject) => {
-            const requestId = crypto.randomUUID();
-            const timeout = setTimeout(() => {
-                utils_1.pendingRequests.delete(requestId);
-                reject(new Error('Native bridge geolocation request timed out'));
-            }, 10000);
-            const cleanup = () => {
-                clearTimeout(timeout);
-                utils_1.pendingRequests.delete(requestId);
-            };
-            utils_1.pendingRequests.set(requestId, {
-                resolve: (result) => {
-                    cleanup();
-                    resolve(result);
-                },
-                reject: (error) => {
-                    cleanup();
-                    reject(error);
-                },
-            });
-            try {
-                (0, utils_1.installCallback)();
-                (0, utils_1.sendMessage)({
-                    kind: 'call',
-                    action: 'geo.configuration',
-                    requestId,
-                    data,
-                });
-            }
-            catch (error) {
-                cleanup();
-                reject(error);
-            }
-        });
-    }
-    vibrate(options) {
-        if (options.intensity !== undefined && (options.intensity < 0 || options.intensity > 1)) {
-            throw new RangeError('Haptic intensity must be between 0 and 1');
-        }
-        this.send('haptics.vibrate', options);
-    }
-    setSheetDragArea(area) {
-        this.send('sheet.setDragArea', { area });
-    }
-    hideTabbar() {
-        this.send('tabbar.hide', {});
-    }
-    showTabbar(selectedId) {
-        this.send('tabbar.show', selectedId === undefined ? {} : { selectedId });
-    }
-    // eslint-disable-next-line class-methods-use-this
-    send(action, data) {
-        (0, utils_1.sendMessage)({ kind: 'send', action, requestId: crypto.randomUUID(), data });
-    }
-}
-exports.NativeMessagesService = NativeMessagesService;