hm-tracking-sdk 0.1.0

package/dist/sdk/HmTrackingSDK.js

@@ -0,0 +1,336 @@
+import { HttpClient, PROD_BASE_URL } from "./http.js";
+import { NamespacedStorage } from "./storage.js";
+import { APIService } from "./api.js";
+import { HmAdManager } from "./monetag.js";
+import { AdMonitor } from "./adMonitor.js";
+import { getTelegramUserUnsafe, isTelegramEnv, getDefaultMockUser, getAnonymousBrowserUser, } from "./telegram.js";
+import WebApp from "@twa-dev/sdk";
+import { DefaultTonWalletProvider } from "./tonWalletProvider.js";
+/**
+ * HmTrackingSDK
+ * - Telegram 环境自动读取用户信息，否则使用自定义用户
+ * - /user/auth 鉴权并缓存 token
+ * - 封装广告位配置获取与广告创建/展示
+ * - 集成 Monetag (脚本注入 + 展示)
+ * - 集成 Telegram 钱包支付（基于商户支付接口）
+ */
+export class HmTrackingSDK {
+    constructor(options) {
+        this.options = options;
+        this.token = null;
+        this.user = null;
+        const opts = this.options || {};
+        this.storage = new NamespacedStorage(opts.storageKeyPrefix || "tg_tracking_sdk");
+        this.token = this.storage.get("token");
+        const baseURL = opts.baseURL || PROD_BASE_URL;
+        this.http = new HttpClient({
+            getToken: () => this.token,
+            onAuthError: () => this.clearAuth(),
+            baseURL,
+        });
+        this.api = new APIService(this.http);
+        this.hmAdManager = new HmAdManager({ autoInjectScript: true });
+        this.adMonitor = new AdMonitor((params) => this.api.adMonitor(params));
+        this.tonWallet = new DefaultTonWalletProvider(this.bindWallet.bind(this));
+    }
+    async init() {
+        const inTelegram = isTelegramEnv();
+        try {
+            const opts = this.options || {};
+            const tgUser = inTelegram ? getTelegramUserUnsafe() : null;
+            // 优先级：Telegram 环境用户 > 自定义用户 > 浏览器匿名用户 > mock 用户
+            if (tgUser) {
+                this.user = tgUser;
+                console.log("使用 Telegram 环境用户信息: 成功");
+            }
+            else if (opts.customUser) {
+                this.user = opts.customUser;
+                console.log("使用自定义用户信息");
+            }
+            else if (typeof window !== "undefined") {
+                this.user = getAnonymousBrowserUser();
+                console.log("使用浏览器匿名用户信息");
+            }
+            else {
+                this.user = getDefaultMockUser();
+                console.log("使用默认Mock用户信息");
+            }
+            if (!this.user) {
+                throw new Error("未获取到用户信息：请在非 Telegram 环境提供 customUser");
+            }
+            // 清理旧 token，开始认证
+            this.clearAuth();
+            await this.auth();
+            try {
+                await this.hmAdManager.init();
+            }
+            catch (error) {
+                console.error("广告管理器初始化失败，但继续执行其他初始化:", error);
+            }
+        }
+        catch (error) {
+            console.error("SDK初始化失败:", error);
+            throw error;
+        }
+    }
+    /**
+     * 调用 /user/auth 并持久化 token
+     */
+    async auth() {
+        try {
+            const res = await this.api.auth(this.user);
+            if (res.code !== 1)
+                throw new Error(res.msg || "鉴权失败");
+            const token = res.data?.token;
+            if (!token)
+                throw new Error("鉴权未返回 token");
+            this.token = token;
+            this.storage.set("token", token);
+        }
+        catch (error) {
+            console.error("auth认证失败:", error);
+            throw error;
+        }
+    }
+    /**
+     * 清空鉴权状态
+     */
+    clearAuth() {
+        this.token = null;
+        this.storage.remove("token");
+    }
+    /**
+     * 支付相关方法调用前校验 Telegram 环境
+     */
+    ensureTelegramEnvOrThrow() {
+        if (!isTelegramEnv()) {
+            throw new Error("支付相关功能仅支持在 Telegram 环境内使用");
+        }
+    }
+    /**
+     * 获取广告位配置
+     */
+    async getAdPositionConfig(adPositionName) {
+        const res = await this.api.getAdPositionConfig(String(adPositionName));
+        if (res.code !== 1)
+            throw new Error(res.msg || "获取广告位配置失败");
+        return res.data || [];
+    }
+    /**
+     * 创建广告
+     */
+    async createAd(params) {
+        const res = await this.api.createAd(params);
+        if (res.code !== 1)
+            throw new Error(res.msg || "创建广告失败");
+        const data = res.data;
+        if (data?.spaceId) {
+            await this.hmAdManager.setSpace(String(data.spaceId));
+        }
+        return data;
+    }
+    /**
+     * 展示广告（插屏/激励）传入 adPositionName，SDK 将自动完成：获取配置 -> 创建广告 -> 展示
+     * - 自动调用监测 URL（第一个链接走 /v2/ad/monitor，其余直接 GET）
+     */
+    async showHmAdByPosition(adPositionName) {
+        const configs = await this.getAdPositionConfig(adPositionName);
+        if (!configs || configs.length === 0) {
+            throw new Error("未找到广告位配置");
+        }
+        const cfg = configs[0];
+        const ad = await this.createAd({
+            adId: cfg.adId,
+            adPositionId: cfg.adPositionId,
+        });
+        const monitor = {
+            start: ad.start,
+            show: ad.show,
+            error: ad.error,
+            close: ad.close,
+            reward: ad.reward,
+        };
+        await this.showHmAdWithMonitor(monitor, ad.adShowId);
+    }
+    async showHmAdWithMonitor(monitor, adShowId) {
+        const id = adShowId || "";
+        await this.adMonitor.send(monitor.start, id);
+        await this.adMonitor.send(monitor.show, id);
+        try {
+            await this.hmAdManager.show();
+            await this.adMonitor.send(monitor.close, id);
+            await this.adMonitor.send(monitor.reward, id);
+        }
+        catch (e) {
+            await this.adMonitor.send(monitor.error, id);
+            throw e;
+        }
+    }
+    async showHmPopupAd(monitor, adShowId) {
+        const id = adShowId || "";
+        await this.adMonitor.send(monitor.start, id);
+        await this.adMonitor.send(monitor.show, id);
+        try {
+            await this.hmAdManager.showPopup();
+            await this.adMonitor.send(monitor.close, id);
+            await this.adMonitor.send(monitor.reward, id);
+        }
+        catch (e) {
+            await this.adMonitor.send(monitor.error, id);
+            throw e;
+        }
+    }
+    async showHmInAppAd(monitor, inAppOptions, adShowId) {
+        const id = adShowId || "";
+        await this.adMonitor.send(monitor.start, id);
+        await this.adMonitor.send(monitor.show, id);
+        try {
+            await this.hmAdManager.showInApp(inAppOptions);
+            await this.adMonitor.send(monitor.close, id);
+            await this.adMonitor.send(monitor.reward, id);
+        }
+        catch (e) {
+            await this.adMonitor.send(monitor.error, id);
+            throw e;
+        }
+    }
+    /**
+     * 绑定钱包地址到服务器
+     */
+    async bindWallet(walletAddress) {
+        try {
+            const res = await this.api.bindWalletReq({
+                wallet: walletAddress,
+                forceBind: true,
+            });
+            if (res.code !== 1) {
+                console.warn("钱包地址绑定失败:", res.msg);
+                return;
+            }
+        }
+        catch (error) {
+            console.error("钱包地址绑定请求失败:", error);
+            throw error;
+        }
+    }
+    async disconnectWallet() {
+        try {
+            if (!this.tonWallet)
+                return;
+            await this.tonWallet.disconnect();
+        }
+        catch (e) {
+            console.error("断开 Ton 钱包失败:", e);
+        }
+    }
+    async connectWallet() {
+        if (!this.tonWallet)
+            return false;
+        return await this.tonWallet.connect();
+    }
+    isWalletConnected() {
+        return !!this.tonWallet?.isConnected();
+    }
+    async ensureWalletConnected() {
+        this.ensureTelegramEnvOrThrow();
+        if (!this.tonWallet)
+            return false;
+        return await this.tonWallet.connect();
+    }
+    async getSupportedPayModes() {
+        const res = await this.api.merchantPayModeList();
+        if (res.code !== 1)
+            throw new Error(res.msg || "获取支付方式失败");
+        const raw = res.data;
+        if (Array.isArray(raw)) {
+            return { payModeList: raw };
+        }
+        const list = Array.isArray(raw?.payModeList) ? raw.payModeList : [];
+        return { payModeList: list };
+    }
+    async merchantPayQueryResult(data) {
+        const res = await this.api.merchantPayQueryResult(data);
+        if (res.code !== 1)
+            throw new Error(res.msg || "查询支付结果失败");
+        return res.data;
+    }
+    /**
+     * 通用支付完成回调
+     * @param orderSn 订单号
+     * @param status 支付状态 success/failed/cancelled
+     * @param transferHash 交易哈希（可选）
+     */
+    async finishPayment(orderSn, status, transferHash = "") {
+        const finishPayload = {
+            orderSn,
+            status,
+            transferHash,
+        };
+        const finishRes = await this.api.merchantPayFinish(finishPayload);
+        if (finishRes.code !== 1) {
+            throw new Error(finishRes.msg || "支付完成回调失败");
+        }
+        return finishRes.data;
+    }
+    async payByMerchant(data) {
+        this.ensureTelegramEnvOrThrow();
+        const upperCurrency = data.currencyName?.toUpperCase();
+        const createRes = await this.api.merchantPayCreate(data);
+        if (createRes.code !== 1)
+            throw new Error(createRes.msg || "创建支付订单失败");
+        const order = createRes.data;
+        // Stars 支付：无需连接钱包，直接拉起发票（若 payUrl 存在）
+        if (upperCurrency === "STARS" && order.payUrl) {
+            try {
+                await new Promise((resolve, reject) => {
+                    WebApp.openInvoice(order.payUrl, (status) => {
+                        // status 可能是 "paid", "cancelled", "failed" 等
+                        if (status === "paid") {
+                            resolve();
+                        }
+                        else {
+                            reject(new Error(`星币支付未完成: ${status || "未知状态"}`));
+                        }
+                    });
+                });
+                // 星币支付成功后调用支付完成回调并返回结果
+                const finishRes = await this.finishPayment(order.orderSn, "success");
+                return finishRes;
+            }
+            catch (error) {
+                // 支付失败或取消
+                const finishRes = await this.finishPayment(order.orderSn, "failed");
+                return finishRes;
+            }
+        }
+        // 其他币种需已连接钱包（仅判断连接状态，不主动连接或上报）
+        if (!this.tonWallet || !this.tonWallet.isConnected()) {
+            throw new Error("请先连接钱包");
+        }
+        const msg = order.transferData?.messages?.[0];
+        if (!msg)
+            throw new Error("订单未返回链上消息");
+        let result;
+        try {
+            if (upperCurrency === "TON") {
+                result = await this.tonWallet.sendTonTransaction(order.transferData);
+            }
+            else if (upperCurrency === "USDT") {
+                result = await this.tonWallet.sendUsdtTransaction(order.transferData);
+            }
+            else {
+                // 其他币种暂不处理
+                throw new Error("暂不支持的币种");
+            }
+            const transferHash = result?.transferHash;
+            const finishRes = await this.finishPayment(order.orderSn, "success", transferHash || "");
+            return finishRes;
+        }
+        catch (error) {
+            // 支付失败或取消
+            const finishRes = await this.finishPayment(order.orderSn, "failed");
+            return finishRes;
+        }
+    }
+}
+//# sourceMappingURL=HmTrackingSDK.js.map

