@wowlabtech/mini-app-adapter 0.2.0 → 0.2.2

package/dist/index.d.cts

@@ -56,6 +56,10 @@ interface MiniAppViewportInsets {
     safeArea: MiniAppSafeAreaInsets;
     contentSafeArea: MiniAppSafeAreaInsets;
 }
+interface MiniAppViewportState {
+    height: number;
+    stableHeight: number;
+}
 interface MiniAppInitOptions {
     /**
      * Enables verbose logs for platforms that support it.
@@ -170,6 +174,10 @@ interface MiniAppAdapter {
      * Requests fullscreen mode if supported by the platform.
      */
     requestFullscreen?(): void;
+    /**
+     * Subscribes to viewport size changes. Returns disposer.
+     */
+    onViewportChange?(callback: (state: MiniAppViewportState) => void): () => void;
     /**
      * Returns viewport safe area insets if supported by the platform.
      */
@@ -216,6 +224,21 @@ interface MiniAppAdapter {
      * Resolves with true if permission was granted.
      */
     requestNotificationsPermission?(): Promise<boolean>;
+    /**
+     * Prompts user to add the mini app to the home screen if supported.
+     * Resolves with true when the prompt succeeded.
+     */
+    addToHomeScreen?(): Promise<boolean>;
+    /**
+     * Checks whether the mini app is already added to the home screen, if supported.
+     * Returns platform-specific status or 'unknown' when not available.
+     */
+    checkHomeScreenStatus?(): Promise<'added' | 'not_added' | 'unknown' | string>;
+    /**
+     * Revokes/denies push notifications if supported by the platform.
+     * Resolves with true if notifications were disabled.
+     */
+    denyNotifications?(): Promise<boolean>;
     /**
      * Subscribes to push token updates delivered by native shells.
      */
@@ -292,6 +315,10 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     getLaunchParams(): unknown;
     decodeStartParam(_param: string): unknown;
     requestFullscreen(): void;
+    onViewportChange(callback: (state: {
+        height: number;
+        stableHeight: number;
+    }) => void): () => void;
     getViewportInsets(): MiniAppViewportInsets | undefined;
     shareMessage(_message: string): Promise<void>;
     shareUrl(_url: string, _text: string): void;
@@ -311,6 +338,9 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     scanQRCode(_options?: MiniAppQrScanOptions): Promise<string | null>;
     requestPhone(): Promise<string | null>;
     requestNotificationsPermission(): Promise<boolean>;
+    addToHomeScreen(): Promise<boolean>;
+    checkHomeScreenStatus(): Promise<'added' | 'not_added' | 'unknown' | string>;
+    denyNotifications(): Promise<boolean>;
     enableVerticalSwipes(): void;
     disableVerticalSwipes(): void;
     protected notifyEnvironmentChanged(): void;
@@ -384,6 +414,10 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     decodeStartParam(param: string): unknown;
     requestFullscreen(): void;
     getViewportInsets(): MiniAppViewportInsets | undefined;
+    onViewportChange(callback: (state: {
+        height: number;
+        stableHeight: number;
+    }) => void): () => void;
     onAppearanceChange(callback: (appearance: 'dark' | 'light' | undefined) => void): () => void;
     setBackButtonVisibility(visible: boolean): void;
     enableVerticalSwipes(): void;
@@ -393,6 +427,8 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     shareUrl(url: string, text?: string): void;
     downloadFile(url: string, filename: string): Promise<void>;
     shareStory(mediaUrl: string, options?: MiniAppShareStoryOptions): Promise<void>;
+    addToHomeScreen(): Promise<boolean>;
+    checkHomeScreenStatus(): Promise<'added' | 'not_added' | 'unknown' | string>;
     requestPhone(): Promise<string | null>;
     private setupAppearanceWatcher;
     private notifyAppearance;
@@ -400,6 +436,8 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     private prepareViewport;
     private requestFullscreenInternal;
     private getViewportMountOptions;
+    private safeHeightFromSdk;
+    private stableHeightFromSdk;
     private notifyViewHide;
     private notifyViewRestore;
     protected onDestroy(): void;
@@ -430,10 +468,14 @@ declare class VKMiniAppAdapter extends BaseMiniAppAdapter {
     supports(capability: MiniAppCapability): Promise<boolean>;
     requestPhone(): Promise<string | null>;
     requestNotificationsPermission(): Promise<boolean>;
+    addToHomeScreen(): Promise<boolean>;
+    denyNotifications(): Promise<boolean>;
     scanQRCode(options?: MiniAppQrScanOptions): Promise<string | null>;
     onViewHide(callback: () => void): () => void;
     onViewRestore(callback: () => void): () => void;
     shareStory(mediaUrl: string, _options?: MiniAppShareStoryOptions): Promise<void>;
+    shareUrl(url: string, text?: string): void;
+    private shareUrlInternal;
     downloadFile(url: string, filename: string): Promise<void>;
     trackConversionEvent(event: string, payload?: Record<string, unknown>): void;
     trackPixelEvent(event: string, payload?: Record<string, unknown>): void;
@@ -461,9 +503,13 @@ declare class VKMiniAppAdapter extends BaseMiniAppAdapter {
 }
 
 declare class WebMiniAppAdapter extends BaseMiniAppAdapter {
+    private deferredPrompt;
     constructor();
     downloadFile(url: string, filename: string): Promise<void>;
     scanQRCode(_options?: MiniAppQrScanOptions): Promise<string | null>;
+    shareUrl(url: string, text: string): void;
+    addToHomeScreen(): Promise<boolean>;
+    checkHomeScreenStatus(): Promise<'added' | 'not_added' | 'unknown' | string>;
 }
 
 interface CreateAdapterOptions {
@@ -508,4 +554,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 MiniAppPlatform, type MiniAppPopupOptions, type MiniAppQrScanOptions, 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, MaxMiniAppAdapter, type MiniAppAdapter, type MiniAppCapability, type MiniAppEnvironmentInfo, type MiniAppInitOptions, type MiniAppPlatform, type MiniAppPopupOptions, type MiniAppQrScanOptions, 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

@@ -56,6 +56,10 @@ interface MiniAppViewportInsets {
     safeArea: MiniAppSafeAreaInsets;
     contentSafeArea: MiniAppSafeAreaInsets;
 }
+interface MiniAppViewportState {
+    height: number;
+    stableHeight: number;
+}
 interface MiniAppInitOptions {
     /**
      * Enables verbose logs for platforms that support it.
@@ -170,6 +174,10 @@ interface MiniAppAdapter {
      * Requests fullscreen mode if supported by the platform.
      */
     requestFullscreen?(): void;
+    /**
+     * Subscribes to viewport size changes. Returns disposer.
+     */
+    onViewportChange?(callback: (state: MiniAppViewportState) => void): () => void;
     /**
      * Returns viewport safe area insets if supported by the platform.
      */
@@ -216,6 +224,21 @@ interface MiniAppAdapter {
      * Resolves with true if permission was granted.
      */
     requestNotificationsPermission?(): Promise<boolean>;
+    /**
+     * Prompts user to add the mini app to the home screen if supported.
+     * Resolves with true when the prompt succeeded.
+     */
+    addToHomeScreen?(): Promise<boolean>;
+    /**
+     * Checks whether the mini app is already added to the home screen, if supported.
+     * Returns platform-specific status or 'unknown' when not available.
+     */
+    checkHomeScreenStatus?(): Promise<'added' | 'not_added' | 'unknown' | string>;
+    /**
+     * Revokes/denies push notifications if supported by the platform.
+     * Resolves with true if notifications were disabled.
+     */
+    denyNotifications?(): Promise<boolean>;
     /**
      * Subscribes to push token updates delivered by native shells.
      */
@@ -292,6 +315,10 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     getLaunchParams(): unknown;
     decodeStartParam(_param: string): unknown;
     requestFullscreen(): void;
+    onViewportChange(callback: (state: {
+        height: number;
+        stableHeight: number;
+    }) => void): () => void;
     getViewportInsets(): MiniAppViewportInsets | undefined;
     shareMessage(_message: string): Promise<void>;
     shareUrl(_url: string, _text: string): void;
@@ -311,6 +338,9 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     scanQRCode(_options?: MiniAppQrScanOptions): Promise<string | null>;
     requestPhone(): Promise<string | null>;
     requestNotificationsPermission(): Promise<boolean>;
+    addToHomeScreen(): Promise<boolean>;
+    checkHomeScreenStatus(): Promise<'added' | 'not_added' | 'unknown' | string>;
+    denyNotifications(): Promise<boolean>;
     enableVerticalSwipes(): void;
     disableVerticalSwipes(): void;
     protected notifyEnvironmentChanged(): void;
@@ -384,6 +414,10 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     decodeStartParam(param: string): unknown;
     requestFullscreen(): void;
     getViewportInsets(): MiniAppViewportInsets | undefined;
+    onViewportChange(callback: (state: {
+        height: number;
+        stableHeight: number;
+    }) => void): () => void;
     onAppearanceChange(callback: (appearance: 'dark' | 'light' | undefined) => void): () => void;
     setBackButtonVisibility(visible: boolean): void;
     enableVerticalSwipes(): void;
@@ -393,6 +427,8 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     shareUrl(url: string, text?: string): void;
     downloadFile(url: string, filename: string): Promise<void>;
     shareStory(mediaUrl: string, options?: MiniAppShareStoryOptions): Promise<void>;
+    addToHomeScreen(): Promise<boolean>;
+    checkHomeScreenStatus(): Promise<'added' | 'not_added' | 'unknown' | string>;
     requestPhone(): Promise<string | null>;
     private setupAppearanceWatcher;
     private notifyAppearance;
@@ -400,6 +436,8 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     private prepareViewport;
     private requestFullscreenInternal;
     private getViewportMountOptions;
+    private safeHeightFromSdk;
+    private stableHeightFromSdk;
     private notifyViewHide;
     private notifyViewRestore;
     protected onDestroy(): void;
@@ -430,10 +468,14 @@ declare class VKMiniAppAdapter extends BaseMiniAppAdapter {
     supports(capability: MiniAppCapability): Promise<boolean>;
     requestPhone(): Promise<string | null>;
     requestNotificationsPermission(): Promise<boolean>;
+    addToHomeScreen(): Promise<boolean>;
+    denyNotifications(): Promise<boolean>;
     scanQRCode(options?: MiniAppQrScanOptions): Promise<string | null>;
     onViewHide(callback: () => void): () => void;
     onViewRestore(callback: () => void): () => void;
     shareStory(mediaUrl: string, _options?: MiniAppShareStoryOptions): Promise<void>;
+    shareUrl(url: string, text?: string): void;
+    private shareUrlInternal;
     downloadFile(url: string, filename: string): Promise<void>;
     trackConversionEvent(event: string, payload?: Record<string, unknown>): void;
     trackPixelEvent(event: string, payload?: Record<string, unknown>): void;
@@ -461,9 +503,13 @@ declare class VKMiniAppAdapter extends BaseMiniAppAdapter {
 }
 
 declare class WebMiniAppAdapter extends BaseMiniAppAdapter {
+    private deferredPrompt;
     constructor();
     downloadFile(url: string, filename: string): Promise<void>;
     scanQRCode(_options?: MiniAppQrScanOptions): Promise<string | null>;
+    shareUrl(url: string, text: string): void;
+    addToHomeScreen(): Promise<boolean>;
+    checkHomeScreenStatus(): Promise<'added' | 'not_added' | 'unknown' | string>;
 }
 
 interface CreateAdapterOptions {
@@ -508,4 +554,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 MiniAppPlatform, type MiniAppPopupOptions, type MiniAppQrScanOptions, 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, MaxMiniAppAdapter, type MiniAppAdapter, type MiniAppCapability, type MiniAppEnvironmentInfo, type MiniAppInitOptions, type MiniAppPlatform, type MiniAppPopupOptions, type MiniAppQrScanOptions, 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.js

@@ -607,6 +607,27 @@ var BaseMiniAppAdapter = class {
   }
   requestFullscreen() {
   }
+  onViewportChange(callback) {
+    if (typeof window === "undefined") {
+      return () => {
+      };
+    }
+    const fallbackHeight = () => window.visualViewport?.height ?? window.innerHeight;
+    const notify = () => {
+      const height = fallbackHeight();
+      callback({ height, stableHeight: height });
+    };
+    notify();
+    const onResize = () => notify();
+    window.visualViewport?.addEventListener("resize", onResize);
+    window.visualViewport?.addEventListener("scroll", onResize);
+    window.addEventListener("resize", onResize);
+    return () => {
+      window.visualViewport?.removeEventListener("resize", onResize);
+      window.visualViewport?.removeEventListener("scroll", onResize);
+      window.removeEventListener("resize", onResize);
+    };
+  }
   getViewportInsets() {
     return void 0;
   }
@@ -681,6 +702,25 @@ var BaseMiniAppAdapter = class {
     return null;
   }
   async requestNotificationsPermission() {
+    if (typeof Notification === "undefined" || typeof Notification.requestPermission !== "function") {
+      return false;
+    }
+    try {
+      const permission = await Notification.requestPermission();
+      return permission === "granted";
+    } catch (error) {
+      console.warn("[tvm-app-adapter] requestNotificationsPermission fallback failed:", error);
+      return false;
+    }
+  }
+  async addToHomeScreen() {
+    return false;
+  }
+  async checkHomeScreenStatus() {
+    return "unknown";
+  }
+  async denyNotifications() {
+    console.warn("[tvm-app-adapter] denyNotifications fallback is not supported in this environment.");
     return false;
   }
   enableVerticalSwipes() {
@@ -1010,7 +1050,11 @@ import {
   shareURL as shareURLSdk,
   copyTextToClipboard as copyTextToClipboardSdk,
   downloadFile as downloadFileSdk,
-  shareStory as shareStorySdk
+  shareStory as shareStorySdk,
+  addToHomeScreen as addToHomeScreenSdk,
+  checkHomeScreenStatus as checkHomeScreenStatusSdk,
+  on,
+  off
 } from "@tma.js/sdk";
 
 // src/lib/features.ts
@@ -1356,6 +1400,63 @@ var TelegramMiniAppAdapter = class extends BaseMiniAppAdapter {
       return void 0;
     }
   }
+  onViewportChange(callback) {
+    const disposers = [];
+    const fallbackHeight = () => typeof window !== "undefined" ? window.visualViewport?.height ?? window.innerHeight : 0;
+    const notify = (state) => {
+      const heightCandidate = state?.height ?? this.safeHeightFromSdk();
+      const stableCandidate = state?.stableHeight ?? this.stableHeightFromSdk();
+      const height = Number.isFinite(heightCandidate) ? heightCandidate : fallbackHeight();
+      const stableHeight = Number.isFinite(stableCandidate) && stableCandidate > 0 ? stableCandidate : height;
+      callback({ height, stableHeight });
+    };
+    const ensureMounted = async () => {
+      try {
+        await ensureViewportMounted(this.getViewportMountOptions());
+      } catch (error) {
+        console.warn("[tvm-app-adapter] ensureViewportMounted failed:", error);
+      }
+    };
+    void ensureMounted().finally(() => notify());
+    const { sdkViewport } = this.getViewportMountOptions();
+    if (typeof sdkViewport.on === "function") {
+      try {
+        const off2 = sdkViewport.on("change", (next) => notify(next));
+        if (typeof off2 === "function") {
+          disposers.push(off2);
+        }
+      } catch (error) {
+        console.warn("[tvm-app-adapter] viewport.on(change) subscription failed:", error);
+      }
+    }
+    try {
+      if (typeof sdkViewport.height?.sub === "function") {
+        disposers.push(sdkViewport.height.sub(() => notify()));
+      }
+      if (typeof sdkViewport.stableHeight?.sub === "function") {
+        disposers.push(sdkViewport.stableHeight.sub(() => notify()));
+      }
+    } catch (error) {
+      console.warn("[tvm-app-adapter] viewport signal subscriptions failed:", error);
+    }
+    if (typeof window !== "undefined") {
+      const onResize = () => notify();
+      window.visualViewport?.addEventListener("resize", onResize);
+      window.addEventListener("resize", onResize);
+      disposers.push(() => {
+        window.visualViewport?.removeEventListener("resize", onResize);
+        window.removeEventListener("resize", onResize);
+      });
+    }
+    return () => {
+      disposers.forEach((dispose) => {
+        try {
+          dispose();
+        } catch {
+        }
+      });
+    };
+  }
   onAppearanceChange(callback) {
     this.appearanceListeners.add(callback);
     callback(this.environment.appearance);
@@ -1433,6 +1534,50 @@ var TelegramMiniAppAdapter = class extends BaseMiniAppAdapter {
   async shareStory(mediaUrl, options) {
     shareStorySdk(mediaUrl, options);
   }
+  async addToHomeScreen() {
+    const isAvailable = typeof addToHomeScreenSdk?.isAvailable === "function" ? addToHomeScreenSdk.isAvailable() : true;
+    if (!isAvailable) {
+      return super.addToHomeScreen();
+    }
+    return new Promise((resolve) => {
+      const cleanup = () => {
+        off("home_screen_added", handleSuccess);
+        off("home_screen_failed", handleFail);
+      };
+      const handleSuccess = () => {
+        cleanup();
+        resolve(true);
+      };
+      const handleFail = () => {
+        cleanup();
+        resolve(false);
+      };
+      on("home_screen_added", handleSuccess);
+      on("home_screen_failed", handleFail);
+      try {
+        addToHomeScreenSdk();
+      } catch (error) {
+        cleanup();
+        console.warn("[tvm-app-adapter] Telegram addToHomeScreen failed:", error);
+        resolve(false);
+      }
+    });
+  }
+  async checkHomeScreenStatus() {
+    try {
+      const status = await checkHomeScreenStatusSdk();
+      if (typeof status === "string") {
+        return status;
+      }
+      if (typeof status === "boolean") {
+        return status ? "added" : "not_added";
+      }
+      return "unknown";
+    } catch (error) {
+      console.warn("[tvm-app-adapter] Telegram checkHomeScreenStatus failed:", error);
+      return "unknown";
+    }
+  }
   async requestPhone() {
     const contactFeature = ensureFeature(requestContact);
     if (!contactFeature.ok) {
@@ -1542,6 +1687,26 @@ var TelegramMiniAppAdapter = class extends BaseMiniAppAdapter {
       }
     };
   }
+  safeHeightFromSdk() {
+    try {
+      if (typeof rawViewport.height === "function") {
+        return rawViewport.height();
+      }
+    } catch {
+      return void 0;
+    }
+    return void 0;
+  }
+  stableHeightFromSdk() {
+    try {
+      if (typeof rawViewport.stableHeight === "function") {
+        return rawViewport.stableHeight();
+      }
+    } catch {
+      return void 0;
+    }
+    return void 0;
+  }
   notifyViewHide() {
     for (const listener of this.viewHideListeners) {
       try {
@@ -1774,6 +1939,39 @@ var VKMiniAppAdapter = class extends BaseMiniAppAdapter {
       return false;
     }
   }
+  async addToHomeScreen() {
+    const supported = await this.supportsBridgeMethod("VKWebAppAddToHomeScreen");
+    if (!supported) {
+      console.warn("[tvm-app-adapter] VK addToHomeScreen not supported");
+      return super.addToHomeScreen();
+    }
+    try {
+      const response = await bridge.send("VKWebAppAddToHomeScreen");
+      if (response && typeof response === "object" && "result" in response) {
+        return Boolean(response.result);
+      }
+      return true;
+    } catch (error) {
+      console.warn("[tvm-app-adapter] VK addToHomeScreen failed:", error);
+      return false;
+    }
+  }
+  async denyNotifications() {
+    const supported = await this.supportsBridgeMethod("VKWebAppDenyNotifications");
+    if (!supported) {
+      return super.denyNotifications();
+    }
+    try {
+      const response = await bridge.send("VKWebAppDenyNotifications");
+      if (response && typeof response === "object" && "result" in response) {
+        return Boolean(response.result);
+      }
+      return true;
+    } catch (error) {
+      console.warn("[tvm-app-adapter] VK deny notifications failed:", error);
+      return false;
+    }
+  }
   async scanQRCode(options) {
     const supportsQrScanner = await this.supportsBridgeMethod("VKWebAppOpenCodeReader");
     if (!supportsQrScanner) {
@@ -1809,6 +2007,25 @@ var VKMiniAppAdapter = class extends BaseMiniAppAdapter {
     };
     await bridge.send("VKWebAppShowStoryBox", bridgeOptions);
   }
+  shareUrl(url, text) {
+    void this.shareUrlInternal(url, text);
+  }
+  async shareUrlInternal(url, text) {
+    const supported = await this.supportsBridgeMethod("VKWebAppShare");
+    if (!supported) {
+      super.shareUrl(url, text ?? "");
+      return;
+    }
+    try {
+      await bridge.send("VKWebAppShare", {
+        link: url,
+        ...text ? { text } : {}
+      });
+    } catch (error) {
+      console.warn("[tvm-app-adapter] VK shareUrl failed:", error);
+      super.shareUrl(url, text ?? "");
+    }
+  }
   async downloadFile(url, filename) {
     const supported = await this.supportsBridgeMethod("VKWebAppDownloadFile");
     if (!supported) {
@@ -2167,6 +2384,13 @@ var WebMiniAppAdapter = class extends BaseMiniAppAdapter {
       languageCode: navigator.language,
       isWebView: false
     });
+    __publicField(this, "deferredPrompt", null);
+    if (typeof window !== "undefined") {
+      window.addEventListener("beforeinstallprompt", (event) => {
+        event.preventDefault();
+        this.deferredPrompt = event;
+      });
+    }
   }
   async downloadFile(url, filename) {
     try {
@@ -2315,6 +2539,49 @@ var WebMiniAppAdapter = class extends BaseMiniAppAdapter {
       }
     });
   }
+  shareUrl(url, text) {
+    if (navigator.share) {
+      try {
+        navigator.share({ title: text, text, url });
+        return;
+      } catch (err) {
+        console.warn("Share cancelled or failed:", err);
+      }
+    }
+    const payload = text ? `${text}
+${url}` : url;
+    this.copyTextToClipboard(payload).catch((err) => {
+      console.warn("Share fallback (clipboard) failed:", err);
+    });
+  }
+  async addToHomeScreen() {
+    const isAndroid = /android/i.test(navigator.userAgent);
+    if (!isAndroid || !this.deferredPrompt) {
+      return super.addToHomeScreen();
+    }
+    try {
+      this.deferredPrompt.prompt();
+      const choice = await this.deferredPrompt.userChoice;
+      this.deferredPrompt = null;
+      return choice?.outcome === "accepted";
+    } catch (error) {
+      console.warn("[tvm-app-adapter] Web addToHomeScreen failed:", error);
+      this.deferredPrompt = null;
+      return false;
+    }
+  }
+  async checkHomeScreenStatus() {
+    try {
+      const isStandalone = typeof window !== "undefined" && window.matchMedia?.("(display-mode: standalone)").matches || // iOS Safari specific flag
+      typeof navigator !== "undefined" && navigator.standalone === true;
+      if (isStandalone) {
+        return "added";
+      }
+      return "unknown";
+    } catch {
+      return "unknown";
+    }
+  }
 };
 
 // src/adapters/index.ts