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

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, type WebFeaturesGeoConfiguration, type WebFeaturesHapticsOptions, type WebFeaturesSheetDragArea } from './types';
+import { type BrowserHistoryApiWrappers, type GeoConfiguration, type HapticsOptions, type HistoryPushStateParams, type HistoryReplaceStateParams, type LocationAssignParam, type LogError, type NativeFeatureKey, type PdfType, type SheetDragArea } from './types';
 /**
  * Сервис, предоставляет методы для WA, работающего внутри NA.
  */
@@ -13,16 +13,18 @@ export declare class BridgeToNative {
      *  будут использованы стандартные `History: pushState()` и `History: go()`.
      * @param options.logError Функция с помощью которой B2N может залогировать ошибку,
      *  если не передать, B2N не будет логировать ошибки.
+     * @param options.isSheetWebview Признак открытия WV в шторе. Отвечает за доступность
+     * новых методов взаимодействия с нативом. По умолчанию true.
      */
     constructor(options?: {
         browserHistoryApiWrappers?: BrowserHistoryApiWrappers;
         logError?: LogError;
+        isSheetWebview?: boolean;
     } | undefined);
     private nativeParamsService;
     private externalLinksService;
     private nativeNavigationAndTitleService;
-    private nativeBridgeService;
-    private webFeaturesService;
+    private nativeCommandsService;
     /**
      * Схема NA.
      */
@@ -80,16 +82,6 @@ export declare class BridgeToNative {
      *  ресурс в новом WV.
      */
     getHrefToOpenInBrowser(link: string): string;
-    /**
-     * Запрашивает текущую конфигурацию геолокации WebFeatures.
-     *
-     * ВАЖНО!
-     * Доступно только в iOS начиная с версии АМ `17.0.0`.
-     * В несовместимом окружении возвращённый промис будет отклонён.
-     *
-     * @returns Промис с `permission` и `userCoordinate` (`null`, если доступ не разрешён).
-     */
-    getGeoConfiguration(): Promise<WebFeaturesGeoConfiguration>;
     /**
      * Делает один шаг назад по браузерной истории и модифицирует внутреннее состояние B2N,
      * чтобы в дальнейшем зарегистрировать этот переход в NA.
@@ -254,46 +246,47 @@ export declare class BridgeToNative {
      */
     setTitle(nativeTitle: string): void;
     /**
-     * Воспроизводит тактильный отклик WebFeatures.
-     *
-     * ВАЖНО!
-     * Доступно только в iOS начиная с версии АМ `17.0.0`.
-     * В несовместимом окружении вызов игнорируется.
-     * Управляется нативным фича-тоглом `webViewHapticsIOS`.
+     * Возвращает статус доступа к геолокации и, при наличии разрешения, координаты пользователя.
+     * Работает только на iOS в версиях `17.0.0` и выше.
+     * В Android нужно использовать Web API.
+     *
+     * @returns Promise с конфигурацией геолокации:
+     *  `permission`: `allowed` — доступ разрешён; `denied` — запрещён;
+     *  `notDetermined` — решение ещё не принято; `restricted` — доступ ограничен.
+     *  `userCoordinate`: `{ latitude, longitude }` или `null`, если доступ не разрешён.
+     *  Отказ в доступе — успешный ответ с соответствующим permission, а не ошибка запроса.
+     */
+    getGeoConfiguration(): Promise<GeoConfiguration>;
+    /**
+     * Воспроизводит тактильный отклик.
+     * Работает только на iOS в версиях `17.0.0` и выше.
      *
+     * @param isFTEnabled Значение фича-тогла webViewHapticsIOS;
+     *  при false команда не отправляется.
      * @param options.type Тип тактильного отклика.
-     * @param options.intensity Интенсивность `0...1` (только для impact-типов).
-     *  B2N пробрасывает значение в натив без валидации диапазона.
+     * @param options.intensity Интенсивность от 0 до 1, применяется только
+     *  к impact-типам. Если не передана, NA использует значение по умолчанию.
      */
-    vibrate(options: WebFeaturesHapticsOptions): void;
+    vibrate(options: HapticsOptions, isFTEnabled: boolean): void;
     /**
      * Задаёт область нативной шторы, за которую можно её перетаскивать.
+     * Работает только на iOS в версиях `17.0.0` и выше.
      *
-     * ВАЖНО!
-     * Доступно только в iOS начиная с версии АМ `17.0.0`.
-     * В несовместимом окружении вызов игнорируется.
-     *
-     * @param area Область перетаскивания шторы.
+     * @param area
+     *    `wholeSheet` — перетаскивание за любую часть шторы (по умолчанию в NA),
+     *     данная опция может конфликтовать с `drag` обработчиками в вебе.
      */
-    setSheetDragArea(area: WebFeaturesSheetDragArea): void;
+    setSheetDragArea(area: SheetDragArea): void;
     /**
      * Скрывает нативный таббар.
-     *
-     * ВАЖНО!
-     * Доступно только в iOS начиная с версии АМ `17.0.0`.
-     * В несовместимом окружении вызов игнорируется.
-     * Управляется нативным фича-тоглом `mainSuperAppIOS`.
+     * Метод имеет смысл только на iOS в версиях `17.0.0` и выше, в которых WV-модуль
+     * может открываться с таббаром внизу.
      */
     hideTabbar(): void;
     /**
-     * Показывает нативный таббар и, при переданном `selectedId`, выбирает вкладку.
-     *
-     * ВАЖНО!
-     * Доступно только в iOS начиная с версии АМ `17.0.0`.
-     * В несовместимом окружении вызов игнорируется.
-     * Управляется нативным фича-тоглом `mainSuperAppIOS`.
-     *
-     * @param selectedId id вкладки, которую выбрать при показе.
+     * Показывает нативный таббар (будет активна вкладка, которая была активна при скрытии).
+     * Метод имеет смысл только на iOS в версиях `17.0.0` и выше, в которых WV-модуль
+     * может открываться с таббаром внизу.
      */
-    showTabbar(selectedId?: string): void;
+    showTabbar(): void;
 }

package/client/bridge-to-native.js

@@ -3,10 +3,9 @@
 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_commands_service_1 = require("./services-and-utils/native-commands-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,15 +18,16 @@ class BridgeToNative {
      *  будут использованы стандартные `History: pushState()` и `History: go()`.
      * @param options.logError Функция с помощью которой B2N может залогировать ошибку,
      *  если не передать, B2N не будет логировать ошибки.
+     * @param options.isSheetWebview Признак открытия WV в шторе. Отвечает за доступность
+     * новых методов взаимодействия с нативом. По умолчанию true.
      */
     constructor(options) {
-        var _a, _b, _c, _d, _e;
+        var _a, _b, _c, _d, _e, _f, _g;
         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);
+        this.nativeCommandsService = new native_commands_service_1.NativeCommandsService(this.nativeParamsService, (_e = this.options) === null || _e === void 0 ? void 0 : _e.logError, (_g = (_f = this.options) === null || _f === void 0 ? void 0 : _f.isSheetWebview) !== null && _g !== void 0 ? _g : true);
     }
     /**
      * Схема NA.
@@ -106,18 +106,6 @@ 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.
@@ -313,55 +301,58 @@ class BridgeToNative {
         this.nativeNavigationAndTitleService.setTitle(nativeTitle);
     }
     /**
-     * Воспроизводит тактильный отклик WebFeatures.
-     *
-     * ВАЖНО!
-     * Доступно только в iOS начиная с версии АМ `17.0.0`.
-     * В несовместимом окружении вызов игнорируется.
-     * Управляется нативным фича-тоглом `webViewHapticsIOS`.
+     * Возвращает статус доступа к геолокации и, при наличии разрешения, координаты пользователя.
+     * Работает только на iOS в версиях `17.0.0` и выше.
+     * В Android нужно использовать Web API.
+     *
+     * @returns Promise с конфигурацией геолокации:
+     *  `permission`: `allowed` — доступ разрешён; `denied` — запрещён;
+     *  `notDetermined` — решение ещё не принято; `restricted` — доступ ограничен.
+     *  `userCoordinate`: `{ latitude, longitude }` или `null`, если доступ не разрешён.
+     *  Отказ в доступе — успешный ответ с соответствующим permission, а не ошибка запроса.
+     */
+    getGeoConfiguration() {
+        return this.nativeCommandsService.getGeoConfiguration();
+    }
+    /**
+     * Воспроизводит тактильный отклик.
+     * Работает только на iOS в версиях `17.0.0` и выше.
      *
+     * @param isFTEnabled Значение фича-тогла webViewHapticsIOS;
+     *  при false команда не отправляется.
      * @param options.type Тип тактильного отклика.
-     * @param options.intensity Интенсивность `0...1` (только для impact-типов).
-     *  B2N пробрасывает значение в натив без валидации диапазона.
+     * @param options.intensity Интенсивность от 0 до 1, применяется только
+     *  к impact-типам. Если не передана, NA использует значение по умолчанию.
      */
-    vibrate(options) {
-        this.webFeaturesService.vibrate(options);
+    vibrate(options, isFTEnabled) {
+        this.nativeCommandsService.vibrate(options, isFTEnabled);
     }
     /**
      * Задаёт область нативной шторы, за которую можно её перетаскивать.
+     * Работает только на iOS в версиях `17.0.0` и выше.
      *
-     * ВАЖНО!
-     * Доступно только в iOS начиная с версии АМ `17.0.0`.
-     * В несовместимом окружении вызов игнорируется.
-     *
-     * @param area Область перетаскивания шторы.
+     * @param area
+     *    `wholeSheet` — перетаскивание за любую часть шторы (по умолчанию в NA),
+     *     данная опция может конфликтовать с `drag` обработчиками в вебе.
      */
     setSheetDragArea(area) {
-        this.webFeaturesService.setSheetDragArea(area);
+        this.nativeCommandsService.setSheetDragArea(area);
     }
     /**
      * Скрывает нативный таббар.
-     *
-     * ВАЖНО!
-     * Доступно только в iOS начиная с версии АМ `17.0.0`.
-     * В несовместимом окружении вызов игнорируется.
-     * Управляется нативным фича-тоглом `mainSuperAppIOS`.
+     * Метод имеет смысл только на iOS в версиях `17.0.0` и выше, в которых WV-модуль
+     * может открываться с таббаром внизу.
      */
     hideTabbar() {
-        this.webFeaturesService.hideTabbar();
+        this.nativeCommandsService.hideTabbar();
     }
     /**
-     * Показывает нативный таббар и, при переданном `selectedId`, выбирает вкладку.
-     *
-     * ВАЖНО!
-     * Доступно только в iOS начиная с версии АМ `17.0.0`.
-     * В несовместимом окружении вызов игнорируется.
-     * Управляется нативным фича-тоглом `mainSuperAppIOS`.
-     *
-     * @param selectedId id вкладки, которую выбрать при показе.
+     * Показывает нативный таббар (будет активна вкладка, которая была активна при скрытии).
+     * Метод имеет смысл только на iOS в версиях `17.0.0` и выше, в которых WV-модуль
+     * может открываться с таббаром внизу.
      */
-    showTabbar(selectedId) {
-        this.webFeaturesService.showTabbar(selectedId);
+    showTabbar() {
+        this.nativeCommandsService.showTabbar();
     }
 }
 exports.BridgeToNative = BridgeToNative;

package/client/constants.d.ts

@@ -1,4 +1,4 @@
-import { type NativeFeaturesFromVersion, type WebFeatureAction } from './types';
+import { type ModernAction, type NativeFeaturesFromVersion } 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,6 +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, {
+export declare const NATIVE_COMMANDS_FROM_VERSION: Readonly<Record<ModernAction, {
     fromVersion: string;
 }>>;

package/client/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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.NATIVE_COMMANDS_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,7 +28,7 @@ exports.VERSION_TO_IOS_APP_ID = {
     '13.5.0': 'assistmekz',
     '14.5.0': 'smartfinancementor',
 };
-exports.WEB_FEATURES_FROM_VERSION = {
+exports.NATIVE_COMMANDS_FROM_VERSION = {
     'geo.configuration': { fromVersion: '17.0.0' },
     'haptics.vibrate': { fromVersion: '17.0.0' },
     'sheet.setDragArea': { fromVersion: '17.0.0' },

package/client/services-and-utils/{native-bridge-service.d.ts → modern-bridge-service.d.ts}

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

package/client/services-and-utils/{native-bridge-service.js → modern-bridge-service.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NativeBridgeService = exports.CALL_TIMEOUT_MS = void 0;
+exports.ModernBridgeService = exports.CALL_TIMEOUT_MS = void 0;
 exports.CALL_TIMEOUT_MS = 10000;
 const BRIDGE_KIND_SEND = 'send';
 const BRIDGE_KIND_CALL = 'call';
@@ -13,14 +13,9 @@ const generateRequestId = () => {
     return String(requestIdCounter);
 };
 /**
- * Сервис-транспорт для взаимодействия WA с NA через WebFeatures-мост.
- *
- * Отправляет сообщения (`send` / `call`) и обрабатывает асинхронные ответы на `call`
- * через `window.webBridge.callback`.
- *
- * Отправляет сообщения напрямую через мост соответствующей платформы.
+ * Сервис-транспорт для взаимодействия WA с NA.
  */
-class NativeBridgeService {
+class ModernBridgeService {
     constructor(logError) {
         var _a;
         this.logError = logError;
@@ -56,14 +51,14 @@ class NativeBridgeService {
             requestId,
             data,
         };
-        if (!this.hasTransport(BRIDGE_KIND_CALL)) {
+        if (!this.hasTransport()) {
             this.reportNoTransport('call', action);
-            return Promise.reject(new Error(`NativeBridgeService: transport is not available for "${action}"`));
+            return Promise.reject(new Error(`ModernBridgeService: 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`));
+                reject(new Error(`ModernBridgeService: request "${action}" timed out`));
             }, exports.CALL_TIMEOUT_MS);
             this.pendingCalls.set(requestId, {
                 resolve: resolve,
@@ -91,15 +86,12 @@ class NativeBridgeService {
         pending.resolve(payload.data);
     }
     /**
-     * Проверяет доступность транспорта для указанного типа сообщения.
+     * Проверяет доступность нативного webkit-моста iOS.
      */
     // 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'));
+    hasTransport() {
+        var _a, _b, _c;
+        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);
     }
     /**
      * Отправляет тело сообщения доступным транспортом.
@@ -108,27 +100,19 @@ class NativeBridgeService {
      */
     // eslint-disable-next-line class-methods-use-this -- единая точка доступа к глобалам window.
     dispatch(body) {
-        var _a, _b, _c, _d, _e;
+        var _a, _b, _c;
         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`;
+        const message = `ModernBridgeService: 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;
+exports.ModernBridgeService = ModernBridgeService;

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

@@ -0,0 +1,21 @@
+import { type GeoConfiguration, type HapticsOptions, type LogError, type SheetDragArea } from '../types';
+import { type NativeParamsService } from './native-params-service';
+/**
+ * Сервис команд для взаимодействия WA с NA (iOS, NA ≥ 17.0.0):
+ * геолокация, тактильный отклик, нативная штора и таббар.
+ *
+ * Инкапсулирует гейт доступности по платформе и версии NA и формирует
+ * данные для вызовов через {@link ModernBridgeService}.
+ */
+export declare class NativeCommandsService {
+    private nativeParamsService;
+    private isSheetWebview;
+    constructor(nativeParamsService: NativeParamsService, logError?: LogError, isSheetWebview?: boolean);
+    private modernBridgeService;
+    getGeoConfiguration(): Promise<GeoConfiguration>;
+    vibrate({ type, intensity }: HapticsOptions, isFTEnabled: boolean): void;
+    setSheetDragArea(area: SheetDragArea): void;
+    hideTabbar(): void;
+    showTabbar(): void;
+    private isAvailable;
+}

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

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NativeCommandsService = void 0;
+const modern_bridge_service_1 = require("./modern-bridge-service");
+const native_features_1 = require("./native-features");
+/**
+ * Сервис команд для взаимодействия WA с NA (iOS, NA ≥ 17.0.0):
+ * геолокация, тактильный отклик, нативная штора и таббар.
+ *
+ * Инкапсулирует гейт доступности по платформе и версии NA и формирует
+ * данные для вызовов через {@link ModernBridgeService}.
+ */
+class NativeCommandsService {
+    constructor(nativeParamsService, logError, isSheetWebview = true) {
+        this.nativeParamsService = nativeParamsService;
+        this.isSheetWebview = isSheetWebview;
+        this.modernBridgeService = new modern_bridge_service_1.ModernBridgeService(logError);
+    }
+    getGeoConfiguration() {
+        if (!this.isAvailable('geo.configuration')) {
+            return Promise.reject(new Error('NativeCommandsService: geo.configuration is unavailable in this environment'));
+        }
+        return this.modernBridgeService.call('geo.configuration', {});
+    }
+    vibrate({ type, intensity }, isFTEnabled) {
+        if (!isFTEnabled || !this.isAvailable('haptics.vibrate')) {
+            return;
+        }
+        this.modernBridgeService.send('haptics.vibrate', Object.assign({ type }, (intensity === undefined ? {} : { intensity })));
+    }
+    setSheetDragArea(area) {
+        if (!this.isAvailable('sheet.setDragArea')) {
+            return;
+        }
+        this.modernBridgeService.send('sheet.setDragArea', { area });
+    }
+    hideTabbar() {
+        if (!this.isAvailable('tabbar.hide')) {
+            return;
+        }
+        this.modernBridgeService.send('tabbar.hide', {});
+    }
+    showTabbar() {
+        if (!this.isAvailable('tabbar.show')) {
+            return;
+        }
+        this.modernBridgeService.send('tabbar.show', {});
+    }
+    isAvailable(action) {
+        return (this.isSheetWebview &&
+            (0, native_features_1.canUseNativeCommand)(this.nativeParamsService.environment, this.nativeParamsService.appVersion, action));
+    }
+}
+exports.NativeCommandsService = NativeCommandsService;

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

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

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.canUseWebFeature = exports.canUseNativeFeature = exports.isVersionHigherOrEqual = exports.isValidVersionFormat = void 0;
+exports.canUseNativeCommand = 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);
@@ -33,14 +33,16 @@ const canUseNativeFeature = (platform, appVersion, feature) => {
 };
 exports.canUseNativeFeature = canUseNativeFeature;
 /**
- * Проверяет, поддерживает ли NA указанной платформы и версии фичу WebFeatures.
- * Фичи WebFeatures доступны только на iOS. Версия в неизвестном формате считается `0.0.0`.
+ * Проверяет доступность команды для указанной платформы и версии NA.
+ *
+ * Проверяемые команды поддерживаются только на iOS.
+ * Версия в неизвестном формате считается `0.0.0`.
  */
-const canUseWebFeature = (platform, appVersion, action) => {
+const canUseNativeCommand = (platform, appVersion, action) => {
     if (platform !== 'ios') {
         return false;
     }
-    const { fromVersion } = constants_1.WEB_FEATURES_FROM_VERSION[action];
+    const { fromVersion } = constants_1.NATIVE_COMMANDS_FROM_VERSION[action];
     return (0, exports.isVersionHigherOrEqual)((0, exports.isValidVersionFormat)(appVersion) ? appVersion : '0.0.0', fromVersion);
 };
-exports.canUseWebFeature = canUseWebFeature;
+exports.canUseNativeCommand = canUseNativeCommand;

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

@@ -6,8 +6,6 @@ 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/types.d.ts

@@ -22,23 +22,23 @@ 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 = {
+export type ModernAction = 'geo.configuration' | 'haptics.vibrate' | 'sheet.setDragArea' | 'tabbar.hide' | 'tabbar.show';
+export type GeoPermission = 'allowed' | 'denied' | 'notDetermined' | 'restricted';
+export type UserCoordinate = {
     latitude: number;
     longitude: number;
 };
-export type WebFeaturesGeoConfiguration = {
-    permission: WebFeaturesGeoPermission;
-    userCoordinate: WebFeaturesUserCoordinate | null;
+export type GeoConfiguration = {
+    permission: GeoPermission;
+    userCoordinate: UserCoordinate | null;
 };
-export type WebFeaturesHapticsType = 'light' | 'medium' | 'heavy' | 'soft' | 'rigid' | 'success' | 'warning' | 'error' | 'selection';
-export type WebFeaturesHapticsOptions = {
-    type: WebFeaturesHapticsType;
+export type HapticsType = 'light' | 'medium' | 'heavy' | 'soft' | 'rigid' | 'success' | 'warning' | 'error' | 'selection';
+export type HapticsOptions = {
+    type: HapticsType;
     intensity?: number;
 };
-export type WebFeaturesSheetDragArea = 'wholeSheet' | 'navigationBar';
-export type WebFeaturesCallbackPayload = {
+export type SheetDragArea = 'wholeSheet' | 'navigationBar';
+export type CallbackPayload = {
     data: unknown;
     error: {
         code: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfalab/bridge-to-native",
-  "version": "1.5.2-beta.b951ff8",
+  "version": "1.5.2-beta.feed590",
   "license": "MIT",
   "description": "Утилита для удобной работы веб приложения внутри нативного приложения и коммуникации с ним.",
   "engines": {

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

@@ -1,37 +0,0 @@
-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

@@ -1,67 +0,0 @@
-"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;