package/dist/sdk/HmTrackingSDK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HmTrackingSDK.js","sourceRoot":"","sources":["../../src/sdk/HmTrackingSDK.ts"],"names":[],"mappings":"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","sourcesContent":["import { HttpClient, PROD_BASE_URL } from \"./http.js\";\r\nimport { NamespacedStorage } from \"./storage.js\";\r\nimport { APIService } from \"./api.js\";\r\nimport { HmAdManager } from \"./monetag.js\";\r\nimport { AdMonitor } from \"./adMonitor.js\";\r\nimport {\r\n  SDKInitOptions,\r\n  TelegramUserInfo,\r\n  AdPositionName,\r\n  AdConfigItem,\r\n  CreateAdParams,\r\n  AdResponseData,\r\n  MonitorUrls,\r\n  MerchantPayCreateRequest,\r\n  MerchantPayCreateResponseData,\r\n  MerchantPayFinishRequest,\r\n  MerchantPayModeListData,\r\n  TonWalletProvider,\r\n  MerchantPayFinishResponseData,\r\n  MerchantPayQueryResultRequest,\r\n  MerchantPayQueryResultResponseData,\r\n} from \"./types.js\";\r\nimport {\r\n  getTelegramUserUnsafe,\r\n  isTelegramEnv,\r\n  getDefaultMockUser,\r\n  getAnonymousBrowserUser,\r\n} from \"./telegram.js\";\r\nimport WebApp from \"@twa-dev/sdk\";\r\nimport { DefaultTonWalletProvider } from \"./tonWalletProvider.js\";\r\n\r\n/**\r\n * HmTrackingSDK\r\n * - Telegram 环境自动读取用户信息，否则使用自定义用户\r\n * - /user/auth 鉴权并缓存 token\r\n * - 封装广告位配置获取与广告创建/展示\r\n * - 集成 Monetag (脚本注入 + 展示)\r\n * - 集成 Telegram 钱包支付（基于商户支付接口）\r\n */\r\nexport class HmTrackingSDK {\r\n  private storage: NamespacedStorage;\r\n  private http: HttpClient;\r\n  private api: APIService;\r\n  private token: string | null = null;\r\n  private user: TelegramUserInfo | null = null;\r\n  private hmAdManager: HmAdManager;\r\n  private adMonitor: AdMonitor;\r\n  private tonWallet?: TonWalletProvider;\r\n\r\n  constructor(private options?: SDKInitOptions) {\r\n    const opts = this.options || {};\r\n    this.storage = new NamespacedStorage(\r\n      opts.storageKeyPrefix || \"tg_tracking_sdk\"\r\n    );\r\n    this.token = this.storage.get<string>(\"token\");\r\n\r\n    const baseURL = opts.baseURL || PROD_BASE_URL;\r\n    this.http = new HttpClient({\r\n      getToken: () => this.token,\r\n      onAuthError: () => this.clearAuth(),\r\n      baseURL,\r\n    });\r\n    this.api = new APIService(this.http);\r\n    this.hmAdManager = new HmAdManager({ autoInjectScript: true });\r\n    this.adMonitor = new AdMonitor((params) => this.api.adMonitor(params));\r\n    this.tonWallet = new DefaultTonWalletProvider(this.bindWallet.bind(this));\r\n  }\r\n\r\n  async init(): Promise<void> {\r\n    const inTelegram = isTelegramEnv();\r\n\r\n    try {\r\n      const opts = this.options || {};\r\n      const tgUser = inTelegram ? getTelegramUserUnsafe() : null;\r\n      // 优先级：Telegram 环境用户 > 自定义用户 > 浏览器匿名用户 > mock 用户\r\n      if (tgUser) {\r\n        this.user = tgUser;\r\n        console.log(\"使用 Telegram 环境用户信息: 成功\");\r\n      } else if (opts.customUser) {\r\n        this.user = opts.customUser;\r\n        console.log(\"使用自定义用户信息\");\r\n      } else if (typeof window !== \"undefined\") {\r\n        this.user = getAnonymousBrowserUser();\r\n        console.log(\"使用浏览器匿名用户信息\");\r\n      } else {\r\n        this.user = getDefaultMockUser();\r\n        console.log(\"使用默认Mock用户信息\");\r\n      }\r\n\r\n      if (!this.user) {\r\n        throw new Error(\r\n          \"未获取到用户信息：请在非 Telegram 环境提供 customUser\"\r\n        );\r\n      }\r\n\r\n      // 清理旧 token，开始认证\r\n      this.clearAuth();\r\n      await this.auth();\r\n\r\n      try {\r\n        await this.hmAdManager.init();\r\n      } catch (error) {\r\n        console.error(\"广告管理器初始化失败，但继续执行其他初始化:\", error);\r\n      }\r\n    } catch (error) {\r\n      console.error(\"SDK初始化失败:\", error);\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 调用 /user/auth 并持久化 token\r\n   */\r\n  private async auth(): Promise<void> {\r\n    try {\r\n      const res = await this.api.auth(this.user as Record<string, unknown>);\r\n      if (res.code !== 1) throw new Error(res.msg || \"鉴权失败\");\r\n      const token = (res.data as any)?.token as string | undefined;\r\n      if (!token) throw new Error(\"鉴权未返回 token\");\r\n      this.token = token;\r\n      this.storage.set(\"token\", token);\r\n    } catch (error) {\r\n      console.error(\"auth认证失败:\", error);\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 清空鉴权状态\r\n   */\r\n  private clearAuth() {\r\n    this.token = null;\r\n    this.storage.remove(\"token\");\r\n  }\r\n\r\n  /**\r\n   * 支付相关方法调用前校验 Telegram 环境\r\n   */\r\n  private ensureTelegramEnvOrThrow() {\r\n    if (!isTelegramEnv()) {\r\n      throw new Error(\"支付相关功能仅支持在 Telegram 环境内使用\");\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 获取广告位配置\r\n   */\r\n  private async getAdPositionConfig(\r\n    adPositionName: AdPositionName | string\r\n  ): Promise<AdConfigItem[]> {\r\n    const res = await this.api.getAdPositionConfig(String(adPositionName));\r\n    if (res.code !== 1) throw new Error(res.msg || \"获取广告位配置失败\");\r\n    return res.data || [];\r\n  }\r\n\r\n  /**\r\n   * 创建广告\r\n   */\r\n  private async createAd(params: CreateAdParams): Promise<AdResponseData> {\r\n    const res = await this.api.createAd(params);\r\n    if (res.code !== 1) throw new Error(res.msg || \"创建广告失败\");\r\n    const data = res.data as AdResponseData;\r\n\r\n    if (data?.spaceId) {\r\n      await this.hmAdManager.setSpace(String(data.spaceId));\r\n    }\r\n\r\n    return data;\r\n  }\r\n\r\n  /**\r\n   * 展示广告（插屏/激励）传入 adPositionName，SDK 将自动完成：获取配置 -> 创建广告 -> 展示\r\n   * - 自动调用监测 URL（第一个链接走 /v2/ad/monitor，其余直接 GET）\r\n   */\r\n  async showHmAdByPosition(\r\n    adPositionName: AdPositionName | string\r\n  ): Promise<void> {\r\n    const configs = await this.getAdPositionConfig(adPositionName);\r\n    if (!configs || configs.length === 0) {\r\n      throw new Error(\"未找到广告位配置\");\r\n    }\r\n    const cfg = configs[0];\r\n    const ad = await this.createAd({\r\n      adId: cfg.adId,\r\n      adPositionId: cfg.adPositionId,\r\n    });\r\n    const monitor: MonitorUrls = {\r\n      start: ad.start,\r\n      show: ad.show,\r\n      error: ad.error,\r\n      close: ad.close,\r\n      reward: ad.reward,\r\n    };\r\n    await this.showHmAdWithMonitor(monitor, ad.adShowId);\r\n  }\r\n\r\n  private async showHmAdWithMonitor(\r\n    monitor: MonitorUrls,\r\n    adShowId?: string\r\n  ): Promise<void> {\r\n    const id = adShowId || \"\";\r\n    await this.adMonitor.send(monitor.start, id);\r\n    await this.adMonitor.send(monitor.show, id);\r\n    try {\r\n      await this.hmAdManager.show();\r\n      await this.adMonitor.send(monitor.close, id);\r\n      await this.adMonitor.send(monitor.reward, id);\r\n    } catch (e) {\r\n      await this.adMonitor.send(monitor.error, id);\r\n      throw e;\r\n    }\r\n  }\r\n\r\n  async showHmPopupAd(monitor: MonitorUrls, adShowId?: string): Promise<void> {\r\n    const id = adShowId || \"\";\r\n    await this.adMonitor.send(monitor.start, id);\r\n    await this.adMonitor.send(monitor.show, id);\r\n    try {\r\n      await this.hmAdManager.showPopup();\r\n      await this.adMonitor.send(monitor.close, id);\r\n      await this.adMonitor.send(monitor.reward, id);\r\n    } catch (e) {\r\n      await this.adMonitor.send(monitor.error, id);\r\n      throw e;\r\n    }\r\n  }\r\n\r\n  async showHmInAppAd(\r\n    monitor: MonitorUrls,\r\n    inAppOptions?: any,\r\n    adShowId?: string\r\n  ): Promise<void> {\r\n    const id = adShowId || \"\";\r\n    await this.adMonitor.send(monitor.start, id);\r\n    await this.adMonitor.send(monitor.show, id);\r\n    try {\r\n      await this.hmAdManager.showInApp(inAppOptions);\r\n      await this.adMonitor.send(monitor.close, id);\r\n      await this.adMonitor.send(monitor.reward, id);\r\n    } catch (e) {\r\n      await this.adMonitor.send(monitor.error, id);\r\n      throw e;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 绑定钱包地址到服务器\r\n   */\r\n  private async bindWallet(walletAddress: string): Promise<void> {\r\n    try {\r\n      const res = await this.api.bindWalletReq({\r\n        wallet: walletAddress,\r\n        forceBind: true,\r\n      });\r\n      if (res.code !== 1) {\r\n        console.warn(\"钱包地址绑定失败:\", res.msg);\r\n        return;\r\n      }\r\n    } catch (error) {\r\n      console.error(\"钱包地址绑定请求失败:\", error);\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  async disconnectWallet(): Promise<void> {\r\n    try {\r\n      if (!this.tonWallet) return;\r\n      await this.tonWallet.disconnect();\r\n    } catch (e) {\r\n      console.error(\"断开 Ton 钱包失败:\", e);\r\n    }\r\n  }\r\n\r\n  async connectWallet(): Promise<boolean> {\r\n    if (!this.tonWallet) return false;\r\n    return await this.tonWallet.connect();\r\n  }\r\n\r\n  isWalletConnected(): boolean {\r\n    return !!this.tonWallet?.isConnected();\r\n  }\r\n\r\n  async ensureWalletConnected(): Promise<boolean> {\r\n    this.ensureTelegramEnvOrThrow();\r\n    if (!this.tonWallet) return false;\r\n    return await this.tonWallet.connect();\r\n  }\r\n\r\n  async getSupportedPayModes(): Promise<MerchantPayModeListData> {\r\n    const res = await this.api.merchantPayModeList();\r\n    if (res.code !== 1) throw new Error(res.msg || \"获取支付方式失败\");\r\n    const raw: any = res.data as any;\r\n    if (Array.isArray(raw)) {\r\n      return { payModeList: raw };\r\n    }\r\n    const list = Array.isArray(raw?.payModeList) ? raw.payModeList : [];\r\n    return { payModeList: list };\r\n  }\r\n\r\n  async merchantPayQueryResult(\r\n    data: MerchantPayQueryResultRequest\r\n  ): Promise<MerchantPayQueryResultResponseData> {\r\n    const res = await this.api.merchantPayQueryResult(data);\r\n    if (res.code !== 1) throw new Error(res.msg || \"查询支付结果失败\");\r\n    return res.data;\r\n  }\r\n\r\n  /**\r\n   * 通用支付完成回调\r\n   * @param orderSn 订单号\r\n   * @param status 支付状态 success/failed/cancelled\r\n   * @param transferHash 交易哈希（可选）\r\n   */\r\n  private async finishPayment(\r\n    orderSn: string,\r\n    status: string,\r\n    transferHash: string = \"\"\r\n  ): Promise<MerchantPayFinishResponseData> {\r\n    const finishPayload: MerchantPayFinishRequest = {\r\n      orderSn,\r\n      status,\r\n      transferHash,\r\n    };\r\n    const finishRes = await this.api.merchantPayFinish(finishPayload);\r\n    if (finishRes.code !== 1) {\r\n      throw new Error(finishRes.msg || \"支付完成回调失败\");\r\n    }\r\n    return finishRes.data;\r\n  }\r\n\r\n  async payByMerchant(\r\n    data: MerchantPayCreateRequest\r\n  ): Promise<MerchantPayFinishResponseData> {\r\n    this.ensureTelegramEnvOrThrow();\r\n    const upperCurrency = data.currencyName?.toUpperCase();\r\n    const createRes = await this.api.merchantPayCreate(data);\r\n    if (createRes.code !== 1)\r\n      throw new Error(createRes.msg || \"创建支付订单失败\");\r\n    const order = createRes.data;\r\n\r\n    // Stars 支付：无需连接钱包，直接拉起发票（若 payUrl 存在）\r\n    if (upperCurrency === \"STARS\" && order.payUrl) {\r\n      try {\r\n        await new Promise<void>((resolve, reject) => {\r\n          WebApp.openInvoice(order.payUrl as any, (status) => {\r\n            // status 可能是 \"paid\", \"cancelled\", \"failed\" 等\r\n            if (status === \"paid\") {\r\n              resolve();\r\n            } else {\r\n              reject(new Error(`星币支付未完成: ${status || \"未知状态\"}`));\r\n            }\r\n          });\r\n        });\r\n        // 星币支付成功后调用支付完成回调并返回结果\r\n        const finishRes = await this.finishPayment(order.orderSn, \"success\");\r\n        return finishRes;\r\n      } catch (error) {\r\n        // 支付失败或取消\r\n        const finishRes = await this.finishPayment(order.orderSn, \"failed\");\r\n        return finishRes;\r\n      }\r\n    }\r\n\r\n    // 其他币种需已连接钱包（仅判断连接状态，不主动连接或上报）\r\n    if (!this.tonWallet || !this.tonWallet.isConnected()) {\r\n      throw new Error(\"请先连接钱包\");\r\n    }\r\n    const msg = order.transferData?.messages?.[0];\r\n    if (!msg) throw new Error(\"订单未返回链上消息\");\r\n\r\n    let result;\r\n    try {\r\n      if (upperCurrency === \"TON\") {\r\n        result = await this.tonWallet.sendTonTransaction(order.transferData);\r\n      } else if (upperCurrency === \"USDT\") {\r\n        result = await this.tonWallet.sendUsdtTransaction(order.transferData);\r\n      } else {\r\n        // 其他币种暂不处理\r\n        throw new Error(\"暂不支持的币种\");\r\n      }\r\n\r\n      const transferHash = (result as any)?.transferHash;\r\n      const finishRes = await this.finishPayment(\r\n        order.orderSn,\r\n        \"success\",\r\n        transferHash || \"\"\r\n      );\r\n      return finishRes;\r\n    } catch (error) {\r\n      // 支付失败或取消\r\n      const finishRes = await this.finishPayment(order.orderSn, \"failed\");\r\n      return finishRes;\r\n    }\r\n  }\r\n}\r\n"]}

