hm-tracking-sdk 0.2.1 → 0.2.3

package/dist/sdk/telegram.d.ts

@@ -1,4 +1,5 @@
 import type { TelegramUserInfo } from "./types.js";
+export declare function getLaunchParams(): any;
 export declare function isTelegramEnv(): boolean;
 export declare function getTelegramUserUnsafe(): TelegramUserInfo | null;
 /**

package/dist/sdk/telegram.js

@@ -8,20 +8,65 @@ function retrieveLaunchParams() {
     }
     return WebApp.initData;
 }
+// 单独拆分一个函数用来获取数据，不要让它影响环境判断
+export function getLaunchParams() {
+    const tg = window.Telegram.WebApp;
+    if (!tg.initData) {
+        // 这里可以结合上一个问题的解决方案，尝试从 sessionStorage 读取
+        const cached = sessionStorage.getItem('tg_init_data');
+        if (cached)
+            return cached;
+        console.warn("当前在 Telegram 环境，但没有 initData (可能是页面刷新导致的)");
+        return "";
+    }
+    return tg.initData;
+}
 export function isTelegramEnv() {
     try {
-        // 检查 WebApp 对象是否存在且 initData 可用
-        if (typeof window !== "undefined" &&
-            window.Telegram &&
-            window.Telegram.WebApp) {
-            // 如果能够提取启动参数，说明已经在 Telegram 环境中
-            retrieveLaunchParams();
-            return true;
+        // 1. 基础对象检查
+        if (typeof window === "undefined" ||
+            !window.Telegram ||
+            !window.Telegram.WebApp) {
+            return false;
         }
-        return false;
+        const tg = window.Telegram.WebApp;
+        // 2. 检查 initDataUnsafe - 这是 Telegram 环境最可靠的标识
+        // initDataUnsafe 是 Telegram 特有的对象，包含用户信息和认证数据
+        // 如果 initDataUnsafe 存在且是对象，基本可以确定在 Telegram 环境中
+        if (!tg.initDataUnsafe || typeof tg.initDataUnsafe !== "object") {
+            return false;
+        }
+        // 3. 严格验证：必须同时满足以下条件才认为是真实的 Telegram 环境
+        // - initDataUnsafe.user 必须存在且是对象，且必须有有效的 id
+        // - 或者 initData 必须存在且是有效的字符串（非空）
+        const hasValidUser = tg.initDataUnsafe.user &&
+            typeof tg.initDataUnsafe.user === "object" &&
+            typeof tg.initDataUnsafe.user.id === "number" &&
+            tg.initDataUnsafe.user.id > 0;
+        const hasValidInitData = 'initData' in tg &&
+            typeof tg.initData === "string" &&
+            tg.initData.length > 0;
+        // 必须至少有一个有效标识
+        if (!hasValidUser && !hasValidInitData) {
+            return false;
+        }
+        // 4. 如果 platform 存在且是明显无效的值，可能是手动注入的对象
+        const platform = tg.platform;
+        if (platform !== undefined && platform !== null && typeof platform === "string") {
+            const invalidPlatforms = ['fake', 'mock', 'test'];
+            if (invalidPlatforms.includes(platform.toLowerCase())) {
+                return false;
+            }
+        }
+        // 5. 额外检查：如果 initDataUnsafe 是空对象且没有其他有效标识，可能是 mock 对象
+        const initDataUnsafeKeys = Object.keys(tg.initDataUnsafe || {});
+        if (initDataUnsafeKeys.length === 0 && !hasValidInitData) {
+            return false;
+        }
+        return true;
     }
     catch (error) {
-        console.warn("非Telegram环境");
+        console.warn("环境检测异常", error);
         return false;
     }
 }

package/dist/sdk/telegram.js.map

@@ -1 +1 @@
-{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../src/sdk/telegram.ts"],"names":[],"mappings":"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","sourcesContent":["import WebApp from \"@twa-dev/sdk\";\r\nimport type { TelegramUserInfo } from \"./types.js\";\r\n\r\n/**\r\n * 尝试获取启动参数，检查是否在 Telegram 环境中\r\n */\r\nfunction retrieveLaunchParams() {\r\n  if (!WebApp.initData || WebApp.initData === \"\") {\r\n    throw new Error(\"未能提取启动参数，不在 Telegram 环境中\");\r\n  }\r\n  return WebApp.initData;\r\n}\r\n\r\nexport function isTelegramEnv(): boolean {\r\n  try {\r\n    // 检查 WebApp 对象是否存在且 initData 可用\r\n    if (\r\n      typeof window !== \"undefined\" &&\r\n      (window as any).Telegram &&\r\n      (window as any).Telegram.WebApp\r\n    ) {\r\n      // 如果能够提取启动参数，说明已经在 Telegram 环境中\r\n      retrieveLaunchParams();\r\n      return true;\r\n    }\r\n    return false;\r\n  } catch (error) {\r\n    console.warn(\"非Telegram环境\");\r\n    return false;\r\n  }\r\n}\r\n\r\nexport function getTelegramUserUnsafe(): TelegramUserInfo | null {\r\n  try {\r\n    // 确保 WebApp 对象存在\r\n    if (!WebApp || !WebApp.initDataUnsafe) {\r\n      return null;\r\n    }\r\n\r\n    const initDataUnsafe = WebApp.initDataUnsafe;\r\n\r\n    // 验证用户信息的基本结构\r\n    if (!initDataUnsafe.user || !initDataUnsafe.user.id) {\r\n      console.warn(\"Telegram用户信息结构不完整\");\r\n      return null;\r\n    }\r\n\r\n    // 确保包含必要字段\r\n    const userInfo = {\r\n      user: {\r\n        id: initDataUnsafe.user.id,\r\n        firstName: initDataUnsafe.user.first_name || \"\",\r\n        lastName: initDataUnsafe.user.last_name || \"\",\r\n        username: initDataUnsafe.user.username,\r\n        photoUrl: initDataUnsafe.user.photo_url || \"\",\r\n        languageCode: initDataUnsafe.user.language_code,\r\n        isPremium: initDataUnsafe.user.is_premium || false,\r\n        allowsWriteToPm: initDataUnsafe.user.allows_write_to_pm || false,\r\n      },\r\n      authDate: new Date().toISOString(),\r\n      hash: initDataUnsafe.hash || \"\",\r\n      startParam: initDataUnsafe.start_param,\r\n      chatType: initDataUnsafe.chat_type,\r\n      chatInstance: initDataUnsafe.chat_instance,\r\n    };\r\n\r\n    return userInfo as TelegramUserInfo;\r\n  } catch (error) {\r\n    console.warn(\"获取Telegram用户信息失败:\", error);\r\n    return null;\r\n  }\r\n}\r\n\r\n/** Cookie 工具 **/\r\nfunction readCookie(name: string): string | null {\r\n  if (typeof document === \"undefined\") return null;\r\n  const match = document.cookie.match(\r\n    new RegExp(\r\n      \"(?:^|; )\" + name.replace(/([.$?*|{}()\\[\\]\\\\/+^])/g, \"\\\\$1\") + \"=([^;]*)\"\r\n    )\r\n  );\r\n  return match ? decodeURIComponent(match[1]) : null;\r\n}\r\n\r\nfunction writeCookie(name: string, value: string, days = 365 * 2) {\r\n  if (typeof document === \"undefined\") return;\r\n  const date = new Date();\r\n  date.setTime(date.getTime() + days * 24 * 60 * 60 * 1000);\r\n  const expires = \"; expires=\" + date.toUTCString();\r\n  document.cookie = `${encodeURIComponent(name)}=${encodeURIComponent(\r\n    value\r\n  )}${expires}; path=/`;\r\n}\r\n\r\nfunction generateNumericId(): number {\r\n  // 生成稳定的数值 ID（53-bit 安全整数范围内）\r\n  const rand = Math.floor(Math.random() * 1e9);\r\n  const time = Date.now() % 1e9;\r\n  const id = Number(\r\n    String(time).padStart(9, \"0\") + String(rand).padStart(9, \"0\")\r\n  );\r\n  return id;\r\n}\r\n\r\n/**\r\n * 基于 Cookie 的匿名浏览器用户（非 Telegram 环境使用）\r\n * - 会在 cookie 中持久化 uid，下次复用\r\n */\r\nexport function getAnonymousBrowserUser(\r\n  cookieName = \"tg_tracking_uid\"\r\n): TelegramUserInfo {\r\n  let uidStr = readCookie(cookieName);\r\n  if (!uidStr) {\r\n    const uid = generateNumericId();\r\n    uidStr = String(uid);\r\n    writeCookie(cookieName, uidStr);\r\n  }\r\n  const uidNum =\r\n    Number(uidStr.replace(/\\D/g, \"\").slice(0, 15)) || generateNumericId();\r\n  const lang =\r\n    (typeof navigator !== \"undefined\" &&\r\n      (navigator.language || (navigator as any).userLanguage)) ||\r\n    \"en\";\r\n\r\n  return {\r\n    user: {\r\n      id: uidNum,\r\n      firstName: \"Guest\",\r\n      lastName: \"\",\r\n      username: `guest_${uidStr.slice(-6)}`,\r\n      languageCode: lang.toLowerCase(),\r\n      isPremium: false,\r\n      allowsWriteToPm: false,\r\n    },\r\n    authDate: new Date().toISOString(),\r\n    hash: \"anonymous_cookie_user\",\r\n    startParam: \"browser_guest\",\r\n    chatType: \"sender\",\r\n    chatInstance: \"\",\r\n  } as TelegramUserInfo;\r\n}\r\n\r\n/**\r\n * 获取默认的 mock 用户信息（保留旧逻辑）\r\n */\r\nexport function getDefaultMockUser(): TelegramUserInfo {\r\n  return {\r\n    user: {\r\n      id: 2077220643,\r\n      firstName: \"Mock\",\r\n      lastName: \"User\",\r\n      username: \"mock_user_demo\",\r\n      languageCode: \"zh-hans\",\r\n      isPremium: true,\r\n      allowsWriteToPm: true,\r\n    },\r\n    authDate: new Date().toISOString(),\r\n    hash: \"mock_hash_for_demo_purpose\",\r\n    startParam: \"demo_start_param\",\r\n    chatType: \"sender\",\r\n    chatInstance: \"-245769840322609948\",\r\n  } as TelegramUserInfo;\r\n}\r\n"]}
+{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../src/sdk/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,cAAc,CAAC;AAGlC;;GAEG;AACH,SAAS,oBAAoB;IAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,CAAC;AACzB,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,eAAe;IAC7B,MAAM,EAAE,GAAI,MAAc,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC3C,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;QACf,yCAAyC;QACzC,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACtD,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,OAAO,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC1D,OAAO,EAAE,CAAC;IACd,CAAC;IACD,OAAO,EAAE,CAAC,QAAQ,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC;QACH,YAAY;QACZ,IACE,OAAO,MAAM,KAAK,WAAW;YAC7B,CAAE,MAAc,CAAC,QAAQ;YACzB,CAAE,MAAc,CAAC,QAAQ,CAAC,MAAM,EAChC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,EAAE,GAAI,MAAc,CAAC,QAAQ,CAAC,MAAM,CAAC;QAE3C,8CAA8C;QAC9C,8CAA8C;QAC9C,gDAAgD;QAChD,IAAI,CAAC,EAAE,CAAC,cAAc,IAAI,OAAO,EAAE,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;YAChE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,wCAAwC;QACxC,4CAA4C;QAC5C,iCAAiC;QACjC,MAAM,YAAY,GAChB,EAAE,CAAC,cAAc,CAAC,IAAI;YACtB,OAAO,EAAE,CAAC,cAAc,CAAC,IAAI,KAAK,QAAQ;YAC1C,OAAO,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,KAAK,QAAQ;YAC7C,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QAEhC,MAAM,gBAAgB,GACpB,UAAU,IAAI,EAAE;YAChB,OAAO,EAAE,CAAC,QAAQ,KAAK,QAAQ;YAC/B,EAAE,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAEzB,cAAc;QACd,IAAI,CAAC,YAAY,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACvC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,uCAAuC;QACvC,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC;QAC7B,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAChF,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAClD,IAAI,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBACtD,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,sDAAsD;QACtD,MAAM,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;QAChE,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACzD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC;QACH,iBAAiB;QACjB,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;QAE7C,cAAc;QACd,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,WAAW;QACX,MAAM,QAAQ,GAAG;YACf,IAAI,EAAE;gBACJ,EAAE,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE;gBAC1B,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE;gBAC/C,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE;gBAC7C,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,QAAQ;gBACtC,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE;gBAC7C,YAAY,EAAE,cAAc,CAAC,IAAI,CAAC,aAAa;gBAC/C,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,UAAU,IAAI,KAAK;gBAClD,eAAe,EAAE,cAAc,CAAC,IAAI,CAAC,kBAAkB,IAAI,KAAK;aACjE;YACD,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAClC,IAAI,EAAE,cAAc,CAAC,IAAI,IAAI,EAAE;YAC/B,UAAU,EAAE,cAAc,CAAC,WAAW;YACtC,QAAQ,EAAE,cAAc,CAAC,SAAS;YAClC,YAAY,EAAE,cAAc,CAAC,aAAa;SAC3C,CAAC;QAEF,OAAO,QAA4B,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,iBAAiB;AACjB,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CACjC,IAAI,MAAM,CACR,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,MAAM,CAAC,GAAG,UAAU,CAC1E,CACF,CAAC;IACF,OAAO,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa,EAAE,IAAI,GAAG,GAAG,GAAG,CAAC;IAC9D,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO;IAC5C,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,kBAAkB,CACjE,KAAK,CACN,GAAG,OAAO,UAAU,CAAC;AACxB,CAAC;AAED,SAAS,iBAAiB;IACxB,6BAA6B;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC;IAC9B,MAAM,EAAE,GAAG,MAAM,CACf,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAC9D,CAAC;IACF,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAAU,GAAG,iBAAiB;IAE9B,IAAI,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,iBAAiB,EAAE,CAAC;QAChC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,MAAM,GACV,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,iBAAiB,EAAE,CAAC;IACxE,MAAM,IAAI,GACR,CAAC,OAAO,SAAS,KAAK,WAAW;QAC/B,CAAC,SAAS,CAAC,QAAQ,IAAK,SAAiB,CAAC,YAAY,CAAC,CAAC;QAC1D,IAAI,CAAC;IAEP,OAAO;QACL,IAAI,EAAE;YACJ,EAAE,EAAE,MAAM;YACV,SAAS,EAAE,OAAO;YAClB,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,SAAS,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;YACrC,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE;YAChC,SAAS,EAAE,KAAK;YAChB,eAAe,EAAE,KAAK;SACvB;QACD,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAClC,IAAI,EAAE,uBAAuB;QAC7B,UAAU,EAAE,eAAe;QAC3B,QAAQ,EAAE,QAAQ;QAClB,YAAY,EAAE,EAAE;KACG,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE;YACJ,EAAE,EAAE,UAAU;YACd,SAAS,EAAE,MAAM;YACjB,QAAQ,EAAE,MAAM;YAChB,QAAQ,EAAE,gBAAgB;YAC1B,YAAY,EAAE,SAAS;YACvB,SAAS,EAAE,IAAI;YACf,eAAe,EAAE,IAAI;SACtB;QACD,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAClC,IAAI,EAAE,4BAA4B;QAClC,UAAU,EAAE,kBAAkB;QAC9B,QAAQ,EAAE,QAAQ;QAClB,YAAY,EAAE,qBAAqB;KAChB,CAAC;AACxB,CAAC","sourcesContent":["import WebApp from \"@twa-dev/sdk\";\r\nimport type { TelegramUserInfo } from \"./types.js\";\r\n\r\n/**\r\n * 尝试获取启动参数，检查是否在 Telegram 环境中\r\n */\r\nfunction retrieveLaunchParams() {\r\n  if (!WebApp.initData || WebApp.initData === \"\") {\r\n    throw new Error(\"未能提取启动参数，不在 Telegram 环境中\");\r\n  }\r\n  return WebApp.initData;\r\n}\r\n\r\n// 单独拆分一个函数用来获取数据，不要让它影响环境判断\r\nexport function getLaunchParams() {\r\n  const tg = (window as any).Telegram.WebApp;\r\n  if (!tg.initData) {\r\n      // 这里可以结合上一个问题的解决方案，尝试从 sessionStorage 读取\r\n      const cached = sessionStorage.getItem('tg_init_data');\r\n      if (cached) return cached;\r\n      \r\n      console.warn(\"当前在 Telegram 环境，但没有 initData (可能是页面刷新导致的)\");\r\n      return \"\";\r\n  }\r\n  return tg.initData;\r\n}\r\n\r\nexport function isTelegramEnv(): boolean {\r\n  try {\r\n    // 1. 基础对象检查\r\n    if (\r\n      typeof window === \"undefined\" ||\r\n      !(window as any).Telegram ||\r\n      !(window as any).Telegram.WebApp\r\n    ) {\r\n      return false;\r\n    }\r\n\r\n    const tg = (window as any).Telegram.WebApp;\r\n    \r\n    // 2. 检查 initDataUnsafe - 这是 Telegram 环境最可靠的标识\r\n    // initDataUnsafe 是 Telegram 特有的对象，包含用户信息和认证数据\r\n    // 如果 initDataUnsafe 存在且是对象，基本可以确定在 Telegram 环境中\r\n    if (!tg.initDataUnsafe || typeof tg.initDataUnsafe !== \"object\") {\r\n      return false;\r\n    }\r\n\r\n    // 3. 严格验证：必须同时满足以下条件才认为是真实的 Telegram 环境\r\n    // - initDataUnsafe.user 必须存在且是对象，且必须有有效的 id\r\n    // - 或者 initData 必须存在且是有效的字符串（非空）\r\n    const hasValidUser = \r\n      tg.initDataUnsafe.user && \r\n      typeof tg.initDataUnsafe.user === \"object\" &&\r\n      typeof tg.initDataUnsafe.user.id === \"number\" &&\r\n      tg.initDataUnsafe.user.id > 0;\r\n    \r\n    const hasValidInitData = \r\n      'initData' in tg && \r\n      typeof tg.initData === \"string\" && \r\n      tg.initData.length > 0;\r\n    \r\n    // 必须至少有一个有效标识\r\n    if (!hasValidUser && !hasValidInitData) {\r\n      return false;\r\n    }\r\n\r\n    // 4. 如果 platform 存在且是明显无效的值，可能是手动注入的对象\r\n    const platform = tg.platform;\r\n    if (platform !== undefined && platform !== null && typeof platform === \"string\") {\r\n      const invalidPlatforms = ['fake', 'mock', 'test'];\r\n      if (invalidPlatforms.includes(platform.toLowerCase())) {\r\n        return false;\r\n      }\r\n    }\r\n\r\n    // 5. 额外检查：如果 initDataUnsafe 是空对象且没有其他有效标识，可能是 mock 对象\r\n    const initDataUnsafeKeys = Object.keys(tg.initDataUnsafe || {});\r\n    if (initDataUnsafeKeys.length === 0 && !hasValidInitData) {\r\n      return false;\r\n    }\r\n\r\n    return true;\r\n  } catch (error) {\r\n    console.warn(\"环境检测异常\", error);\r\n    return false;\r\n  }\r\n}\r\n\r\nexport function getTelegramUserUnsafe(): TelegramUserInfo | null {\r\n  try {\r\n    // 确保 WebApp 对象存在\r\n    if (!WebApp || !WebApp.initDataUnsafe) {\r\n      return null;\r\n    }\r\n\r\n    const initDataUnsafe = WebApp.initDataUnsafe;\r\n\r\n    // 验证用户信息的基本结构\r\n    if (!initDataUnsafe.user || !initDataUnsafe.user.id) {\r\n      console.warn(\"Telegram用户信息结构不完整\");\r\n      return null;\r\n    }\r\n\r\n    // 确保包含必要字段\r\n    const userInfo = {\r\n      user: {\r\n        id: initDataUnsafe.user.id,\r\n        firstName: initDataUnsafe.user.first_name || \"\",\r\n        lastName: initDataUnsafe.user.last_name || \"\",\r\n        username: initDataUnsafe.user.username,\r\n        photoUrl: initDataUnsafe.user.photo_url || \"\",\r\n        languageCode: initDataUnsafe.user.language_code,\r\n        isPremium: initDataUnsafe.user.is_premium || false,\r\n        allowsWriteToPm: initDataUnsafe.user.allows_write_to_pm || false,\r\n      },\r\n      authDate: new Date().toISOString(),\r\n      hash: initDataUnsafe.hash || \"\",\r\n      startParam: initDataUnsafe.start_param,\r\n      chatType: initDataUnsafe.chat_type,\r\n      chatInstance: initDataUnsafe.chat_instance,\r\n    };\r\n\r\n    return userInfo as TelegramUserInfo;\r\n  } catch (error) {\r\n    console.warn(\"获取Telegram用户信息失败:\", error);\r\n    return null;\r\n  }\r\n}\r\n\r\n/** Cookie 工具 **/\r\nfunction readCookie(name: string): string | null {\r\n  if (typeof document === \"undefined\") return null;\r\n  const match = document.cookie.match(\r\n    new RegExp(\r\n      \"(?:^|; )\" + name.replace(/([.$?*|{}()\\[\\]\\\\/+^])/g, \"\\\\$1\") + \"=([^;]*)\"\r\n    )\r\n  );\r\n  return match ? decodeURIComponent(match[1]) : null;\r\n}\r\n\r\nfunction writeCookie(name: string, value: string, days = 365 * 2) {\r\n  if (typeof document === \"undefined\") return;\r\n  const date = new Date();\r\n  date.setTime(date.getTime() + days * 24 * 60 * 60 * 1000);\r\n  const expires = \"; expires=\" + date.toUTCString();\r\n  document.cookie = `${encodeURIComponent(name)}=${encodeURIComponent(\r\n    value\r\n  )}${expires}; path=/`;\r\n}\r\n\r\nfunction generateNumericId(): number {\r\n  // 生成稳定的数值 ID（53-bit 安全整数范围内）\r\n  const rand = Math.floor(Math.random() * 1e9);\r\n  const time = Date.now() % 1e9;\r\n  const id = Number(\r\n    String(time).padStart(9, \"0\") + String(rand).padStart(9, \"0\")\r\n  );\r\n  return id;\r\n}\r\n\r\n/**\r\n * 基于 Cookie 的匿名浏览器用户（非 Telegram 环境使用）\r\n * - 会在 cookie 中持久化 uid，下次复用\r\n */\r\nexport function getAnonymousBrowserUser(\r\n  cookieName = \"tg_tracking_uid\"\r\n): TelegramUserInfo {\r\n  let uidStr = readCookie(cookieName);\r\n  if (!uidStr) {\r\n    const uid = generateNumericId();\r\n    uidStr = String(uid);\r\n    writeCookie(cookieName, uidStr);\r\n  }\r\n  const uidNum =\r\n    Number(uidStr.replace(/\\D/g, \"\").slice(0, 15)) || generateNumericId();\r\n  const lang =\r\n    (typeof navigator !== \"undefined\" &&\r\n      (navigator.language || (navigator as any).userLanguage)) ||\r\n    \"en\";\r\n\r\n  return {\r\n    user: {\r\n      id: uidNum,\r\n      firstName: \"Guest\",\r\n      lastName: \"\",\r\n      username: `guest_${uidStr.slice(-6)}`,\r\n      languageCode: lang.toLowerCase(),\r\n      isPremium: false,\r\n      allowsWriteToPm: false,\r\n    },\r\n    authDate: new Date().toISOString(),\r\n    hash: \"anonymous_cookie_user\",\r\n    startParam: \"browser_guest\",\r\n    chatType: \"sender\",\r\n    chatInstance: \"\",\r\n  } as TelegramUserInfo;\r\n}\r\n\r\n/**\r\n * 获取默认的 mock 用户信息（保留旧逻辑）\r\n */\r\nexport function getDefaultMockUser(): TelegramUserInfo {\r\n  return {\r\n    user: {\r\n      id: 2077220643,\r\n      firstName: \"Mock\",\r\n      lastName: \"User\",\r\n      username: \"mock_user_demo\",\r\n      languageCode: \"zh-hans\",\r\n      isPremium: true,\r\n      allowsWriteToPm: true,\r\n    },\r\n    authDate: new Date().toISOString(),\r\n    hash: \"mock_hash_for_demo_purpose\",\r\n    startParam: \"demo_start_param\",\r\n    chatType: \"sender\",\r\n    chatInstance: \"-245769840322609948\",\r\n  } as TelegramUserInfo;\r\n}\r\n"]}

