@wowlabtech/mini-app-adapter 0.2.7 → 0.2.8

package/dist/index.d.cts

@@ -60,6 +60,9 @@ interface MiniAppViewportState {
     height: number;
     stableHeight: number;
 }
+interface MiniAppCustomLaunchParams {
+    customLaunchParams: Record<string, unknown>;
+}
 interface MiniAppInitOptions {
     /**
      * Enables verbose logs for platforms that support it.
@@ -198,6 +201,10 @@ interface MiniAppAdapter {
      * Reads platform launch parameters, if available.
      */
     getLaunchParams?(): unknown;
+    /**
+     * Returns custom launch parameters that are not part of platform service fields.
+     */
+    getCustomLaunchParams(): MiniAppCustomLaunchParams;
     /**
      * Decodes platform specific start parameter.
      */
@@ -345,6 +352,7 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     onAppearanceChange(callback: (appearance: 'dark' | 'light' | undefined) => void): () => void;
     getInitData(): string | undefined;
     getLaunchParams(): unknown;
+    getCustomLaunchParams(): MiniAppCustomLaunchParams;
     decodeStartParam(_param: string): unknown;
     requestFullscreen(): void;
     onViewportChange(callback: (state: {
@@ -444,6 +452,7 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     closeApp(): Promise<void>;
     getInitData(): string | undefined;
     getLaunchParams(): unknown;
+    getCustomLaunchParams(): MiniAppCustomLaunchParams;
     decodeStartParam(param: string): unknown;
     requestFullscreen(): void;
     getViewportInsets(): MiniAppViewportInsets | undefined;
@@ -472,6 +481,9 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     private safeHeightFromSdk;
     private stableHeightFromSdk;
     private notifyViewHide;
+    private normalizeDecodedStartParam;
+    private readCustomUrlParams;
+    private parseQueryString;
     private notifyViewRestore;
     protected onDestroy(): void;
 }
@@ -498,7 +510,9 @@ declare class VKMiniAppAdapter extends BaseMiniAppAdapter {
     }): Promise<void>;
     getEnvironment(): MiniAppEnvironmentInfo;
     getLaunchParams(): unknown;
+    getCustomLaunchParams(): MiniAppCustomLaunchParams;
     openExternalLink(url: string): Promise<void>;
+    private readCustomUrlParams;
     supports(capability: MiniAppCapability): Promise<boolean>;
     requestPhone(): Promise<string | null>;
     requestNotificationsPermission(): Promise<boolean>;
@@ -589,4 +603,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 MiniAppCustomLaunchParams, 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 };

package/dist/index.d.ts

@@ -60,6 +60,9 @@ interface MiniAppViewportState {
     height: number;
     stableHeight: number;
 }
+interface MiniAppCustomLaunchParams {
+    customLaunchParams: Record<string, unknown>;
+}
 interface MiniAppInitOptions {
     /**
      * Enables verbose logs for platforms that support it.
@@ -198,6 +201,10 @@ interface MiniAppAdapter {
      * Reads platform launch parameters, if available.
      */
     getLaunchParams?(): unknown;
+    /**
+     * Returns custom launch parameters that are not part of platform service fields.
+     */
+    getCustomLaunchParams(): MiniAppCustomLaunchParams;
     /**
      * Decodes platform specific start parameter.
      */
@@ -345,6 +352,7 @@ declare abstract class BaseMiniAppAdapter implements MiniAppAdapter {
     onAppearanceChange(callback: (appearance: 'dark' | 'light' | undefined) => void): () => void;
     getInitData(): string | undefined;
     getLaunchParams(): unknown;
+    getCustomLaunchParams(): MiniAppCustomLaunchParams;
     decodeStartParam(_param: string): unknown;
     requestFullscreen(): void;
     onViewportChange(callback: (state: {
@@ -444,6 +452,7 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     closeApp(): Promise<void>;
     getInitData(): string | undefined;
     getLaunchParams(): unknown;
+    getCustomLaunchParams(): MiniAppCustomLaunchParams;
     decodeStartParam(param: string): unknown;
     requestFullscreen(): void;
     getViewportInsets(): MiniAppViewportInsets | undefined;
@@ -472,6 +481,9 @@ declare class TelegramMiniAppAdapter extends BaseMiniAppAdapter {
     private safeHeightFromSdk;
     private stableHeightFromSdk;
     private notifyViewHide;
+    private normalizeDecodedStartParam;
+    private readCustomUrlParams;
+    private parseQueryString;
     private notifyViewRestore;
     protected onDestroy(): void;
 }
@@ -498,7 +510,9 @@ declare class VKMiniAppAdapter extends BaseMiniAppAdapter {
     }): Promise<void>;
     getEnvironment(): MiniAppEnvironmentInfo;
     getLaunchParams(): unknown;
+    getCustomLaunchParams(): MiniAppCustomLaunchParams;
     openExternalLink(url: string): Promise<void>;
+    private readCustomUrlParams;
     supports(capability: MiniAppCapability): Promise<boolean>;
     requestPhone(): Promise<string | null>;
     requestNotificationsPermission(): Promise<boolean>;
@@ -589,4 +603,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 MiniAppCustomLaunchParams, 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 };

package/dist/index.js

@@ -608,6 +608,9 @@ var BaseMiniAppAdapter = class {
   getLaunchParams() {
     return void 0;
   }
+  getCustomLaunchParams() {
+    return { customLaunchParams: {} };
+  }
   decodeStartParam(_param) {
     return void 0;
   }
@@ -1422,6 +1425,24 @@ var TelegramMiniAppAdapter = class extends BaseMiniAppAdapter {
       return void 0;
     }
   }
+  getCustomLaunchParams() {
+    const customFromUrl = this.readCustomUrlParams((key) => key.toLowerCase().startsWith("tgwebapp"));
+    let customFromStartParam = {};
+    try {
+      const launchParams = retrieveLaunchParams();
+      const startParam = launchParams.tgWebAppStartParam;
+      if (typeof startParam === "string" && startParam) {
+        customFromStartParam = this.normalizeDecodedStartParam(startParam);
+      }
+    } catch {
+    }
+    return {
+      customLaunchParams: {
+        ...customFromUrl,
+        ...customFromStartParam
+      }
+    };
+  }
   decodeStartParam(param) {
     try {
       return decodeStartParam(param);
@@ -1768,6 +1789,70 @@ 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 {};
+  }
+  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;
+  }
+  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 {
@@ -1940,6 +2025,11 @@ var VKMiniAppAdapter = class extends BaseMiniAppAdapter {
       queryParams: this.queryParams
     };
   }
+  getCustomLaunchParams() {
+    return {
+      customLaunchParams: this.readCustomUrlParams()
+    };
+  }
   async openExternalLink(url) {
     const a = document.createElement("a");
     a.href = url;
@@ -1950,6 +2040,38 @@ var VKMiniAppAdapter = class extends BaseMiniAppAdapter {
     a.click();
     a.remove();
   }
+  readCustomUrlParams() {
+    if (typeof window === "undefined") {
+      return {};
+    }
+    const result = {};
+    const isServiceParam = (key) => {
+      const normalized = key.toLowerCase();
+      return normalized.startsWith("vk_") || normalized === "sign";
+    };
+    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;
+  }
   async supports(capability) {
     switch (capability) {
       case "haptics": {