@iamgame/wallet-sdk 0.1.3 → 0.1.4

package/dist/index.cjs

@@ -249,6 +249,9 @@ function getTelegram() {
   if (typeof window === "undefined") return void 0;
   return window.Telegram;
 }
+function getTelegramWebApp() {
+  return getTelegram()?.WebApp ?? null;
+}
 function getTelegramInitData() {
   const data = getTelegram()?.WebApp?.initData;
   if (!data || typeof data !== "string" || data.length === 0) return null;
@@ -472,6 +475,13 @@ function useSolvenTransferIn() {
   const wallet = useSolvenWallet();
   return { destinationAddress: wallet?.address ?? null };
 }
+function useIsTelegram() {
+  const [inTelegram, setInTelegram] = react.useState(false);
+  react.useEffect(() => {
+    setInTelegram(isTelegramMiniApp());
+  }, []);
+  return inTelegram;
+}
 
 // ../../solven/sdk-client/src/wallet-adapter.ts
 function phantomAdapter() {
@@ -2186,6 +2196,31 @@ async function buildSplTransferIn(deps, opts) {
     tx.serialize({ requireAllSignatures: false, verifySignatures: false })
   ).toString("base64");
 }
+var detectors = [
+  { platform: "telegram", detect: () => isTelegramMiniApp() }
+  // Future hosts drop in here (or via registerPlatform), e.g.:
+  // { platform: "mewe", detect: () => typeof window !== "undefined" && !!(window as { MeWe?: unknown }).MeWe },
+];
+function registerPlatform(detector) {
+  detectors.unshift(detector);
+}
+function detectPlatform() {
+  if (typeof window === "undefined") return "web";
+  for (const d of detectors) {
+    try {
+      if (d.detect()) return d.platform;
+    } catch {
+    }
+  }
+  return "web";
+}
+function usePlatform() {
+  const [platform, setPlatform] = react.useState("web");
+  react.useEffect(() => {
+    setPlatform(detectPlatform());
+  }, []);
+  return platform;
+}
 
 // src/provider.tsx
 var IAMGameWalletProvider = SolvenProvider;
@@ -2202,14 +2237,19 @@ exports.WalletWithdraw = SolvenWithdraw;
 exports.backpackAdapter = backpackAdapter;
 exports.buildSolTransferIn = buildSolTransferIn;
 exports.buildSplTransferIn = buildSplTransferIn;
+exports.detectPlatform = detectPlatform;
 exports.getTelegramInitData = getTelegramInitData;
+exports.getTelegramWebApp = getTelegramWebApp;
 exports.inMemorySession = inMemorySession;
 exports.isTelegramMiniApp = isTelegramMiniApp;
 exports.listSupportedWallets = listSupportedWallets;
 exports.localStorageSession = localStorageSession;
 exports.notifyTelegramReady = notifyTelegramReady;
 exports.phantomAdapter = phantomAdapter;
+exports.registerPlatform = registerPlatform;
 exports.solflareAdapter = solflareAdapter;
+exports.useIsTelegram = useIsTelegram;
+exports.usePlatform = usePlatform;
 exports.useWallet = useSolvenWallet;
 exports.useWalletAuth = useSolvenAuth;
 exports.useWalletBalance = useSolvenBalance;

package/dist/index.d.cts

@@ -302,6 +302,13 @@ interface IUseIAMGameTransferIn {
     destinationAddress: string | null;
 }
 declare function useIAMGameTransferIn(): IUseIAMGameTransferIn;
+/**
+ * True when the app is running inside a Telegram Mini App. SSR-safe: returns false
+ * on the server and during the first client render, then the real value after mount —
+ * so it never causes a hydration mismatch. For imperative checks use isTelegramMiniApp();
+ * for the WebApp object (haptics etc.) use getTelegramWebApp().
+ */
+declare function useIsTelegram(): boolean;
 
 interface IAMGameLoginTheme {
     primary?: string;
@@ -497,13 +504,54 @@ declare function buildSolTransferIn(deps: TransferInDeps, opts: BuildSolTransfer
  */
 declare function buildSplTransferIn(deps: TransferInDeps, opts: BuildSplTransferOpts): Promise<string>;
 
+/** Minimal shape of the Telegram WebApp object — enough for detection + common UI
+ *  affordances (haptics, theme, buttons). It is the live Telegram object, so other
+ *  fields exist at runtime; cast if you need them. */
+interface TelegramWebApp {
+    initData?: string;
+    version?: string;
+    platform?: string;
+    colorScheme?: "light" | "dark";
+    ready?: () => void;
+    expand?: () => void;
+    close?: () => void;
+    HapticFeedback?: {
+        impactOccurred?: (style: "light" | "medium" | "heavy" | "rigid" | "soft") => void;
+        notificationOccurred?: (type: "error" | "success" | "warning") => void;
+        selectionChanged?: () => void;
+    };
+    [key: string]: unknown;
+}
+/** The live Telegram WebApp object when running inside Telegram, else null.
+ *  Use it for haptics etc.: getTelegramWebApp()?.HapticFeedback?.impactOccurred("medium"). */
+declare function getTelegramWebApp(): TelegramWebApp | null;
 declare function getTelegramInitData(): string | null;
 declare function isTelegramMiniApp(): boolean;
 declare function notifyTelegramReady(): void;
 
+/** Known hosts. Kept an open string so a new platform (e.g. "mewe") works before a
+ *  release — register a detector for it and it just flows through everywhere. */
+type Platform = "web" | "telegram" | "mewe" | (string & {});
+interface PlatformDetector {
+    platform: Platform;
+    /** True when the app is running inside this host. Runs only in the browser. */
+    detect: () => boolean;
+}
+/**
+ * Register a host detector the SDK doesn't know yet (checked before the built-ins).
+ * Call once at app start. This is the seam for launching on a new platform — no SDK
+ * release required.
+ */
+declare function registerPlatform(detector: PlatformDetector): void;
+/** The current host platform. "web" on the server and as the default. */
+declare function detectPlatform(): Platform;
+/** SSR-safe reactive platform: "web" on the server + first client render, then the
+ *  real value after mount — so it never causes a hydration mismatch. */
+declare function usePlatform(): Platform;
+
 interface IAMGameWalletProviderProps extends IAMGameClientOptions {
     children: React.ReactNode;
 }
 declare const IAMGameWalletProvider: React.FC<IAMGameWalletProviderProps>;
 
-export { type AuthMethod, type BuildSolTransferOpts, type BuildSplTransferOpts, type ComplianceModuleType, type ComplianceStatus, IAMGameClient as IAMGameWalletClient, type IAMGameClientOptions as IAMGameWalletClientOptions, IAMGameWalletProvider, type IAMGameWalletProviderProps, type IComplianceState, type IExportInitiateRequest, type IExportInitiateResponse, type IExportPreflightResponse, type IExternalWalletAdapter, type ISession, type ISessionStorage, type ISignActionRequest, type ISignActionResponse, type ISiwsChallenge, type ISiwsVerifyRequest, type ITelegramVerifyRequest, type ITokenBalance, type IUseIAMGameAuth as IUseWalletAuth, type IUseIAMGameExport as IUseWalletExport, type IUseIAMGameSign as IUseWalletSign, type IUseIAMGameTransferIn as IUseWalletTransferIn, type IUser, type IUserIdentity, type IWallet, type IWalletBalance, type IIAMGameErrorEnvelope as IWalletErrorEnvelope, type IWebhookEnvelope, type IWebhookSignatureHeader, type IWithdrawRequest, type IWithdrawResponse, type TransferInDeps, IAMGameAddress as WalletAddress, type IAMGameAddressProps as WalletAddressProps, type IAMGameAddressTheme as WalletAddressTheme, IAMGameBalance as WalletBalance, type IAMGameBalanceProps as WalletBalanceProps, type IAMGameBalanceTheme as WalletBalanceTheme, type WalletCustody, type WalletDescriptor, type IAMGameErrorCode as WalletErrorCode, IAMGameExport as WalletExport, type IAMGameExportProps as WalletExportProps, type IAMGameExportTheme as WalletExportTheme, type WalletId, IAMGameLogin as WalletLogin, IAMGameLoginModal as WalletLoginModal, type IAMGameLoginModalProps as WalletLoginModalProps, type IAMGameLoginProps as WalletLoginProps, type IAMGameLoginTheme as WalletLoginTheme, IAMGameSdkError as WalletSdkError, type WalletStatus, IAMGameWithdraw as WalletWithdraw, type IAMGameWithdrawProps as WalletWithdrawProps, type IAMGameWithdrawTheme as WalletWithdrawTheme, type WebhookEventType, backpackAdapter, buildSolTransferIn, buildSplTransferIn, getTelegramInitData, inMemorySession, isTelegramMiniApp, listSupportedWallets, localStorageSession, notifyTelegramReady, phantomAdapter, solflareAdapter, useIAMGameWallet as useWallet, useIAMGameAuth as useWalletAuth, useIAMGameBalance as useWalletBalance, useIAMGameExport as useWalletExport, useIAMGameSign as useWalletSign, useIAMGameTransferIn as useWalletTransferIn };
+export { type AuthMethod, type BuildSolTransferOpts, type BuildSplTransferOpts, type ComplianceModuleType, type ComplianceStatus, IAMGameClient as IAMGameWalletClient, type IAMGameClientOptions as IAMGameWalletClientOptions, IAMGameWalletProvider, type IAMGameWalletProviderProps, type IComplianceState, type IExportInitiateRequest, type IExportInitiateResponse, type IExportPreflightResponse, type IExternalWalletAdapter, type ISession, type ISessionStorage, type ISignActionRequest, type ISignActionResponse, type ISiwsChallenge, type ISiwsVerifyRequest, type ITelegramVerifyRequest, type ITokenBalance, type IUseIAMGameAuth as IUseWalletAuth, type IUseIAMGameExport as IUseWalletExport, type IUseIAMGameSign as IUseWalletSign, type IUseIAMGameTransferIn as IUseWalletTransferIn, type IUser, type IUserIdentity, type IWallet, type IWalletBalance, type IIAMGameErrorEnvelope as IWalletErrorEnvelope, type IWebhookEnvelope, type IWebhookSignatureHeader, type IWithdrawRequest, type IWithdrawResponse, type Platform, type PlatformDetector, type TelegramWebApp, type TransferInDeps, IAMGameAddress as WalletAddress, type IAMGameAddressProps as WalletAddressProps, type IAMGameAddressTheme as WalletAddressTheme, IAMGameBalance as WalletBalance, type IAMGameBalanceProps as WalletBalanceProps, type IAMGameBalanceTheme as WalletBalanceTheme, type WalletCustody, type WalletDescriptor, type IAMGameErrorCode as WalletErrorCode, IAMGameExport as WalletExport, type IAMGameExportProps as WalletExportProps, type IAMGameExportTheme as WalletExportTheme, type WalletId, IAMGameLogin as WalletLogin, IAMGameLoginModal as WalletLoginModal, type IAMGameLoginModalProps as WalletLoginModalProps, type IAMGameLoginProps as WalletLoginProps, type IAMGameLoginTheme as WalletLoginTheme, IAMGameSdkError as WalletSdkError, type WalletStatus, IAMGameWithdraw as WalletWithdraw, type IAMGameWithdrawProps as WalletWithdrawProps, type IAMGameWithdrawTheme as WalletWithdrawTheme, type WebhookEventType, backpackAdapter, buildSolTransferIn, buildSplTransferIn, detectPlatform, getTelegramInitData, getTelegramWebApp, inMemorySession, isTelegramMiniApp, listSupportedWallets, localStorageSession, notifyTelegramReady, phantomAdapter, registerPlatform, solflareAdapter, useIsTelegram, usePlatform, useIAMGameWallet as useWallet, useIAMGameAuth as useWalletAuth, useIAMGameBalance as useWalletBalance, useIAMGameExport as useWalletExport, useIAMGameSign as useWalletSign, useIAMGameTransferIn as useWalletTransferIn };

package/dist/index.d.ts

@@ -302,6 +302,13 @@ interface IUseIAMGameTransferIn {
     destinationAddress: string | null;
 }
 declare function useIAMGameTransferIn(): IUseIAMGameTransferIn;
+/**
+ * True when the app is running inside a Telegram Mini App. SSR-safe: returns false
+ * on the server and during the first client render, then the real value after mount —
+ * so it never causes a hydration mismatch. For imperative checks use isTelegramMiniApp();
+ * for the WebApp object (haptics etc.) use getTelegramWebApp().
+ */
+declare function useIsTelegram(): boolean;
 
 interface IAMGameLoginTheme {
     primary?: string;
@@ -497,13 +504,54 @@ declare function buildSolTransferIn(deps: TransferInDeps, opts: BuildSolTransfer
  */
 declare function buildSplTransferIn(deps: TransferInDeps, opts: BuildSplTransferOpts): Promise<string>;
 
+/** Minimal shape of the Telegram WebApp object — enough for detection + common UI
+ *  affordances (haptics, theme, buttons). It is the live Telegram object, so other
+ *  fields exist at runtime; cast if you need them. */
+interface TelegramWebApp {
+    initData?: string;
+    version?: string;
+    platform?: string;
+    colorScheme?: "light" | "dark";
+    ready?: () => void;
+    expand?: () => void;
+    close?: () => void;
+    HapticFeedback?: {
+        impactOccurred?: (style: "light" | "medium" | "heavy" | "rigid" | "soft") => void;
+        notificationOccurred?: (type: "error" | "success" | "warning") => void;
+        selectionChanged?: () => void;
+    };
+    [key: string]: unknown;
+}
+/** The live Telegram WebApp object when running inside Telegram, else null.
+ *  Use it for haptics etc.: getTelegramWebApp()?.HapticFeedback?.impactOccurred("medium"). */
+declare function getTelegramWebApp(): TelegramWebApp | null;
 declare function getTelegramInitData(): string | null;
 declare function isTelegramMiniApp(): boolean;
 declare function notifyTelegramReady(): void;
 
+/** Known hosts. Kept an open string so a new platform (e.g. "mewe") works before a
+ *  release — register a detector for it and it just flows through everywhere. */
+type Platform = "web" | "telegram" | "mewe" | (string & {});
+interface PlatformDetector {
+    platform: Platform;
+    /** True when the app is running inside this host. Runs only in the browser. */
+    detect: () => boolean;
+}
+/**
+ * Register a host detector the SDK doesn't know yet (checked before the built-ins).
+ * Call once at app start. This is the seam for launching on a new platform — no SDK
+ * release required.
+ */
+declare function registerPlatform(detector: PlatformDetector): void;
+/** The current host platform. "web" on the server and as the default. */
+declare function detectPlatform(): Platform;
+/** SSR-safe reactive platform: "web" on the server + first client render, then the
+ *  real value after mount — so it never causes a hydration mismatch. */
+declare function usePlatform(): Platform;
+
 interface IAMGameWalletProviderProps extends IAMGameClientOptions {
     children: React.ReactNode;
 }
 declare const IAMGameWalletProvider: React.FC<IAMGameWalletProviderProps>;
 
-export { type AuthMethod, type BuildSolTransferOpts, type BuildSplTransferOpts, type ComplianceModuleType, type ComplianceStatus, IAMGameClient as IAMGameWalletClient, type IAMGameClientOptions as IAMGameWalletClientOptions, IAMGameWalletProvider, type IAMGameWalletProviderProps, type IComplianceState, type IExportInitiateRequest, type IExportInitiateResponse, type IExportPreflightResponse, type IExternalWalletAdapter, type ISession, type ISessionStorage, type ISignActionRequest, type ISignActionResponse, type ISiwsChallenge, type ISiwsVerifyRequest, type ITelegramVerifyRequest, type ITokenBalance, type IUseIAMGameAuth as IUseWalletAuth, type IUseIAMGameExport as IUseWalletExport, type IUseIAMGameSign as IUseWalletSign, type IUseIAMGameTransferIn as IUseWalletTransferIn, type IUser, type IUserIdentity, type IWallet, type IWalletBalance, type IIAMGameErrorEnvelope as IWalletErrorEnvelope, type IWebhookEnvelope, type IWebhookSignatureHeader, type IWithdrawRequest, type IWithdrawResponse, type TransferInDeps, IAMGameAddress as WalletAddress, type IAMGameAddressProps as WalletAddressProps, type IAMGameAddressTheme as WalletAddressTheme, IAMGameBalance as WalletBalance, type IAMGameBalanceProps as WalletBalanceProps, type IAMGameBalanceTheme as WalletBalanceTheme, type WalletCustody, type WalletDescriptor, type IAMGameErrorCode as WalletErrorCode, IAMGameExport as WalletExport, type IAMGameExportProps as WalletExportProps, type IAMGameExportTheme as WalletExportTheme, type WalletId, IAMGameLogin as WalletLogin, IAMGameLoginModal as WalletLoginModal, type IAMGameLoginModalProps as WalletLoginModalProps, type IAMGameLoginProps as WalletLoginProps, type IAMGameLoginTheme as WalletLoginTheme, IAMGameSdkError as WalletSdkError, type WalletStatus, IAMGameWithdraw as WalletWithdraw, type IAMGameWithdrawProps as WalletWithdrawProps, type IAMGameWithdrawTheme as WalletWithdrawTheme, type WebhookEventType, backpackAdapter, buildSolTransferIn, buildSplTransferIn, getTelegramInitData, inMemorySession, isTelegramMiniApp, listSupportedWallets, localStorageSession, notifyTelegramReady, phantomAdapter, solflareAdapter, useIAMGameWallet as useWallet, useIAMGameAuth as useWalletAuth, useIAMGameBalance as useWalletBalance, useIAMGameExport as useWalletExport, useIAMGameSign as useWalletSign, useIAMGameTransferIn as useWalletTransferIn };
+export { type AuthMethod, type BuildSolTransferOpts, type BuildSplTransferOpts, type ComplianceModuleType, type ComplianceStatus, IAMGameClient as IAMGameWalletClient, type IAMGameClientOptions as IAMGameWalletClientOptions, IAMGameWalletProvider, type IAMGameWalletProviderProps, type IComplianceState, type IExportInitiateRequest, type IExportInitiateResponse, type IExportPreflightResponse, type IExternalWalletAdapter, type ISession, type ISessionStorage, type ISignActionRequest, type ISignActionResponse, type ISiwsChallenge, type ISiwsVerifyRequest, type ITelegramVerifyRequest, type ITokenBalance, type IUseIAMGameAuth as IUseWalletAuth, type IUseIAMGameExport as IUseWalletExport, type IUseIAMGameSign as IUseWalletSign, type IUseIAMGameTransferIn as IUseWalletTransferIn, type IUser, type IUserIdentity, type IWallet, type IWalletBalance, type IIAMGameErrorEnvelope as IWalletErrorEnvelope, type IWebhookEnvelope, type IWebhookSignatureHeader, type IWithdrawRequest, type IWithdrawResponse, type Platform, type PlatformDetector, type TelegramWebApp, type TransferInDeps, IAMGameAddress as WalletAddress, type IAMGameAddressProps as WalletAddressProps, type IAMGameAddressTheme as WalletAddressTheme, IAMGameBalance as WalletBalance, type IAMGameBalanceProps as WalletBalanceProps, type IAMGameBalanceTheme as WalletBalanceTheme, type WalletCustody, type WalletDescriptor, type IAMGameErrorCode as WalletErrorCode, IAMGameExport as WalletExport, type IAMGameExportProps as WalletExportProps, type IAMGameExportTheme as WalletExportTheme, type WalletId, IAMGameLogin as WalletLogin, IAMGameLoginModal as WalletLoginModal, type IAMGameLoginModalProps as WalletLoginModalProps, type IAMGameLoginProps as WalletLoginProps, type IAMGameLoginTheme as WalletLoginTheme, IAMGameSdkError as WalletSdkError, type WalletStatus, IAMGameWithdraw as WalletWithdraw, type IAMGameWithdrawProps as WalletWithdrawProps, type IAMGameWithdrawTheme as WalletWithdrawTheme, type WebhookEventType, backpackAdapter, buildSolTransferIn, buildSplTransferIn, detectPlatform, getTelegramInitData, getTelegramWebApp, inMemorySession, isTelegramMiniApp, listSupportedWallets, localStorageSession, notifyTelegramReady, phantomAdapter, registerPlatform, solflareAdapter, useIsTelegram, usePlatform, useIAMGameWallet as useWallet, useIAMGameAuth as useWalletAuth, useIAMGameBalance as useWalletBalance, useIAMGameExport as useWalletExport, useIAMGameSign as useWalletSign, useIAMGameTransferIn as useWalletTransferIn };

package/dist/index.js

@@ -247,6 +247,9 @@ function getTelegram() {
   if (typeof window === "undefined") return void 0;
   return window.Telegram;
 }
+function getTelegramWebApp() {
+  return getTelegram()?.WebApp ?? null;
+}
 function getTelegramInitData() {
   const data = getTelegram()?.WebApp?.initData;
   if (!data || typeof data !== "string" || data.length === 0) return null;
@@ -470,6 +473,13 @@ function useSolvenTransferIn() {
   const wallet = useSolvenWallet();
   return { destinationAddress: wallet?.address ?? null };
 }
+function useIsTelegram() {
+  const [inTelegram, setInTelegram] = useState(false);
+  useEffect(() => {
+    setInTelegram(isTelegramMiniApp());
+  }, []);
+  return inTelegram;
+}
 
 // ../../solven/sdk-client/src/wallet-adapter.ts
 function phantomAdapter() {
@@ -2184,8 +2194,33 @@ async function buildSplTransferIn(deps, opts) {
     tx.serialize({ requireAllSignatures: false, verifySignatures: false })
   ).toString("base64");
 }
+var detectors = [
+  { platform: "telegram", detect: () => isTelegramMiniApp() }
+  // Future hosts drop in here (or via registerPlatform), e.g.:
+  // { platform: "mewe", detect: () => typeof window !== "undefined" && !!(window as { MeWe?: unknown }).MeWe },
+];
+function registerPlatform(detector) {
+  detectors.unshift(detector);
+}
+function detectPlatform() {
+  if (typeof window === "undefined") return "web";
+  for (const d of detectors) {
+    try {
+      if (d.detect()) return d.platform;
+    } catch {
+    }
+  }
+  return "web";
+}
+function usePlatform() {
+  const [platform, setPlatform] = useState("web");
+  useEffect(() => {
+    setPlatform(detectPlatform());
+  }, []);
+  return platform;
+}
 
 // src/provider.tsx
 var IAMGameWalletProvider = SolvenProvider;
 
-export { SolvenClient as IAMGameWalletClient, IAMGameWalletProvider, SolvenAddress as WalletAddress, SolvenBalance as WalletBalance, SolvenExport as WalletExport, SolvenLogin as WalletLogin, SolvenLoginModal as WalletLoginModal, SolvenSdkError as WalletSdkError, SolvenWithdraw as WalletWithdraw, backpackAdapter, buildSolTransferIn, buildSplTransferIn, getTelegramInitData, inMemorySession, isTelegramMiniApp, listSupportedWallets, localStorageSession, notifyTelegramReady, phantomAdapter, solflareAdapter, useSolvenWallet as useWallet, useSolvenAuth as useWalletAuth, useSolvenBalance as useWalletBalance, useSolvenExport as useWalletExport, useSolvenSign as useWalletSign, useSolvenTransferIn as useWalletTransferIn };
+export { SolvenClient as IAMGameWalletClient, IAMGameWalletProvider, SolvenAddress as WalletAddress, SolvenBalance as WalletBalance, SolvenExport as WalletExport, SolvenLogin as WalletLogin, SolvenLoginModal as WalletLoginModal, SolvenSdkError as WalletSdkError, SolvenWithdraw as WalletWithdraw, backpackAdapter, buildSolTransferIn, buildSplTransferIn, detectPlatform, getTelegramInitData, getTelegramWebApp, inMemorySession, isTelegramMiniApp, listSupportedWallets, localStorageSession, notifyTelegramReady, phantomAdapter, registerPlatform, solflareAdapter, useIsTelegram, usePlatform, useSolvenWallet as useWallet, useSolvenAuth as useWalletAuth, useSolvenBalance as useWalletBalance, useSolvenExport as useWalletExport, useSolvenSign as useWalletSign, useSolvenTransferIn as useWalletTransferIn };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iamgame/wallet-sdk",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "IAMGame Wallet browser SDK — Telegram & Solana wallet auth, balances, server-side signing, and key export. Drop-in React provider for game frontends.",
   "license": "MIT",
   "homepage": "https://wallet.iamgame.com",