@wowlabtech/mini-app-adapter 0.2.2 → 0.2.4

package/dist/index.d.cts

@@ -66,7 +66,7 @@ interface MiniAppInitOptions {
      */
     debug?: boolean;
     /**
-     * Dynamically loads Eruda devtools if supported.
+     * Enables Eruda devtools when host app already exposed `window.eruda`.
      */
     eruda?: boolean;
     /**
@@ -75,13 +75,45 @@ interface MiniAppInitOptions {
     mockForMacOS?: boolean;
 }
 interface MiniAppShareStoryOptions {
+    /**
+     * Shared story caption. Used by Telegram directly.
+     * For VK this value is converted into a simple text sticker when `vk.stickers` is not provided.
+     */
     text?: string;
-    widgetLink?: {
+    /**
+     * Universal CTA link.
+     * Telegram maps it to `widgetLink`, VK maps it to `attachment` when custom VK attachment is not provided.
+     */
+    link?: {
         url: string;
         name?: string;
     };
+    /**
+     * Telegram-specific options.
+     */
+    telegram?: {
+        text?: string;
+        widgetLink?: {
+            url: string;
+            name?: string;
+        };
+    };
+    /**
+     * VK-specific options.
+     */
+    vk?: {
+        backgroundType?: 'image' | 'video';
+        locked?: boolean;
+        attachment?: {
+            type: string;
+            text?: string;
+            url?: string;
+            [key: string]: unknown;
+        };
+        stickers?: Array<Record<string, unknown>>;
+    };
 }
-type MiniAppCapability = 'haptics' | 'popup' | 'qrScanner' | 'closeApp' | 'backButton' | 'backButtonVisibility' | 'bindCssVariables' | 'requestPhone' | 'notifications';
+type MiniAppCapability = 'haptics' | 'popup' | 'qrScanner' | 'closeApp' | 'backButton' | 'backButtonVisibility' | 'bindCssVariables' | 'requestPhone' | 'notifications' | 'openInternalLink' | 'requestFullscreen' | 'verticalSwipes' | 'viewVisibility' | 'shareUrl' | 'shareStory' | 'copyTextToClipboard' | 'downloadFile' | 'addToHomeScreen' | 'checkHomeScreenStatus' | 'denyNotifications';
 interface MiniAppPopupButton {
     id: string;
     text?: string;
@@ -307,7 +339,7 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     onPushToken(callback: (token: string) => void): () => void;
     onDeepLink(callback: (path: string) => void): () => void;
     openExternalLink(url: string): Promise<void>;
-    openInternalLink(_url: string): Promise<void>;
+    openInternalLink(url: string): Promise<void>;
     closeApp(): Promise<void>;
     setBackButtonVisibility(_visible: boolean): void;
     onAppearanceChange(callback: (appearance: 'dark' | 'light' | undefined) => void): () => void;
@@ -361,6 +393,7 @@ declare class MaxMiniAppAdapter extends BaseMiniAppAdapter {
     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;
@@ -505,6 +538,7 @@ declare class VKMiniAppAdapter extends BaseMiniAppAdapter {
 declare class WebMiniAppAdapter extends BaseMiniAppAdapter {
     private deferredPrompt;
     constructor();
+    supports(capability: MiniAppCapability): boolean | Promise<boolean>;
     downloadFile(url: string, filename: string): Promise<void>;
     scanQRCode(_options?: MiniAppQrScanOptions): Promise<string | null>;
     shareUrl(url: string, text: string): void;

package/dist/index.d.ts

@@ -66,7 +66,7 @@ interface MiniAppInitOptions {
      */
     debug?: boolean;
     /**
-     * Dynamically loads Eruda devtools if supported.
+     * Enables Eruda devtools when host app already exposed `window.eruda`.
      */
     eruda?: boolean;
     /**
@@ -75,13 +75,45 @@ interface MiniAppInitOptions {
     mockForMacOS?: boolean;
 }
 interface MiniAppShareStoryOptions {
+    /**
+     * Shared story caption. Used by Telegram directly.
+     * For VK this value is converted into a simple text sticker when `vk.stickers` is not provided.
+     */
     text?: string;
-    widgetLink?: {
+    /**
+     * Universal CTA link.
+     * Telegram maps it to `widgetLink`, VK maps it to `attachment` when custom VK attachment is not provided.
+     */
+    link?: {
         url: string;
         name?: string;
     };
+    /**
+     * Telegram-specific options.
+     */
+    telegram?: {
+        text?: string;
+        widgetLink?: {
+            url: string;
+            name?: string;
+        };
+    };
+    /**
+     * VK-specific options.
+     */
+    vk?: {
+        backgroundType?: 'image' | 'video';
+        locked?: boolean;
+        attachment?: {
+            type: string;
+            text?: string;
+            url?: string;
+            [key: string]: unknown;
+        };
+        stickers?: Array<Record<string, unknown>>;
+    };
 }
-type MiniAppCapability = 'haptics' | 'popup' | 'qrScanner' | 'closeApp' | 'backButton' | 'backButtonVisibility' | 'bindCssVariables' | 'requestPhone' | 'notifications';
+type MiniAppCapability = 'haptics' | 'popup' | 'qrScanner' | 'closeApp' | 'backButton' | 'backButtonVisibility' | 'bindCssVariables' | 'requestPhone' | 'notifications' | 'openInternalLink' | 'requestFullscreen' | 'verticalSwipes' | 'viewVisibility' | 'shareUrl' | 'shareStory' | 'copyTextToClipboard' | 'downloadFile' | 'addToHomeScreen' | 'checkHomeScreenStatus' | 'denyNotifications';
 interface MiniAppPopupButton {
     id: string;
     text?: string;
@@ -307,7 +339,7 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     onPushToken(callback: (token: string) => void): () => void;
     onDeepLink(callback: (path: string) => void): () => void;
     openExternalLink(url: string): Promise<void>;
-    openInternalLink(_url: string): Promise<void>;
+    openInternalLink(url: string): Promise<void>;
     closeApp(): Promise<void>;
     setBackButtonVisibility(_visible: boolean): void;
     onAppearanceChange(callback: (appearance: 'dark' | 'light' | undefined) => void): () => void;
@@ -361,6 +393,7 @@ declare class MaxMiniAppAdapter extends BaseMiniAppAdapter {
     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;
@@ -505,6 +538,7 @@ declare class VKMiniAppAdapter extends BaseMiniAppAdapter {
 declare class WebMiniAppAdapter extends BaseMiniAppAdapter {
     private deferredPrompt;
     constructor();
+    supports(capability: MiniAppCapability): boolean | Promise<boolean>;
     downloadFile(url: string, filename: string): Promise<void>;
     scanQRCode(_options?: MiniAppQrScanOptions): Promise<string | null>;
     shareUrl(url: string, text: string): void;

package/dist/index.js

@@ -421,7 +421,7 @@ async function startHtml5Qrcode() {
   if (typeof document === "undefined") {
     throw new Error("QR scanning requires a browser environment.");
   }
-  const [{ Html5Qrcode: Html5Qrcode2 }] = await Promise.all([import("html5-qrcode")]);
+  const [{ Html5Qrcode }] = await Promise.all([import("html5-qrcode")]);
   return new Promise((resolve, reject) => {
     const elementId = `native-shell-qr-${Date.now()}`;
     const overlay = document.createElement("div");
@@ -458,7 +458,7 @@ async function startHtml5Qrcode() {
     const previousOverflow = document.body.style.overflow;
     document.body.style.overflow = "hidden";
     let disposed = false;
-    const scanner = new Html5Qrcode2(elementId);
+    const scanner = new Html5Qrcode(elementId);
     const cleanup = async (result, error) => {
       if (disposed) {
         return;
@@ -580,7 +580,8 @@ var BaseMiniAppAdapter = class {
   async openExternalLink(url) {
     window.open(url, "_blank", "noopener,noreferrer");
   }
-  async openInternalLink(_url) {
+  async openInternalLink(url) {
+    window.open(url, "_self", "noopener,noreferrer");
   }
   async closeApp() {
     if (window.history.length > 1) {
@@ -806,6 +807,10 @@ var MaxMiniAppAdapter = class extends BaseMiniAppAdapter {
         return Boolean(bridge2?.BackButton?.onClick);
       case "backButtonVisibility":
         return Boolean(bridge2?.BackButton?.show && bridge2.BackButton.hide);
+      case "openInternalLink":
+        return typeof bridge2?.openMaxLink === "function";
+      case "downloadFile":
+        return typeof bridge2?.downloadFile === "function";
       case "requestPhone":
         if (!bridge2) {
           return false;
@@ -860,6 +865,14 @@ var MaxMiniAppAdapter = class extends BaseMiniAppAdapter {
     }
     await super.openExternalLink(url);
   }
+  async openInternalLink(url) {
+    const bridge2 = getMaxBridge();
+    if (bridge2?.openMaxLink) {
+      bridge2.openMaxLink(url);
+      return;
+    }
+    await super.openInternalLink(url);
+  }
   async closeApp() {
     const bridge2 = getMaxBridge();
     if (bridge2?.close) {
@@ -1287,6 +1300,30 @@ var TelegramMiniAppAdapter = class extends BaseMiniAppAdapter {
         return backButton.hide.isSupported();
       case "bindCssVariables":
         return true;
+      case "openInternalLink":
+        return true;
+      case "requestFullscreen":
+        return Boolean(
+          typeof rawViewport.requestFullscreen === "function" || viewport.requestFullscreen?.isAvailable?.()
+        );
+      case "verticalSwipes":
+        return Boolean(
+          swipeBehavior.enableVertical.isAvailable() || swipeBehavior.disableVertical.isAvailable()
+        );
+      case "viewVisibility":
+        return true;
+      case "shareUrl":
+        return typeof shareURLSdk === "function";
+      case "shareStory":
+        return typeof shareStorySdk === "function";
+      case "copyTextToClipboard":
+        return typeof copyTextToClipboardSdk === "function";
+      case "downloadFile":
+        return typeof downloadFileSdk === "function";
+      case "addToHomeScreen":
+        return typeof addToHomeScreenSdk?.isAvailable === "function" ? addToHomeScreenSdk.isAvailable() : typeof addToHomeScreenSdk === "function";
+      case "checkHomeScreenStatus":
+        return typeof checkHomeScreenStatusSdk === "function";
       case "requestPhone": {
         return Boolean(isFeatureAvailable(requestPhoneAccess) || isFeatureAvailable(requestContact));
       }
@@ -1532,7 +1569,15 @@ var TelegramMiniAppAdapter = class extends BaseMiniAppAdapter {
     await super.downloadFile(url, filename);
   }
   async shareStory(mediaUrl, options) {
-    shareStorySdk(mediaUrl, options);
+    const text = options?.telegram?.text ?? options?.text;
+    const widgetLink = options?.telegram?.widgetLink ?? (options?.link ? {
+      url: options.link.url,
+      ...options.link.name ? { name: options.link.name } : {}
+    } : void 0);
+    shareStorySdk(mediaUrl, {
+      ...text ? { text } : {},
+      ...widgetLink ? { widgetLink } : {}
+    });
   }
   async addToHomeScreen() {
     const isAvailable = typeof addToHomeScreenSdk?.isAvailable === "function" ? addToHomeScreenSdk.isAvailable() : true;
@@ -1889,17 +1934,41 @@ var VKMiniAppAdapter = class extends BaseMiniAppAdapter {
     };
   }
   async supports(capability) {
-    if (capability === "requestPhone") {
-      const [supportsPhoneNumber, supportsPersonalCard] = await Promise.all([
-        this.supportsBridgeMethod("VKWebAppGetPhoneNumber"),
-        this.supportsBridgeMethod("VKWebAppGetPersonalCard")
-      ]);
-      return supportsPhoneNumber || supportsPersonalCard;
-    }
-    if (capability === "notifications") {
-      return this.supportsBridgeMethod("VKWebAppAllowNotifications");
+    switch (capability) {
+      case "haptics": {
+        const [impact, notification, selection] = await Promise.all([
+          this.supportsBridgeMethod("VKWebAppTapticImpactOccurred"),
+          this.supportsBridgeMethod("VKWebAppTapticNotificationOccurred"),
+          this.supportsBridgeMethod("VKWebAppTapticSelectionChanged")
+        ]);
+        return impact || notification || selection;
+      }
+      case "qrScanner":
+        return this.supportsBridgeMethod("VKWebAppOpenCodeReader");
+      case "requestPhone": {
+        const [supportsPhoneNumber, supportsPersonalCard] = await Promise.all([
+          this.supportsBridgeMethod("VKWebAppGetPhoneNumber"),
+          this.supportsBridgeMethod("VKWebAppGetPersonalCard")
+        ]);
+        return supportsPhoneNumber || supportsPersonalCard;
+      }
+      case "notifications":
+        return this.supportsBridgeMethod("VKWebAppAllowNotifications");
+      case "shareUrl":
+        return this.supportsBridgeMethod("VKWebAppShare");
+      case "shareStory":
+        return this.supportsBridgeMethod("VKWebAppShowStoryBox");
+      case "downloadFile":
+        return this.supportsBridgeMethod("VKWebAppDownloadFile");
+      case "addToHomeScreen":
+        return this.supportsBridgeMethod("VKWebAppAddToHomeScreen");
+      case "denyNotifications":
+        return this.supportsBridgeMethod("VKWebAppDenyNotifications");
+      case "viewVisibility":
+        return true;
+      default:
+        return await super.supports(capability);
     }
-    return await super.supports(capability);
   }
   async requestPhone() {
     const [supportsPhoneNumber, supportsPersonalCard] = await Promise.all([
@@ -2001,9 +2070,34 @@ var VKMiniAppAdapter = class extends BaseMiniAppAdapter {
     };
   }
   async shareStory(mediaUrl, _options) {
+    const options = _options;
+    const vkOptions = options?.vk;
+    const fallbackAttachment = options?.link ? {
+      type: "url",
+      text: "open",
+      url: options.link.url
+    } : void 0;
+    const fallbackStickers = options?.text ? [{
+      sticker_type: "native",
+      sticker: {
+        action_type: "text",
+        action: {
+          text: options.text,
+          style: "classic",
+          background_style: "none"
+        },
+        transform: {
+          gravity: "center_bottom",
+          translation_y: -0.2
+        }
+      }
+    }] : void 0;
     const bridgeOptions = {
-      background_type: "image",
-      url: mediaUrl
+      background_type: vkOptions?.backgroundType ?? "image",
+      url: mediaUrl,
+      locked: vkOptions?.locked ?? true,
+      ...vkOptions?.attachment ?? fallbackAttachment ? { attachment: vkOptions?.attachment ?? fallbackAttachment } : {},
+      ...vkOptions?.stickers ?? fallbackStickers ? { stickers: vkOptions?.stickers ?? fallbackStickers } : {}
     };
     await bridge.send("VKWebAppShowStoryBox", bridgeOptions);
   }
@@ -2376,7 +2470,7 @@ var VKMiniAppAdapter = class extends BaseMiniAppAdapter {
 };
 
 // src/adapters/webAdapter.ts
-import { Html5Qrcode } from "html5-qrcode";
+import jsQR from "jsqr";
 var WebMiniAppAdapter = class extends BaseMiniAppAdapter {
   constructor() {
     super("web", {
@@ -2392,6 +2486,22 @@ var WebMiniAppAdapter = class extends BaseMiniAppAdapter {
       });
     }
   }
+  supports(capability) {
+    switch (capability) {
+      case "copyTextToClipboard":
+        return typeof navigator !== "undefined" && Boolean(navigator.clipboard?.writeText);
+      case "downloadFile":
+        return typeof document !== "undefined";
+      case "shareUrl":
+        return typeof navigator !== "undefined" && (Boolean(navigator.share) || Boolean(navigator.clipboard?.writeText));
+      case "addToHomeScreen":
+        return /android/i.test(navigator.userAgent) && Boolean(this.deferredPrompt);
+      case "checkHomeScreenStatus":
+        return true;
+      default:
+        return super.supports(capability);
+    }
+  }
   async downloadFile(url, filename) {
     try {
       await triggerFileDownload(url, filename, { preferBlob: true });
@@ -2446,14 +2556,31 @@ var WebMiniAppAdapter = class extends BaseMiniAppAdapter {
       closeBtn.style.cursor = "pointer";
       closeBtn.style.zIndex = "9999999999";
       overlay.appendChild(closeBtn);
+      const scanSize = Math.min(Math.floor(Math.min(window.innerWidth, window.innerHeight) * 0.72), 320);
+      const scanBox = document.createElement("div");
+      scanBox.style.width = `${scanSize}px`;
+      scanBox.style.height = `${scanSize}px`;
+      scanBox.style.position = "relative";
+      scanBox.style.flex = "0 0 auto";
+      scanBox.style.borderRadius = "18px";
+      scanBox.style.overflow = "hidden";
+      overlay.appendChild(scanBox);
       const scanArea = document.createElement("div");
-      scanArea.id = "qr-reader";
-      scanArea.style.width = "300px";
-      scanArea.style.height = "300px";
-      scanArea.style.borderRadius = "18px";
-      scanArea.style.overflow = "hidden";
-      scanArea.style.position = "relative";
-      overlay.appendChild(scanArea);
+      scanArea.style.position = "absolute";
+      scanArea.style.inset = "0";
+      scanArea.style.zIndex = "1";
+      scanArea.style.background = "#000";
+      scanBox.appendChild(scanArea);
+      const video = document.createElement("video");
+      video.setAttribute("playsinline", "true");
+      video.autoplay = true;
+      video.muted = true;
+      video.style.width = "100%";
+      video.style.height = "100%";
+      video.style.objectFit = "cover";
+      video.style.position = "absolute";
+      video.style.inset = "0";
+      scanArea.appendChild(video);
       const frame = document.createElement("div");
       frame.style.position = "absolute";
       frame.style.top = "0";
@@ -2463,8 +2590,8 @@ var WebMiniAppAdapter = class extends BaseMiniAppAdapter {
       frame.style.border = "3px solid rgba(255,255,255,0.9)";
       frame.style.borderRadius = "18px";
       frame.style.pointerEvents = "none";
-      frame.style.zIndex = "10";
-      scanArea.appendChild(frame);
+      frame.style.zIndex = "3";
+      scanBox.appendChild(frame);
       const line = document.createElement("div");
       line.style.position = "absolute";
       line.style.left = "0";
@@ -2473,8 +2600,8 @@ var WebMiniAppAdapter = class extends BaseMiniAppAdapter {
       line.style.background = "rgba(255,255,255,0.85)";
       line.style.borderRadius = "2px";
       line.style.animation = "qr-line 2s infinite";
-      line.style.zIndex = "11";
-      scanArea.appendChild(line);
+      line.style.zIndex = "4";
+      scanBox.appendChild(line);
       const styleTag = document.createElement("style");
       styleTag.innerHTML = `
         @keyframes qr-line {
@@ -2491,17 +2618,26 @@ var WebMiniAppAdapter = class extends BaseMiniAppAdapter {
       hint.style.fontSize = "17px";
       hint.style.opacity = "0.9";
       overlay.appendChild(hint);
-      const scanner = new Html5Qrcode("qr-reader");
+      const canvas = document.createElement("canvas");
+      const context = canvas.getContext("2d", { willReadFrequently: true });
+      let stream = null;
+      let rafId = null;
+      let lastScanAt = 0;
       let closed = false;
       const finalize = async (result) => {
         if (closed) {
           return;
         }
         closed = true;
-        try {
-          await scanner.stop();
-        } catch {
+        if (rafId !== null) {
+          cancelAnimationFrame(rafId);
+          rafId = null;
+        }
+        if (stream) {
+          stream.getTracks().forEach((track) => track.stop());
+          stream = null;
         }
+        video.srcObject = null;
         overlay.remove();
         styleTag.remove();
         document.body.style.overflow = prevOverflow;
@@ -2520,19 +2656,50 @@ var WebMiniAppAdapter = class extends BaseMiniAppAdapter {
       };
       closeBtn.onclick = () => closeScanner(null);
       try {
-        await scanner.start(
-          { facingMode: "environment" },
-          {
-            fps: 10,
-            qrbox: { width: 250, height: 250 },
-            aspectRatio: 1
-          },
-          (decodedText) => {
-            closeScanner(decodedText);
-          },
-          () => {
+        const constraints = [
+          { video: { facingMode: { ideal: "environment" } }, audio: false },
+          { video: { facingMode: "environment" }, audio: false },
+          { video: true, audio: false }
+        ];
+        let lastError = null;
+        for (const constraint of constraints) {
+          try {
+            stream = await navigator.mediaDevices.getUserMedia(constraint);
+            break;
+          } catch (error) {
+            lastError = error;
           }
-        );
+        }
+        if (!stream) {
+          throw lastError instanceof Error ? lastError : new Error("Unable to access camera");
+        }
+        video.srcObject = stream;
+        await video.play();
+        const scanFrame = (now) => {
+          if (closed) {
+            return;
+          }
+          if (now - lastScanAt >= 100 && context && video.readyState >= HTMLMediaElement.HAVE_CURRENT_DATA) {
+            const width = video.videoWidth;
+            const height = video.videoHeight;
+            if (width > 0 && height > 0) {
+              canvas.width = width;
+              canvas.height = height;
+              context.drawImage(video, 0, 0, width, height);
+              const imageData = context.getImageData(0, 0, width, height);
+              const result = jsQR(imageData.data, width, height, {
+                inversionAttempts: "attemptBoth"
+              });
+              if (result?.data) {
+                closeScanner(result.data);
+                return;
+              }
+              lastScanAt = now;
+            }
+          }
+          rafId = requestAnimationFrame(scanFrame);
+        };
+        rafId = requestAnimationFrame(scanFrame);
       } catch (error) {
         console.error("QR Start error", error);
         closeScanner(null);
@@ -2585,6 +2752,8 @@ ${url}` : url;
 };
 
 // src/adapters/index.ts
+var CONFIRMED_PLATFORM_STORAGE_KEY = "mini-app-adapter:confirmed-platform";
+var CONFIRMED_PLATFORM_TTL_MS = 30 * 60 * 1e3;
 function detectPlatform() {
   if (typeof window === "undefined") {
     return "web";
@@ -2596,30 +2765,76 @@ function detectPlatform() {
   })();
   const getParam = (name) => searchParams.get(name) ?? hashParams.get(name);
   const hasParam = (...names) => names.some((name) => getParam(name));
+  const readConfirmedPlatform = () => {
+    try {
+      const raw = window.sessionStorage.getItem(CONFIRMED_PLATFORM_STORAGE_KEY);
+      if (!raw) {
+        return null;
+      }
+      const parsed = JSON.parse(raw);
+      if (!parsed?.platform || typeof parsed.ts !== "number") {
+        return null;
+      }
+      if (Date.now() - parsed.ts > CONFIRMED_PLATFORM_TTL_MS) {
+        return null;
+      }
+      return parsed.platform;
+    } catch {
+      return null;
+    }
+  };
+  const persistConfirmedPlatform = (platform) => {
+    if (platform === "web") {
+      return;
+    }
+    try {
+      window.sessionStorage.setItem(
+        CONFIRMED_PLATFORM_STORAGE_KEY,
+        JSON.stringify({ platform, ts: Date.now() })
+      );
+    } catch {
+    }
+  };
   const shellPlatform = readShellPlatform();
   if (shellPlatform) {
+    persistConfirmedPlatform(shellPlatform);
     return shellPlatform;
   }
   const userAgent = navigator.userAgent.toLowerCase();
   const hasNativeBridge = typeof window.NativeBridge?.postMessage === "function";
   if (hasNativeBridge) {
     if (userAgent.includes("android")) {
+      persistConfirmedPlatform("shell_android");
       return "shell_android";
     }
+    persistConfirmedPlatform("shell_ios");
     return "shell_ios";
   }
-  if (window.Telegram?.WebApp || hasParam("tgWebAppPlatform", "tgWebAppVersion", "tgWebAppData", "tgWebAppLanguage") || userAgent.includes("telegram")) {
+  const telegramGlobals = window;
+  const hasTelegramGlobal = Boolean(window.Telegram?.WebApp) || typeof telegramGlobals.TelegramWebviewProxy !== "undefined" || typeof telegramGlobals.TelegramGameProxy !== "undefined";
+  const hasTelegramParams = hasParam("tgWebAppPlatform", "tgWebAppVersion", "tgWebAppData", "tgWebAppLanguage");
+  if (hasTelegramGlobal || hasTelegramParams || userAgent.includes("telegram")) {
+    persistConfirmedPlatform("telegram");
     return "telegram";
   }
   if (window.WebApp) {
+    persistConfirmedPlatform("max");
     return "max";
   }
   if (window.MaxMiniApp) {
+    persistConfirmedPlatform("max");
     return "max";
   }
-  if (hasParam("vk_app_id", "vk_platform")) {
+  const hasVkParams = hasParam("vk_app_id", "vk_platform", "vk_user_id", "vk_language", "sign");
+  const hasVkUserAgentSignal = userAgent.includes("vkclient") || userAgent.includes("vk-android") || userAgent.includes("vkontakte");
+  if (hasVkParams || hasVkUserAgentSignal) {
+    persistConfirmedPlatform("vk");
     return "vk";
   }
+  const confirmedPlatform = readConfirmedPlatform();
+  if (confirmedPlatform && confirmedPlatform !== "web") {
+    return confirmedPlatform;
+  }
   return "web";
 }
 function createAdapter(input) {
@@ -2820,14 +3035,18 @@ var cachedPlatform = null;
 function getPlatform() {
   const adapter = getActiveAdapter();
   if (adapter) {
-    cachedPlatform = adapter.platform;
+    if (adapter.platform !== "web") {
+      cachedPlatform = adapter.platform;
+    }
     return adapter.platform;
   }
-  if (cachedPlatform) {
+  if (cachedPlatform && cachedPlatform !== "web") {
     return cachedPlatform;
   }
   const detectedPlatform = detectPlatform();
-  cachedPlatform = detectedPlatform;
+  if (detectedPlatform !== "web") {
+    cachedPlatform = detectedPlatform;
+  }
   return detectedPlatform;
 }