@wowlabtech/mini-app-adapter 0.2.84 → 0.2.86

package/dist/index.d.cts

@@ -139,8 +139,10 @@ interface MiniAppAdapter {
     readonly shell: ShellAPI;
     /**
      * Quick capability check before calling platform specific APIs.
+     * Always asynchronous so callers can rely on a single contract across platforms
+     * (VK resolves capabilities via the async bridge). Always `await` the result.
      */
-    supports(capability: MiniAppCapability): boolean | Promise<boolean>;
+    supports(capability: MiniAppCapability): Promise<boolean>;
     /**
      * Initializes platform SDK. Safe to call multiple times.
      */
@@ -229,9 +231,9 @@ interface MiniAppAdapter {
     /**
      * Strong/weak haptic feedback helpers.
      */
-    vibrateImpact(style: ImpactHapticFeedbackStyle): void;
-    vibrateNotification(type: NotificationHapticFeedbackType): void;
-    vibrateSelection(): void;
+    vibrateImpact(style: ImpactHapticFeedbackStyle): void | Promise<void>;
+    vibrateNotification(type: NotificationHapticFeedbackType): void | Promise<void>;
+    vibrateSelection(): void | Promise<void>;
     /**
      * Notifies when the host view goes to background/foreground (VK only).
      */
@@ -294,7 +296,7 @@ interface MiniAppAdapter {
     /**
      * Shares a URL using platform-specific capabilities.
      */
-    shareUrl?(url: string, text: string): void;
+    shareUrl?(url: string, text?: string): void;
     /**
      * Copies text to the clipboard if supported by the platform.
      */
@@ -328,7 +330,7 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     private readonly disposables;
     readonly shell: ShellAPI;
     protected constructor(platform: MiniAppPlatform, environment?: Partial<MiniAppEnvironmentInfo>);
-    supports(capability: MiniAppCapability): boolean | Promise<boolean>;
+    supports(capability: MiniAppCapability): Promise<boolean>;
     get platform(): MiniAppPlatform;
     init(_options?: MiniAppInitOptions): Promise<void>;
     isReady(): boolean;
@@ -357,7 +359,7 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     }) => void): () => void;
     getViewportInsets(): MiniAppViewportInsets | undefined;
     shareMessage(_message: string): Promise<void>;
-    shareUrl(_url: string, _text: string): void;
+    shareUrl(_url: string, _text?: string): void;
     downloadFile(url: string, filename: string): Promise<void>;
     shareStory(_mediaUrl: string, _options?: MiniAppShareStoryOptions): Promise<void>;
     trackConversionEvent(_event: string, _payload?: Record<string, unknown>): void;
@@ -386,35 +388,9 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     private applyScrollGuards;
 }
 
-declare class MaxMiniAppAdapter extends BaseMiniAppAdapter {
-    private readonly backHandlers;
-    private initData?;
-    private initDataUnsafe?;
-    constructor();
-    init(_options?: MiniAppInitOptions): Promise<void>;
-    supports(capability: MiniAppCapability): boolean;
-    getInitData(): string | undefined;
-    getLaunchParams(): MiniAppLaunchParams | undefined;
-    onBackButton(callback: () => void): () => void;
-    setBackButtonVisibility(visible: boolean): void;
-    openExternalLink(url: string): Promise<void>;
-    openInternalLink(url: string): Promise<void>;
-    closeApp(): Promise<void>;
-    vibrateImpact(style: ImpactHapticFeedbackStyle): void;
-    vibrateNotification(type: NotificationHapticFeedbackType): void;
-    vibrateSelection(): void;
-    scanQRCode(options?: MiniAppQrScanOptions): Promise<string | null>;
-    requestPhone(): Promise<string | null>;
-    showPopup(options: MiniAppPopupOptions): Promise<string | null>;
-    downloadFile(url: string, filename: string): Promise<void>;
-    private requestPhoneViaEvent;
-    private extractPhone;
-    protected onDestroy(): void;
-}
-
 declare class ShellMiniAppAdapter extends BaseMiniAppAdapter {
     constructor(platform: 'shell_ios' | 'shell_android');
-    supports(capability: MiniAppCapability): boolean | Promise<boolean>;
+    supports(capability: MiniAppCapability): Promise<boolean>;
     scanQRCode(): Promise<string | null>;
     requestNotificationsPermission(): Promise<boolean>;
 }
