@wowlabtech/mini-app-adapter 0.2.7 → 0.2.81

package/dist/index.d.cts

@@ -60,6 +60,10 @@ interface MiniAppViewportState {
     height: number;
     stableHeight: number;
 }
+interface MiniAppLaunchParams {
+    launchParams?: unknown;
+    customLaunchParams: Record<string, unknown>;
+}
 interface MiniAppInitOptions {
     /**
      * Enables verbose logs for platforms that support it.
@@ -197,7 +201,7 @@ interface MiniAppAdapter {
     /**
      * Reads platform launch parameters, if available.
      */
-    getLaunchParams?(): unknown;
+    getLaunchParams?(): MiniAppLaunchParams | undefined;
     /**
      * Decodes platform specific start parameter.
      */
@@ -344,7 +348,7 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     setBackButtonVisibility(_visible: boolean): void;
     onAppearanceChange(callback: (appearance: 'dark' | 'light' | undefined) => void): () => void;
     getInitData(): string | undefined;
-    getLaunchParams(): unknown;
+    getLaunchParams(): MiniAppLaunchParams | undefined;
     decodeStartParam(_param: string): unknown;
     requestFullscreen(): void;
     onViewportChange(callback: (state: {
@@ -378,6 +382,7 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     protected notifyEnvironmentChanged(): void;
     protected onDestroy(): void;
     protected registerDisposable(disposable: Disposable): () => void;
+    protected readCustomUrlParams(isServiceParam?: (key: string) => boolean): Record<string, unknown>;
     private applyScrollGuards;
 }
 
@@ -389,7 +394,7 @@ declare class MaxMiniAppAdapter extends BaseMiniAppAdapter {
     init(_options?: MiniAppInitOptions): Promise<void>;
     supports(capability: MiniAppCapability): boolean;
     getInitData(): string | undefined;
-    getLaunchParams(): unknown;
+    getLaunchParams(): MiniAppLaunchParams | undefined;
     onBackButton(callback: () => void): () => void;
     setBackButtonVisibility(visible: boolean): void;
     openExternalLink(url: string): Promise<void>;
@@ -443,7 +448,7 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     scanQRCode(options?: MiniAppQrScanOptions): Promise<string | null>;
     closeApp(): Promise<void>;
     getInitData(): string | undefined;
-    getLaunchParams(): unknown;
+    getLaunchParams(): MiniAppLaunchParams | undefined;
     decodeStartParam(param: string): unknown;
     requestFullscreen(): void;
     getViewportInsets(): MiniAppViewportInsets | undefined;
@@ -472,6 +477,8 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     private safeHeightFromSdk;
     private stableHeightFromSdk;
     private notifyViewHide;
+    private normalizeDecodedStartParam;
+    private parseQueryString;
     private notifyViewRestore;
     protected onDestroy(): void;
 }
@@ -497,7 +504,7 @@ declare class VKMiniAppAdapter extends BaseMiniAppAdapter {
         background?: string;
     }): Promise<void>;
     getEnvironment(): MiniAppEnvironmentInfo;
-    getLaunchParams(): unknown;
+    getLaunchParams(): MiniAppLaunchParams | undefined;
     openExternalLink(url: string): Promise<void>;
     supports(capability: MiniAppCapability): Promise<boolean>;
     requestPhone(): Promise<string | null>;
@@ -589,4 +596,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, 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, 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 };

package/dist/index.d.ts

@@ -60,6 +60,10 @@ interface MiniAppViewportState {
     height: number;
     stableHeight: number;
 }
+interface MiniAppLaunchParams {
+    launchParams?: unknown;
+    customLaunchParams: Record<string, unknown>;
+}
 interface MiniAppInitOptions {
     /**
      * Enables verbose logs for platforms that support it.
@@ -197,7 +201,7 @@ interface MiniAppAdapter {
     /**
      * Reads platform launch parameters, if available.
      */
-    getLaunchParams?(): unknown;
+    getLaunchParams?(): MiniAppLaunchParams | undefined;
     /**
      * Decodes platform specific start parameter.
      */
@@ -344,7 +348,7 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     setBackButtonVisibility(_visible: boolean): void;
     onAppearanceChange(callback: (appearance: 'dark' | 'light' | undefined) => void): () => void;
     getInitData(): string | undefined;
-    getLaunchParams(): unknown;
+    getLaunchParams(): MiniAppLaunchParams | undefined;
     decodeStartParam(_param: string): unknown;
     requestFullscreen(): void;
     onViewportChange(callback: (state: {
@@ -378,6 +382,7 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     protected notifyEnvironmentChanged(): void;
     protected onDestroy(): void;
     protected registerDisposable(disposable: Disposable): () => void;
+    protected readCustomUrlParams(isServiceParam?: (key: string) => boolean): Record<string, unknown>;
     private applyScrollGuards;
 }
 
@@ -389,7 +394,7 @@ declare class MaxMiniAppAdapter extends BaseMiniAppAdapter {
     init(_options?: MiniAppInitOptions): Promise<void>;
     supports(capability: MiniAppCapability): boolean;
     getInitData(): string | undefined;
-    getLaunchParams(): unknown;
+    getLaunchParams(): MiniAppLaunchParams | undefined;
     onBackButton(callback: () => void): () => void;
     setBackButtonVisibility(visible: boolean): void;
     openExternalLink(url: string): Promise<void>;
@@ -443,7 +448,7 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     scanQRCode(options?: MiniAppQrScanOptions): Promise<string | null>;
     closeApp(): Promise<void>;
     getInitData(): string | undefined;
-    getLaunchParams(): unknown;
+    getLaunchParams(): MiniAppLaunchParams | undefined;
     decodeStartParam(param: string): unknown;
     requestFullscreen(): void;
     getViewportInsets(): MiniAppViewportInsets | undefined;
@@ -472,6 +477,8 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     private safeHeightFromSdk;
     private stableHeightFromSdk;
     private notifyViewHide;
+    private normalizeDecodedStartParam;
+    private parseQueryString;
     private notifyViewRestore;
     protected onDestroy(): void;
 }
@@ -497,7 +504,7 @@ declare class VKMiniAppAdapter extends BaseMiniAppAdapter {
         background?: string;
     }): Promise<void>;
     getEnvironment(): MiniAppEnvironmentInfo;
-    getLaunchParams(): unknown;
+    getLaunchParams(): MiniAppLaunchParams | undefined;
     openExternalLink(url: string): Promise<void>;
     supports(capability: MiniAppCapability): Promise<boolean>;
     requestPhone(): Promise<string | null>;
@@ -589,4 +596,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, 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, 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 };

package/dist/index.js

@@ -606,7 +606,9 @@ var BaseMiniAppAdapter = class {
     return void 0;
   }
   getLaunchParams() {
-    return void 0;
+    return {
+      customLaunchParams: this.readCustomUrlParams()
+    };
   }
   decodeStartParam(_param) {
     return void 0;
@@ -747,6 +749,34 @@ var BaseMiniAppAdapter = class {
   registerDisposable(disposable) {
     return this.disposables.add(disposable);
   }
+  readCustomUrlParams(isServiceParam) {
+    if (typeof window === "undefined") {
+      return {};
+    }
+    const result = {};
+    const append = (source) => {
+      const keys = /* @__PURE__ */ new Set();
+      for (const [key] of source.entries()) {
+        keys.add(key);
+      }
+      for (const key of keys) {
+        if (isServiceParam?.(key)) {
+          continue;
+        }
+        const values = source.getAll(key);
+        if (!values.length) {
+          continue;
+        }
+        result[key] = values.length === 1 ? values[0] : values;
+      }
+    };
+    append(new URLSearchParams(window.location.search));
+    const hash = window.location.hash.startsWith("#") ? window.location.hash.slice(1) : window.location.hash;
+    if (hash && hash.includes("=")) {
+      append(new URLSearchParams(hash));
+    }
+    return result;
+  }
   applyScrollGuards() {
     if (typeof document === "undefined") {
       return void 0;
@@ -831,7 +861,10 @@ var MaxMiniAppAdapter = class extends BaseMiniAppAdapter {
     return this.initData;
   }
   getLaunchParams() {
-    return this.initDataUnsafe ?? void 0;
+    return {
+      launchParams: this.initDataUnsafe,
+      customLaunchParams: this.readCustomUrlParams()
+    };
   }
   onBackButton(callback) {
     const bridge2 = getMaxBridge();
@@ -1416,10 +1449,28 @@ var TelegramMiniAppAdapter = class extends BaseMiniAppAdapter {
     }
   }
   getLaunchParams() {
+    const customFromUrl = this.readCustomUrlParams((key) => key.toLowerCase().startsWith("tgwebapp"));
+    let customFromStartParam = {};
     try {
-      return retrieveLaunchParams();
+      const launchParams = retrieveLaunchParams();
+      const startParam = launchParams.tgWebAppStartParam;
+      if (typeof startParam === "string" && startParam) {
+        customFromStartParam = this.normalizeDecodedStartParam(startParam);
+      }
+      return {
+        launchParams,
+        customLaunchParams: {
+          ...customFromUrl,
+          ...customFromStartParam
+        }
+      };
     } catch {
-      return void 0;
+      return {
+        customLaunchParams: {
+          ...customFromUrl,
+          ...customFromStartParam
+        }
+      };
     }
   }
   decodeStartParam(param) {
@@ -1768,6 +1819,42 @@ var TelegramMiniAppAdapter = class extends BaseMiniAppAdapter {
       }
     }
   }
+  normalizeDecodedStartParam(startParam) {
+    let decoded;
+    try {
+      decoded = decodeStartParam(startParam);
+    } catch {
+      decoded = startParam;
+    }
+    if (decoded && typeof decoded === "object" && !Array.isArray(decoded)) {
+      return { ...decoded };
+    }
+    if (typeof decoded === "string" && decoded) {
+      const parsed = this.parseQueryString(decoded);
+      if (Object.keys(parsed).length) {
+        return parsed;
+      }
+      return { startParam: decoded };
+    }
+    return {};
+  }
+  parseQueryString(value) {
+    const normalized = value.startsWith("?") ? value.slice(1) : value;
+    const params = new URLSearchParams(normalized);
+    const result = {};
+    const keys = /* @__PURE__ */ new Set();
+    for (const [key] of params.entries()) {
+      keys.add(key);
+    }
+    for (const key of keys) {
+      const values = params.getAll(key);
+      if (!values.length) {
+        continue;
+      }
+      result[key] = values.length === 1 ? values[0] : values;
+    }
+    return result;
+  }
   notifyViewRestore() {
     for (const listener of this.viewRestoreListeners) {
       try {
@@ -1933,11 +2020,22 @@ var VKMiniAppAdapter = class extends BaseMiniAppAdapter {
   }
   getLaunchParams() {
     if (!this.launchParams) {
-      return void 0;
+      return {
+        customLaunchParams: this.readCustomUrlParams((key) => {
+          const normalized = key.toLowerCase();
+          return normalized.startsWith("vk_") || normalized === "sign";
+        })
+      };
     }
     return {
-      launchParams: this.launchParams,
-      queryParams: this.queryParams
+      launchParams: {
+        bridge: this.launchParams,
+        query: this.queryParams
+      },
+      customLaunchParams: this.readCustomUrlParams((key) => {
+        const normalized = key.toLowerCase();
+        return normalized.startsWith("vk_") || normalized === "sign";
+      })
     };
   }
   async openExternalLink(url) {