@wowlabtech/mini-app-adapter 0.2.0 → 0.2.1

package/dist/index.d.cts

@@ -216,6 +216,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.
      */
@@ -311,6 +326,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;
@@ -393,6 +411,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;
@@ -430,10 +450,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 +485,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 {

package/dist/index.d.ts

@@ -216,6 +216,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.
      */
@@ -311,6 +326,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;
@@ -393,6 +411,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;
@@ -430,10 +450,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 +485,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 {

package/dist/index.js

@@ -681,6 +681,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 +1029,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
@@ -1433,6 +1456,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) {
@@ -1774,6 +1841,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 +1909,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 +2286,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 +2441,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