package/dist/sdk/types.d.ts

@@ -29,13 +29,13 @@ export interface SDKInitOptions {
     customUser?: TelegramUserInfo;
     /** 本地存储 Key 前缀，避免冲突 */
     storageKeyPrefix?: string;
-    /** 自定义接口地址（可选）。不传则使用默认正式环境 */
+    /** 自定义接口地址（可选）。不传则使用测试环境 */
     baseURL?: string;
     /** 可选：回调校验用 */
     appId?: string;
     /** 可选：SDK 初始化鉴权成功后的服务端回调地址 */
     notifyUrl?: string;
-    /** 可选：TON Connect manifest 文件地址；未传则使用默认测试清单 */
+    /** 可选：TON Connect manifest 文件地址；未传则使用测试清单 */
     tonConnectManifestUrl?: string;
 }
 export interface AuthResponseData {

package/dist/sdk/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sdk/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,sEAAoD,CAAA;IACpD,sEAAoD,CAAA;IACpD,8DAA4C,CAAA;AAC9C,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB","sourcesContent":["export enum AdPositionName {\r\n  GameRewardedAdPosition = \"game_rewarded_ad_position\",\r\n  TaskRewardedAdPosition = \"task_rewarded_ad_position\",\r\n  TaskListAdPosition = \"task_list_ad_position\",\r\n}\r\n\r\nexport interface TelegramUserUnsafeInitData {\r\n  [key: string]: unknown;\r\n}\r\n\r\nexport interface TelegramUserInfo {\r\n  user: {\r\n    id: number;\r\n    firstName?: string;\r\n    lastName?: string;\r\n    username?: string;\r\n    photoUrl?: string;\r\n    languageCode?: string;\r\n    allowsWriteToPm?: boolean;\r\n    isPremium?: boolean;\r\n  };\r\n  authDate?: string;\r\n  hash?: string;\r\n  startParam?: string;\r\n  chatType?: string;\r\n  chatInstance?: string;\r\n  [key: string]: unknown;\r\n}\r\n\r\nexport interface SDKInitOptions {\r\n  /** 自定义用户信息（可选） */\r\n  customUser?: TelegramUserInfo;\r\n  /** 本地存储 Key 前缀，避免冲突 */\r\n  storageKeyPrefix?: string;\r\n  /** 自定义接口地址（可选）。不传则使用默认正式环境 */\r\n  baseURL?: string;\r\n  /** 可选：回调校验用 */\r\n  appId?: string;\r\n  /** 可选：SDK 初始化鉴权成功后的服务端回调地址 */\r\n  notifyUrl?: string;\r\n  /** 可选：TON Connect manifest 文件地址；未传则使用默认测试清单 */\r\n  tonConnectManifestUrl?: string;\r\n}\r\n\r\nexport interface AuthResponseData {\r\n  token: string;\r\n  [key: string]: unknown;\r\n}\r\n\r\nexport interface APIResponse<T> {\r\n  code: number;\r\n  msg: string;\r\n  timestamp?: number;\r\n  datetime?: string;\r\n  data: T;\r\n}\r\n\r\nexport interface AdConfigItem {\r\n  id: number;\r\n  adTypeId: number;\r\n  adPlatformId: number;\r\n  title: string;\r\n  name: string;\r\n  spaceId: string;\r\n  rewardRate: number;\r\n  payout: number;\r\n  description?: string | null;\r\n  status: number;\r\n  enable: number;\r\n  createDatetime: string;\r\n  updateDatetime: string;\r\n  adId: number;\r\n  adPositionId: number;\r\n  adPositionName: string;\r\n  adPositionTitle: string;\r\n  rank: number;\r\n  adPlatformName: string; // e.g., monetag\r\n  adPlatformTitle: string; // e.g., Monetag\r\n  appId?: string | null;\r\n  appSecret?: string | null;\r\n  appUrl?: string | null;\r\n  adPlatformConfig?: unknown | null;\r\n  adTypeName: string; // e.g., interstitial_ad | popup_ad | inapp\r\n  adTypeTitle: string;\r\n  adRewardAmount?: number;\r\n}\r\n\r\nexport interface CreateAdParams {\r\n  adId: number;\r\n  adPositionId: number;\r\n  tournamentId?: number;\r\n  groupId?: number;\r\n}\r\n\r\nexport interface BindWalletResponseData {\r\n  id: number;\r\n  authId: number;\r\n  authHash: string;\r\n  authDatetime: string;\r\n  chatInstance: string;\r\n  firstName: string;\r\n  lastName: string;\r\n  username: string;\r\n  nickname: string | null;\r\n  allowsWritePm: number;\r\n  languageCode: string;\r\n  isPremiumUser: number;\r\n  avatarUrl: string | null;\r\n  email: string | null;\r\n  phone: string | null;\r\n  referrerId: number | null;\r\n  referrerAuthId: number | null;\r\n  walletAddress: string;\r\n  usdtWalletAddress: string;\r\n  points: number;\r\n  buyContribution: number;\r\n  revenuesContribution: number;\r\n  taskContribution: number;\r\n  status: number;\r\n  enable: number;\r\n}\r\n\r\nexport interface AdResponseData {\r\n  id: number;\r\n  adTypeId: number;\r\n  adPlatformId: number;\r\n  title: string;\r\n  name: string;\r\n  spaceId: string;\r\n  rewardRate: number;\r\n  payout: number;\r\n  description?: string | null;\r\n  status: number;\r\n  enable: number;\r\n  createDatetime: string;\r\n  updateDatetime: string;\r\n  adShowId: string;\r\n  start?: string[];\r\n  show?: string[];\r\n  error?: string[];\r\n  close?: string[];\r\n  reward?: string[];\r\n}\r\n\r\nexport interface MonitorUrls {\r\n  start?: string[];\r\n  show?: string[];\r\n  error?: string[];\r\n  close?: string[];\r\n  reward?: string[];\r\n}\r\n\r\n// 新增：广告展示回调接口，供 SDK 用户可选传入\r\nexport interface AdCallbacks {\r\n  onSuccess?: (result?: unknown) => void | Promise<void>;\r\n  onError?: (error: unknown) => void | Promise<void>;\r\n}\r\n\r\nexport interface BindWalletReq {\r\n  wallet: string;\r\n  forceBind: boolean;\r\n}\r\n\r\nexport interface TonTransactionResult {\r\n  transferHash?: string;\r\n  boc?: string;\r\n  raw?: unknown;\r\n}\r\n\r\nexport interface MerchantPayModeItem {\r\n  id: number;\r\n  title: string;\r\n  name: string; // USDT | TON | STARS\r\n  rate: number;\r\n  nameDesc: string;\r\n}\r\n\r\nexport interface MerchantPayModeListData {\r\n  payModeList: MerchantPayModeItem[];\r\n}\r\n\r\nexport interface MerchantPayCreateRequest {\r\n  currencyName: string; // USDT | TON | STARS\r\n  amount: number; // 单价/金额\r\n  outTradeNo: string; // 商户订单号\r\n  notifyUrl: string; // 回调地址\r\n  attach: string; // 附加信息\r\n}\r\n\r\nexport interface MerchantPayTransferMessage {\r\n  address: string;\r\n  amount: string;\r\n  payload?: string;\r\n}\r\n\r\nexport interface MerchantPayTransferData {\r\n  validUntil: number;\r\n  messages: MerchantPayTransferMessage[];\r\n}\r\n\r\nexport interface MerchantPayOrderBase {\r\n  orderSn: string;\r\n  transactionSn: string;\r\n  outTradeNo: string;\r\n  price: number | string;\r\n  count: number;\r\n  totalPrice: number | string;\r\n  currencyId: number;\r\n  currencyName: string;\r\n  currencyRate: number;\r\n  currencyAmount: number | string;\r\n  payUrl: string | null;\r\n  payExpireDatetime: string;\r\n  payDatetime: string | null;\r\n  finishDatetime: string | null;\r\n  description: string;\r\n  status: number;\r\n  statusDesc: string;\r\n  closeCode: string | null;\r\n  closeCodeDesc: string | null;\r\n  createDatetime: string;\r\n  updateDatetime: string;\r\n  transferHash: string | null;\r\n  transactionHash: string | null;\r\n  transactionLt: string | null;\r\n}\r\n\r\nexport interface MerchantPayCreateResponseData extends MerchantPayOrderBase {\r\n  transferData: MerchantPayTransferData;\r\n}\r\n\r\nexport interface MerchantPayFinishRequest {\r\n  orderSn: string;\r\n  status: string; // success / failed / cancelled\r\n  transferHash?: string;\r\n  orderId?: string;\r\n}\r\n\r\nexport type MerchantPayFinishResponseData = MerchantPayOrderBase;\r\n\r\nexport interface MerchantPayQueryResultRequest {\r\n  orderSn?: string;\r\n  outTradeNo?: string;\r\n}\r\n\r\nexport type MerchantPayQueryResultResponseData = MerchantPayOrderBase;\r\n\r\nexport type MerchantPayNotifyRequest = MerchantPayOrderBase;\r\n\r\nexport interface TonWalletProvider {\r\n  isConnected: () => boolean;\r\n  connect: () => Promise<boolean>;\r\n  disconnect: () => Promise<boolean>;\r\n  sendTonTransaction: (\r\n    transferData: MerchantPayTransferData\r\n  ) => Promise<TonTransactionResult>;\r\n  sendUsdtTransaction: (\r\n    transferData: MerchantPayTransferData\r\n  ) => Promise<TonTransactionResult>;\r\n}\r\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sdk/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,cAIX;AAJD,WAAY,cAAc;IACxB,sEAAoD,CAAA;IACpD,sEAAoD,CAAA;IACpD,8DAA4C,CAAA;AAC9C,CAAC,EAJW,cAAc,KAAd,cAAc,QAIzB","sourcesContent":["export enum AdPositionName {\r\n  GameRewardedAdPosition = \"game_rewarded_ad_position\",\r\n  TaskRewardedAdPosition = \"task_rewarded_ad_position\",\r\n  TaskListAdPosition = \"task_list_ad_position\",\r\n}\r\n\r\nexport interface TelegramUserUnsafeInitData {\r\n  [key: string]: unknown;\r\n}\r\n\r\nexport interface TelegramUserInfo {\r\n  user: {\r\n    id: number;\r\n    firstName?: string;\r\n    lastName?: string;\r\n    username?: string;\r\n    photoUrl?: string;\r\n    languageCode?: string;\r\n    allowsWriteToPm?: boolean;\r\n    isPremium?: boolean;\r\n  };\r\n  authDate?: string;\r\n  hash?: string;\r\n  startParam?: string;\r\n  chatType?: string;\r\n  chatInstance?: string;\r\n  [key: string]: unknown;\r\n}\r\n\r\nexport interface SDKInitOptions {\r\n  /** 自定义用户信息（可选） */\r\n  customUser?: TelegramUserInfo;\r\n  /** 本地存储 Key 前缀，避免冲突 */\r\n  storageKeyPrefix?: string;\r\n  /** 自定义接口地址（可选）。不传则使用测试环境 */\r\n  baseURL?: string;\r\n  /** 可选：回调校验用 */\r\n  appId?: string;\r\n  /** 可选：SDK 初始化鉴权成功后的服务端回调地址 */\r\n  notifyUrl?: string;\r\n  /** 可选：TON Connect manifest 文件地址；未传则使用测试清单 */\r\n  tonConnectManifestUrl?: string;\r\n}\r\n\r\nexport interface AuthResponseData {\r\n  token: string;\r\n  [key: string]: unknown;\r\n}\r\n\r\nexport interface APIResponse<T> {\r\n  code: number;\r\n  msg: string;\r\n  timestamp?: number;\r\n  datetime?: string;\r\n  data: T;\r\n}\r\n\r\nexport interface AdConfigItem {\r\n  id: number;\r\n  adTypeId: number;\r\n  adPlatformId: number;\r\n  title: string;\r\n  name: string;\r\n  spaceId: string;\r\n  rewardRate: number;\r\n  payout: number;\r\n  description?: string | null;\r\n  status: number;\r\n  enable: number;\r\n  createDatetime: string;\r\n  updateDatetime: string;\r\n  adId: number;\r\n  adPositionId: number;\r\n  adPositionName: string;\r\n  adPositionTitle: string;\r\n  rank: number;\r\n  adPlatformName: string; // e.g., monetag\r\n  adPlatformTitle: string; // e.g., Monetag\r\n  appId?: string | null;\r\n  appSecret?: string | null;\r\n  appUrl?: string | null;\r\n  adPlatformConfig?: unknown | null;\r\n  adTypeName: string; // e.g., interstitial_ad | popup_ad | inapp\r\n  adTypeTitle: string;\r\n  adRewardAmount?: number;\r\n}\r\n\r\nexport interface CreateAdParams {\r\n  adId: number;\r\n  adPositionId: number;\r\n  tournamentId?: number;\r\n  groupId?: number;\r\n}\r\n\r\nexport interface BindWalletResponseData {\r\n  id: number;\r\n  authId: number;\r\n  authHash: string;\r\n  authDatetime: string;\r\n  chatInstance: string;\r\n  firstName: string;\r\n  lastName: string;\r\n  username: string;\r\n  nickname: string | null;\r\n  allowsWritePm: number;\r\n  languageCode: string;\r\n  isPremiumUser: number;\r\n  avatarUrl: string | null;\r\n  email: string | null;\r\n  phone: string | null;\r\n  referrerId: number | null;\r\n  referrerAuthId: number | null;\r\n  walletAddress: string;\r\n  usdtWalletAddress: string;\r\n  points: number;\r\n  buyContribution: number;\r\n  revenuesContribution: number;\r\n  taskContribution: number;\r\n  status: number;\r\n  enable: number;\r\n}\r\n\r\nexport interface AdResponseData {\r\n  id: number;\r\n  adTypeId: number;\r\n  adPlatformId: number;\r\n  title: string;\r\n  name: string;\r\n  spaceId: string;\r\n  rewardRate: number;\r\n  payout: number;\r\n  description?: string | null;\r\n  status: number;\r\n  enable: number;\r\n  createDatetime: string;\r\n  updateDatetime: string;\r\n  adShowId: string;\r\n  start?: string[];\r\n  show?: string[];\r\n  error?: string[];\r\n  close?: string[];\r\n  reward?: string[];\r\n}\r\n\r\nexport interface MonitorUrls {\r\n  start?: string[];\r\n  show?: string[];\r\n  error?: string[];\r\n  close?: string[];\r\n  reward?: string[];\r\n}\r\n\r\n// 新增：广告展示回调接口，供 SDK 用户可选传入\r\nexport interface AdCallbacks {\r\n  onSuccess?: (result?: unknown) => void | Promise<void>;\r\n  onError?: (error: unknown) => void | Promise<void>;\r\n}\r\n\r\nexport interface BindWalletReq {\r\n  wallet: string;\r\n  forceBind: boolean;\r\n}\r\n\r\nexport interface TonTransactionResult {\r\n  transferHash?: string;\r\n  boc?: string;\r\n  raw?: unknown;\r\n}\r\n\r\nexport interface MerchantPayModeItem {\r\n  id: number;\r\n  title: string;\r\n  name: string; // USDT | TON | STARS\r\n  rate: number;\r\n  nameDesc: string;\r\n}\r\n\r\nexport interface MerchantPayModeListData {\r\n  payModeList: MerchantPayModeItem[];\r\n}\r\n\r\nexport interface MerchantPayCreateRequest {\r\n  currencyName: string; // USDT | TON | STARS\r\n  amount: number; // 单价/金额\r\n  outTradeNo: string; // 商户订单号\r\n  notifyUrl: string; // 回调地址\r\n  attach: string; // 附加信息\r\n}\r\n\r\nexport interface MerchantPayTransferMessage {\r\n  address: string;\r\n  amount: string;\r\n  payload?: string;\r\n}\r\n\r\nexport interface MerchantPayTransferData {\r\n  validUntil: number;\r\n  messages: MerchantPayTransferMessage[];\r\n}\r\n\r\nexport interface MerchantPayOrderBase {\r\n  orderSn: string;\r\n  transactionSn: string;\r\n  outTradeNo: string;\r\n  price: number | string;\r\n  count: number;\r\n  totalPrice: number | string;\r\n  currencyId: number;\r\n  currencyName: string;\r\n  currencyRate: number;\r\n  currencyAmount: number | string;\r\n  payUrl: string | null;\r\n  payExpireDatetime: string;\r\n  payDatetime: string | null;\r\n  finishDatetime: string | null;\r\n  description: string;\r\n  status: number;\r\n  statusDesc: string;\r\n  closeCode: string | null;\r\n  closeCodeDesc: string | null;\r\n  createDatetime: string;\r\n  updateDatetime: string;\r\n  transferHash: string | null;\r\n  transactionHash: string | null;\r\n  transactionLt: string | null;\r\n}\r\n\r\nexport interface MerchantPayCreateResponseData extends MerchantPayOrderBase {\r\n  transferData: MerchantPayTransferData;\r\n}\r\n\r\nexport interface MerchantPayFinishRequest {\r\n  orderSn: string;\r\n  status: string; // success / failed / cancelled\r\n  transferHash?: string;\r\n  orderId?: string;\r\n}\r\n\r\nexport type MerchantPayFinishResponseData = MerchantPayOrderBase;\r\n\r\nexport interface MerchantPayQueryResultRequest {\r\n  orderSn?: string;\r\n  outTradeNo?: string;\r\n}\r\n\r\nexport type MerchantPayQueryResultResponseData = MerchantPayOrderBase;\r\n\r\nexport type MerchantPayNotifyRequest = MerchantPayOrderBase;\r\n\r\nexport interface TonWalletProvider {\r\n  isConnected: () => boolean;\r\n  connect: () => Promise<boolean>;\r\n  disconnect: () => Promise<boolean>;\r\n  sendTonTransaction: (\r\n    transferData: MerchantPayTransferData\r\n  ) => Promise<TonTransactionResult>;\r\n  sendUsdtTransaction: (\r\n    transferData: MerchantPayTransferData\r\n  ) => Promise<TonTransactionResult>;\r\n}\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "hm-tracking-sdk",
-    "version": "0.2.1",
+    "version": "0.2.3",
     "private": false,
     "description": "Telegram tracking SDK for Web/Miniapp with TON/Stars payment integration.",
     "license": "MIT",