package/dist/sdk/TgTrackingSDK.d.ts

@@ -0,0 +1,68 @@
+import { SDKInitOptions, AdPositionName, MonitorUrls, MerchantPayCreateRequest, MerchantPayModeListData, MerchantPayFinishResponseData, MerchantPayQueryResultRequest, MerchantPayQueryResultResponseData } from "./types.js";
+/**
+ * TgTrackingSDK
+ * - Telegram 环境自动读取用户信息，否则使用自定义用户
+ * - /user/auth 鉴权并缓存 token
+ * - 封装广告位配置获取与广告创建/展示
+ * - 集成 Monetag (脚本注入 + 展示)
+ * - 集成 Telegram 钱包支付（基于商户支付接口）
+ */
+export declare class TgTrackingSDK {
+    private options?;
+    private storage;
+    private http;
+    private api;
+    private token;
+    private user;
+    private hmAdManager;
+    private adMonitor;
+    private tonWallet?;
+    constructor(options?: SDKInitOptions | undefined);
+    init(): Promise<void>;
+    /**
+     * 调用 /user/auth 并持久化 token
+     */
+    private auth;
+    /**
+     * 清空鉴权状态
+     */
+    private clearAuth;
+    /**
+     * 支付相关方法调用前校验 Telegram 环境
+     */
+    private ensureTelegramEnvOrThrow;
+    /**
+     * 获取广告位配置
+     */
+    private getAdPositionConfig;
+    /**
+     * 创建广告
+     */
+    private createAd;
+    /**
+     * 展示广告（插屏/激励）传入 adPositionName，SDK 将自动完成：获取配置 -> 创建广告 -> 展示
+     * - 自动调用监测 URL（第一个链接走 /v2/ad/monitor，其余直接 GET）
+     */
+    showHmAdByPosition(adPositionName: AdPositionName | string): Promise<void>;
+    private showHmAdWithMonitor;
+    showHmPopupAd(monitor: MonitorUrls, adShowId?: string): Promise<void>;
+    showHmInAppAd(monitor: MonitorUrls, inAppOptions?: any, adShowId?: string): Promise<void>;
+    /**
+     * 绑定钱包地址到服务器
+     */
+    private bindWallet;
+    disconnectWallet(): Promise<void>;
+    connectWallet(): Promise<boolean>;
+    isWalletConnected(): boolean;
+    ensureWalletConnected(): Promise<boolean>;
+    getSupportedPayModes(): Promise<MerchantPayModeListData>;
+    merchantPayQueryResult(data: MerchantPayQueryResultRequest): Promise<MerchantPayQueryResultResponseData>;
+    /**
+     * 通用支付完成回调
+     * @param orderSn 订单号
+     * @param status 支付状态 success/failed/cancelled
+     * @param transferHash 交易哈希（可选）
+     */
+    private finishPayment;
+    payByMerchant(data: MerchantPayCreateRequest): Promise<MerchantPayFinishResponseData>;
+}