@@ -439,7 +415,8 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     openExternalLink(url: string): Promise<void>;
     openInternalLink(url: string): Promise<void>;
     enableDebug(state: boolean): void;
-    supports(capability: MiniAppCapability): boolean;
+    private hapticsAvailable;
+    supports(capability: MiniAppCapability): Promise<boolean>;
     bindCssVariables(mapper?: (key: string) => string): void;
     vibrateImpact(style: ImpactHapticFeedbackStyle): void;
     vibrateNotification(type: NotificationHapticFeedbackType): void;
@@ -506,6 +483,7 @@ declare class VKMiniAppAdapter extends BaseMiniAppAdapter {
     getEnvironment(): MiniAppEnvironmentInfo;
     getLaunchParams(): MiniAppLaunchParams | undefined;
     openExternalLink(url: string): Promise<void>;
+    closeApp(): Promise<void>;
     supports(capability: MiniAppCapability): Promise<boolean>;
     requestPhone(): Promise<string | null>;
     requestNotificationsPermission(): Promise<boolean>;
@@ -546,10 +524,10 @@ declare class VKMiniAppAdapter extends BaseMiniAppAdapter {
 declare class WebMiniAppAdapter extends BaseMiniAppAdapter {
     private deferredPrompt;
     constructor();
-    supports(capability: MiniAppCapability): boolean | Promise<boolean>;
+    supports(capability: MiniAppCapability): Promise<boolean>;
     downloadFile(url: string, filename: string): Promise<void>;
     scanQRCode(_options?: MiniAppQrScanOptions): Promise<string | null>;
-    shareUrl(url: string, text: string): void;
+    shareUrl(url: string, text?: string): void;
     addToHomeScreen(): Promise<boolean>;
     checkHomeScreenStatus(): Promise<'added' | 'not_added' | 'unknown' | string>;
 }
@@ -596,4 +574,4 @@ declare function trackPixelEvent(event: string, payload?: Record<string, unknown
 
 declare function getPlatform(): MiniAppPlatform;
 
-export { AdapterProvider, BaseMiniAppAdapter, type CreateAdapterOptions, MaxMiniAppAdapter, type MiniAppAdapter, type MiniAppCapability, type MiniAppEnvironmentInfo, type MiniAppInitOptions, type MiniAppLaunchParams, type MiniAppPlatform, type MiniAppPopupOptions, type MiniAppQrScanOptions, type MiniAppShareStoryOptions, type MiniAppViewportState, ShellMiniAppAdapter, TelegramMiniAppAdapter, VKMiniAppAdapter, WebMiniAppAdapter, configureVkPixel, createAdapter, createShellAPI, detectPlatform, getActiveAdapter, getPlatform, isShell, isShellAndroid, isShellIOS, readShellPlatform, requestShellPushPermission, shell, storeShellToken, trackConversionEvent, trackPixelEvent, useAdapterTheme, useMiniAppAdapter, useSafeArea };
+export { AdapterProvider, BaseMiniAppAdapter, type CreateAdapterOptions, type MiniAppAdapter, type MiniAppCapability, type MiniAppEnvironmentInfo, type MiniAppInitOptions, type MiniAppLaunchParams, type MiniAppPlatform, type MiniAppPopupOptions, type MiniAppQrScanOptions, type MiniAppShareStoryOptions, type MiniAppViewportState, ShellMiniAppAdapter, TelegramMiniAppAdapter, VKMiniAppAdapter, WebMiniAppAdapter, configureVkPixel, createAdapter, createShellAPI, detectPlatform, getActiveAdapter, getPlatform, isShell, isShellAndroid, isShellIOS, readShellPlatform, requestShellPushPermission, shell, storeShellToken, trackConversionEvent, trackPixelEvent, useAdapterTheme, useMiniAppAdapter, useSafeArea };

package/dist/index.d.ts

@@ -139,8 +139,10 @@ interface MiniAppAdapter {
     readonly shell: ShellAPI;
     /**
      * Quick capability check before calling platform specific APIs.
+     * Always asynchronous so callers can rely on a single contract across platforms
+     * (VK resolves capabilities via the async bridge). Always `await` the result.
      */
-    supports(capability: MiniAppCapability): boolean | Promise<boolean>;
+    supports(capability: MiniAppCapability): Promise<boolean>;
     /**
      * Initializes platform SDK. Safe to call multiple times.
      */
@@ -229,9 +231,9 @@ interface MiniAppAdapter {
     /**
      * Strong/weak haptic feedback helpers.
      */
-    vibrateImpact(style: ImpactHapticFeedbackStyle): void;
-    vibrateNotification(type: NotificationHapticFeedbackType): void;
-    vibrateSelection(): void;
+    vibrateImpact(style: ImpactHapticFeedbackStyle): void | Promise<void>;
+    vibrateNotification(type: NotificationHapticFeedbackType): void | Promise<void>;
+    vibrateSelection(): void | Promise<void>;
     /**
      * Notifies when the host view goes to background/foreground (VK only).
      */
@@ -294,7 +296,7 @@ interface MiniAppAdapter {
     /**
      * Shares a URL using platform-specific capabilities.
      */
-    shareUrl?(url: string, text: string): void;
+    shareUrl?(url: string, text?: string): void;
     /**
      * Copies text to the clipboard if supported by the platform.
      */
@@ -328,7 +330,7 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     private readonly disposables;
     readonly shell: ShellAPI;
     protected constructor(platform: MiniAppPlatform, environment?: Partial<MiniAppEnvironmentInfo>);
-    supports(capability: MiniAppCapability): boolean | Promise<boolean>;
+    supports(capability: MiniAppCapability): Promise<boolean>;
     get platform(): MiniAppPlatform;
     init(_options?: MiniAppInitOptions): Promise<void>;
     isReady(): boolean;
@@ -357,7 +359,7 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     }) => void): () => void;
     getViewportInsets(): MiniAppViewportInsets | undefined;
     shareMessage(_message: string): Promise<void>;
-    shareUrl(_url: string, _text: string): void;
+    shareUrl(_url: string, _text?: string): void;
     downloadFile(url: string, filename: string): Promise<void>;
     shareStory(_mediaUrl: string, _options?: MiniAppShareStoryOptions): Promise<void>;
     trackConversionEvent(_event: string, _payload?: Record<string, unknown>): void;
@@ -386,35 +388,9 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     private applyScrollGuards;
 }
 
-declare class MaxMiniAppAdapter extends BaseMiniAppAdapter {
-    private readonly backHandlers;
-    private initData?;
-    private initDataUnsafe?;
-    constructor();
-    init(_options?: MiniAppInitOptions): Promise<void>;
-    supports(capability: MiniAppCapability): boolean;
-    getInitData(): string | undefined;
-    getLaunchParams(): MiniAppLaunchParams | undefined;
-    onBackButton(callback: () => void): () => void;
-    setBackButtonVisibility(visible: boolean): void;
-    openExternalLink(url: string): Promise<void>;
-    openInternalLink(url: string): Promise<void>;
-    closeApp(): Promise<void>;
-    vibrateImpact(style: ImpactHapticFeedbackStyle): void;
-    vibrateNotification(type: NotificationHapticFeedbackType): void;
-    vibrateSelection(): void;
-    scanQRCode(options?: MiniAppQrScanOptions): Promise<string | null>;
-    requestPhone(): Promise<string | null>;
-    showPopup(options: MiniAppPopupOptions): Promise<string | null>;
-    downloadFile(url: string, filename: string): Promise<void>;
-    private requestPhoneViaEvent;
-    private extractPhone;
-    protected onDestroy(): void;
-}
-
 declare class ShellMiniAppAdapter extends BaseMiniAppAdapter {
     constructor(platform: 'shell_ios' | 'shell_android');
-    supports(capability: MiniAppCapability): boolean | Promise<boolean>;
+    supports(capability: MiniAppCapability): Promise<boolean>;
     scanQRCode(): Promise<string | null>;
     requestNotificationsPermission(): Promise<boolean>;
 }
@@ -439,7 +415,8 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     openExternalLink(url: string): Promise<void>;
     openInternalLink(url: string): Promise<void>;
     enableDebug(state: boolean): void;
-    supports(capability: MiniAppCapability): boolean;
+    private hapticsAvailable;
+    supports(capability: MiniAppCapability): Promise<boolean>;
     bindCssVariables(mapper?: (key: string) => string): void;
     vibrateImpact(style: ImpactHapticFeedbackStyle): void;
     vibrateNotification(type: NotificationHapticFeedbackType): void;
@@ -506,6 +483,7 @@ declare class VKMiniAppAdapter extends BaseMiniAppAdapter {
     getEnvironment(): MiniAppEnvironmentInfo;
     getLaunchParams(): MiniAppLaunchParams | undefined;
     openExternalLink(url: string): Promise<void>;
+    closeApp(): Promise<void>;
     supports(capability: MiniAppCapability): Promise<boolean>;
     requestPhone(): Promise<string | null>;
     requestNotificationsPermission(): Promise<boolean>;
@@ -546,10 +524,10 @@ declare class VKMiniAppAdapter extends BaseMiniAppAdapter {
 declare class WebMiniAppAdapter extends BaseMiniAppAdapter {
     private deferredPrompt;
     constructor();
-    supports(capability: MiniAppCapability): boolean | Promise<boolean>;
+    supports(capability: MiniAppCapability): Promise<boolean>;
     downloadFile(url: string, filename: string): Promise<void>;
     scanQRCode(_options?: MiniAppQrScanOptions): Promise<string | null>;
-    shareUrl(url: string, text: string): void;
+    shareUrl(url: string, text?: string): void;
     addToHomeScreen(): Promise<boolean>;
     checkHomeScreenStatus(): Promise<'added' | 'not_added' | 'unknown' | string>;
 }
@@ -596,4 +574,4 @@ declare function trackPixelEvent(event: string, payload?: Record<string, unknown
 
 declare function getPlatform(): MiniAppPlatform;
 
-export { AdapterProvider, BaseMiniAppAdapter, type CreateAdapterOptions, MaxMiniAppAdapter, type MiniAppAdapter, type MiniAppCapability, type MiniAppEnvironmentInfo, type MiniAppInitOptions, type MiniAppLaunchParams, type MiniAppPlatform, type MiniAppPopupOptions, type MiniAppQrScanOptions, type MiniAppShareStoryOptions, type MiniAppViewportState, ShellMiniAppAdapter, TelegramMiniAppAdapter, VKMiniAppAdapter, WebMiniAppAdapter, configureVkPixel, createAdapter, createShellAPI, detectPlatform, getActiveAdapter, getPlatform, isShell, isShellAndroid, isShellIOS, readShellPlatform, requestShellPushPermission, shell, storeShellToken, trackConversionEvent, trackPixelEvent, useAdapterTheme, useMiniAppAdapter, useSafeArea };
+export { AdapterProvider, BaseMiniAppAdapter, type CreateAdapterOptions, type MiniAppAdapter, type MiniAppCapability, type MiniAppEnvironmentInfo, type MiniAppInitOptions, type MiniAppLaunchParams, type MiniAppPlatform, type MiniAppPopupOptions, type MiniAppQrScanOptions, type MiniAppShareStoryOptions, type MiniAppViewportState, ShellMiniAppAdapter, TelegramMiniAppAdapter, VKMiniAppAdapter, WebMiniAppAdapter, configureVkPixel, createAdapter, createShellAPI, detectPlatform, getActiveAdapter, getPlatform, isShell, isShellAndroid, isShellIOS, readShellPlatform, requestShellPushPermission, shell, storeShellToken, trackConversionEvent, trackPixelEvent, useAdapterTheme, useMiniAppAdapter, useSafeArea };