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

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

@@ -1,5 +1,5 @@
  
-import { type BrowserHistoryApiWrappers, type HistoryPushStateParams, type HistoryReplaceStateParams, 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, type WebFeaturesGeoConfiguration, type WebFeaturesHapticsOptions, type WebFeaturesSheetDragArea } from './types';
 /**
  * Сервис, предоставляет методы для WA, работающего внутри NA.
  */
@@ -21,6 +21,8 @@ export declare class BridgeToNative {
     private nativeParamsService;
     private externalLinksService;
     private nativeNavigationAndTitleService;
+    private nativeBridgeService;
+    private webFeaturesService;
     /**
      * Схема NA.
      */
@@ -78,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.
@@ -241,4 +253,47 @@ export declare class BridgeToNative {
      * @param nativeTitle Текст заголовка, для «нативной» части WV, пустая строка — отсутствие заголовка.
      */
     setTitle(nativeTitle: string): void;
+    /**
+     * Воспроизводит тактильный отклик WebFeatures.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
+     * Управляется нативным фича-тоглом `webViewHapticsIOS`.
+     *
+     * @param options.type Тип тактильного отклика.
+     * @param options.intensity Интенсивность `0...1` (только для impact-типов).
+     *  B2N пробрасывает значение в натив без валидации диапазона.
+     */
+    vibrate(options: WebFeaturesHapticsOptions): void;
+    /**
+     * Задаёт область нативной шторы, за которую можно её перетаскивать.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
+     *
+     * @param area Область перетаскивания шторы.
+     */
+    setSheetDragArea(area: WebFeaturesSheetDragArea): void;
+    /**
+     * Скрывает нативный таббар.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
+     * Управляется нативным фича-тоглом `mainSuperAppIOS`.
+     */
+    hideTabbar(): void;
+    /**
+     * Показывает нативный таббар и, при переданном `selectedId`, выбирает вкладку.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
+     * Управляется нативным фича-тоглом `mainSuperAppIOS`.
+     *
+     * @param selectedId id вкладки, которую выбрать при показе.
+     */
+    showTabbar(selectedId?: string): void;
 }

package/client/bridge-to-native.js

@@ -3,8 +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_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.
  */
@@ -19,11 +21,13 @@ class BridgeToNative {
      *  если не передать, B2N не будет логировать ошибки.
      */
     constructor(options) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         this.options = options;
         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.
@@ -102,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.
@@ -296,5 +312,56 @@ class BridgeToNative {
     setTitle(nativeTitle) {
         this.nativeNavigationAndTitleService.setTitle(nativeTitle);
     }
+    /**
+     * Воспроизводит тактильный отклик WebFeatures.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
+     * Управляется нативным фича-тоглом `webViewHapticsIOS`.
+     *
+     * @param options.type Тип тактильного отклика.
+     * @param options.intensity Интенсивность `0...1` (только для impact-типов).
+     *  B2N пробрасывает значение в натив без валидации диапазона.
+     */
+    vibrate(options) {
+        this.webFeaturesService.vibrate(options);
+    }
+    /**
+     * Задаёт область нативной шторы, за которую можно её перетаскивать.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
+     *
+     * @param area Область перетаскивания шторы.
+     */
+    setSheetDragArea(area) {
+        this.webFeaturesService.setSheetDragArea(area);
+    }
+    /**
+     * Скрывает нативный таббар.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
+     * Управляется нативным фича-тоглом `mainSuperAppIOS`.
+     */
+    hideTabbar() {
+        this.webFeaturesService.hideTabbar();
+    }
+    /**
+     * Показывает нативный таббар и, при переданном `selectedId`, выбирает вкладку.
+     *
+     * ВАЖНО!
+     * Доступно только в iOS начиная с версии АМ `17.0.0`.
+     * В несовместимом окружении вызов игнорируется.
+     * Управляется нативным фича-тоглом `mainSuperAppIOS`.
+     *
+     * @param selectedId id вкладки, которую выбрать при показе.
+     */
+    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

@@ -6,6 +6,8 @@ export declare class NativeParamsService {
     private logError?;
     AndroidBridge: {
         setPageSettings: (params: string) => void;
+        call?: (body: string) => void;
+        send?: (body: string) => void;
     } | undefined;
     appId: string;
     appVersion: string;

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,4 +22,27 @@ export type NativeFeaturesFromVersion = Readonly<{
 }>;
 export type PdfType = 'pdfFile' | 'base64' | 'binary';
 export type Theme = 'light' | 'dark';
+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 WebFeaturesGeoConfiguration = {
+    permission: WebFeaturesGeoPermission;
+    userCoordinate: WebFeaturesUserCoordinate | null;
+};
+export type WebFeaturesHapticsType = 'light' | 'medium' | 'heavy' | 'soft' | 'rigid' | 'success' | 'warning' | 'error' | 'selection';
+export type WebFeaturesHapticsOptions = {
+    type: WebFeaturesHapticsType;
+    intensity?: number;
+};
+export type WebFeaturesSheetDragArea = 'wholeSheet' | 'navigationBar';
+export type WebFeaturesCallbackPayload = {
+    data: unknown;
+    error: {
+        code: number;
+        message: string;
+    } | null;
+};
 export {};

package/package.json

@@ -1,127 +1,132 @@
 {
-    "name": "@alfalab/bridge-to-native",
-    "version": "1.5.1",
-    "license": "MIT",
-    "description": "Утилита для удобной работы веб приложения внутри нативного приложения и коммуникации с ним.",
-    "engines": {
-        "node": ">=20.19.2",
-        "npm": "please-use-yarn"
+  "name": "@alfalab/bridge-to-native",
+  "version": "1.5.2-beta.b951ff8",
+  "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"
+  },
+  "exports": {
+    "./client": {
+      "import": "./client/index.js",
+      "require": "./client/index.js",
+      "types": "./client/index.d.ts"
     },
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/core-ds/bridge-to-native.git"
+    "./client/primitives": {
+      "import": "./client/primitives.js",
+      "require": "./client/primitives.js",
+      "types": "./client/primitives.d.ts"
     },
-    "exports": {
-        "./client": {
-            "import": "./client/index.js",
-            "require": "./client/index.js",
-            "types": "./client/index.d.ts"
-        },
-        "./client/primitives": {
-            "import": "./client/primitives.js",
-            "require": "./client/primitives.js",
-            "types": "./client/primitives.d.ts"
-        },
-        "./server": {
-            "import": "./server/index.js",
-            "require": "./server/index.js",
-            "types": "./server/index.d.ts"
-        }
-    },
-    "sideEffects": false,
-    "bugs": {
-        "url": "https://github.com/core-ds/bridge-to-native/issues"
-    },
-    "scripts": {
-        "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",
-        "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\"",
-        "release": "yarn build && yarn build:copy-package-json && yarn pub",
-        "test": "arui-scripts test --silent --collect-coverage"
+    "./server": {
+      "import": "./server/index.js",
+      "require": "./server/index.js",
+      "types": "./server/index.d.ts"
+    }
+  },
+  "sideEffects": false,
+  "bugs": {
+    "url": "https://github.com/core-ds/bridge-to-native/issues"
+  },
+  "scripts": {
+    "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",
+    "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\"",
+    "release": "yarn build && yarn build:copy-package-json && yarn pub",
+    "test": "arui-scripts test --silent --collect-coverage"
+  },
+  "devDependencies": {
+    "@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",
+    "jest-junit": "10.0.0",
+    "lint-staged": "^12.5.0",
+    "promisify-child-process": "4.1.1",
+    "shx": "0.3.4",
+    "typescript": "5.5.4"
+  },
+  "commitlint": {
+    "extends": "./node_modules/arui-presets-lint/commitlint"
+  },
+  "eslintConfig": {
+    "extends": "./node_modules/arui-presets-lint/eslint",
+    "settings": {
+      "react": {
+        "version": "18.0.0"
+      }
     },
-    "devDependencies": {
-        "@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",
-        "jest-junit": "10.0.0",
-        "lint-staged": "^12.5.0",
-        "promisify-child-process": "4.1.1",
-        "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"
-                }
-            }
-        ]
+    "parserOptions": {
+      "project": [
+        "./__tests__/tsconfig.json",
+        "./src/client/tsconfig.json",
+        "./src/server/tsconfig.json"
+      ]
     },
-    "jest": {
-        "projects": [
-            {
-                "displayName": "client-tests",
-                "testEnvironment": "@happy-dom/jest-environment",
-                "testPathIgnorePatterns": [
-                    "/__tests__/server/"
-                ]
-            },
-            {
-                "displayName": "server-tests",
-                "testEnvironment": "node",
-                "testPathIgnorePatterns": [
-                    "/__tests__/client/"
-                ]
-            }
+    "overrides": [
+      {
+        "files": [
+          "__tests__/**/*"
         ],
-        "testRegex": [
-            "__tests__/.*\\.test\\.ts"
-        ],
-        "coveragePathIgnorePatterns": [
-            "/node_modules/",
-            "/src/(client|server)/index.ts",
-            "/src/client/primitives.ts"
-        ],
-        "reporters": [
-            "default",
-            "jest-junit"
+        "rules": {
+          "max-lines": "off"
+        }
+      }
+    ]
+  },
+  "jest": {
+    "projects": [
+      {
+        "displayName": "client-tests",
+        "testEnvironment": "@happy-dom/jest-environment",
+        "testPathIgnorePatterns": [
+          "/__tests__/server/"
         ]
-    },
-    "prettier": "arui-presets-lint/prettier",
-    "stylelint": {
-        "extends": "arui-presets-lint/stylelint",
-        "ignoreFiles": [
-            "coverage/**/*.js",
-            ".yarn/releases/*"
+      },
+      {
+        "displayName": "server-tests",
+        "testEnvironment": "node",
+        "testPathIgnorePatterns": [
+          "/__tests__/client/"
         ]
-    },
-    "publishConfig": {
-        "registry": "https://registry.npmjs.org"
-    },
-    "packageManager": "yarn@4.12.0"
+      }
+    ],
+    "testRegex": [
+      "__tests__/.*\\.test\\.ts"
+    ],
+    "coveragePathIgnorePatterns": [
+      "/node_modules/",
+      "/src/(client|server)/index.ts",
+      "/src/client/primitives.ts"
+    ],
+    "reporters": [
+      "default",
+      "jest-junit"
+    ]
+  },
+  "prettier": "arui-presets-lint/prettier",
+  "stylelint": {
+    "extends": "arui-presets-lint/stylelint",
+    "ignoreFiles": [
+      "coverage/**/*.js",
+      ".yarn/releases/*"
+    ]
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "packageManager": "yarn@4.12.0"
 }