hm-tracking-sdk 0.1.0

package/dist/sdk/types.d.ts

@@ -0,0 +1,212 @@
+export declare enum AdPositionName {
+    GameRewardedAdPosition = "game_rewarded_ad_position",
+    TaskRewardedAdPosition = "task_rewarded_ad_position",
+    TaskListAdPosition = "task_list_ad_position"
+}
+export interface TelegramUserUnsafeInitData {
+    [key: string]: unknown;
+}
+export interface TelegramUserInfo {
+    id?: number;
+    first_name?: string;
+    last_name?: string;
+    username?: string;
+    language_code?: string;
+    allows_write_to_pm?: boolean;
+    auth_date?: number;
+    hash?: string;
+    [key: string]: unknown;
+}
+export interface SDKInitOptions {
+    /** 自定义用户信息（可选） */
+    customUser?: TelegramUserInfo;
+    /** 本地存储 Key 前缀，避免冲突 */
+    storageKeyPrefix?: string;
+    /** 自定义接口地址（可选）。不传则使用默认正式环境 */
+    baseURL?: string;
+}
+export interface AuthResponseData {
+    token: string;
+    [key: string]: unknown;
+}
+export interface APIResponse<T> {
+    code: number;
+    msg: string;
+    timestamp?: number;
+    datetime?: string;
+    data: T;
+}
+export interface AdConfigItem {
+    id: number;
+    adTypeId: number;
+    adPlatformId: number;
+    title: string;
+    name: string;
+    spaceId: string;
+    rewardRate: number;
+    payout: number;
+    description?: string | null;
+    status: number;
+    enable: number;
+    createDatetime: string;
+    updateDatetime: string;
+    adId: number;
+    adPositionId: number;
+    adPositionName: string;
+    adPositionTitle: string;
+    rank: number;
+    adPlatformName: string;
+    adPlatformTitle: string;
+    appId?: string | null;
+    appSecret?: string | null;
+    appUrl?: string | null;
+    adPlatformConfig?: unknown | null;
+    adTypeName: string;
+    adTypeTitle: string;
+    adRewardAmount?: number;
+}
+export interface CreateAdParams {
+    adId: number;
+    adPositionId: number;
+    tournamentId?: number;
+    groupId?: number;
+}
+export interface BindWalletResponseData {
+    id: number;
+    authId: number;
+    authHash: string;
+    authDatetime: string;
+    chatInstance: string;
+    firstName: string;
+    lastName: string;
+    username: string;
+    nickname: string | null;
+    allowsWritePm: number;
+    languageCode: string;
+    isPremiumUser: number;
+    avatarUrl: string | null;
+    email: string | null;
+    phone: string | null;
+    referrerId: number | null;
+    referrerAuthId: number | null;
+    walletAddress: string;
+    usdtWalletAddress: string;
+    points: number;
+    buyContribution: number;
+    revenuesContribution: number;
+    taskContribution: number;
+    status: number;
+    enable: number;
+}
+export interface AdResponseData {
+    id: number;
+    adTypeId: number;
+    adPlatformId: number;
+    title: string;
+    name: string;
+    spaceId: string;
+    rewardRate: number;
+    payout: number;
+    description?: string | null;
+    status: number;
+    enable: number;
+    createDatetime: string;
+    updateDatetime: string;
+    adShowId: string;
+    start?: string[];
+    show?: string[];
+    error?: string[];
+    close?: string[];
+    reward?: string[];
+}
+export interface MonitorUrls {
+    start?: string[];
+    show?: string[];
+    error?: string[];
+    close?: string[];
+    reward?: string[];
+}
+export interface BindWalletReq {
+    wallet: string;
+    forceBind: boolean;
+}
+export interface TonTransactionResult {
+    transferHash?: string;
+    boc?: string;
+    raw?: unknown;
+}
+export interface MerchantPayModeItem {
+    id: number;
+    title: string;
+    name: string;
+    rate: number;
+    nameDesc: string;
+}
+export interface MerchantPayModeListData {
+    payModeList: MerchantPayModeItem[];
+}
+export interface MerchantPayCreateRequest {
+    currencyName: string;
+    amount: number;
+    outTradeNo: string;
+    notifyUrl: string;
+    attach: string;
+}
+export interface MerchantPayTransferMessage {
+    address: string;
+    amount: string;
+    payload?: string;
+}
+export interface MerchantPayTransferData {
+    validUntil: number;
+    messages: MerchantPayTransferMessage[];
+}
+export interface MerchantPayOrderBase {
+    orderSn: string;
+    transactionSn: string;
+    outTradeNo: string;
+    price: number | string;
+    count: number;
+    totalPrice: number | string;
+    currencyId: number;
+    currencyName: string;
+    currencyRate: number;
+    currencyAmount: number | string;
+    payUrl: string | null;
+    payExpireDatetime: string;
+    payDatetime: string | null;
+    finishDatetime: string | null;
+    description: string;
+    status: number;
+    statusDesc: string;
+    closeCode: string | null;
+    closeCodeDesc: string | null;
+    createDatetime: string;
+    updateDatetime: string;
+    transferHash: string | null;
+    transactionHash: string | null;
+    transactionLt: string | null;
+}
+export interface MerchantPayCreateResponseData extends MerchantPayOrderBase {
+    transferData: MerchantPayTransferData;
+}
+export interface MerchantPayFinishRequest {
+    orderSn: string;
+    status: string;
+    transferHash?: string;
+    orderId?: string;
+}
+export type MerchantPayFinishResponseData = MerchantPayOrderBase;
+export interface MerchantPayQueryResultRequest {
+    orderSn?: string;
+    outTradeNo?: string;
+}
+export type MerchantPayQueryResultResponseData = MerchantPayOrderBase;
+export type MerchantPayNotifyRequest = MerchantPayOrderBase;
+export interface TonWalletProvider {
+    isConnected: () => boolean;
+    connect: () => Promise<boolean>;
+    disconnect: () => Promise<void>;
+    sendTonTransaction: (transferData: MerchantPayTransferData) => Promise<TonTransactionResult>;
+    sendUsdtTransaction: (transferData: MerchantPayTransferData) => Promise<TonTransactionResult>;
+}

package/dist/sdk/types.js

@@ -0,0 +1,7 @@
+export var AdPositionName;
+(function (AdPositionName) {
+    AdPositionName["GameRewardedAdPosition"] = "game_rewarded_ad_position";
+    AdPositionName["TaskRewardedAdPosition"] = "task_rewarded_ad_position";
+    AdPositionName["TaskListAdPosition"] = "task_list_ad_position";
+})(AdPositionName || (AdPositionName = {}));
+//# sourceMappingURL=types.js.map

package/dist/sdk/types.js.map

@@ -0,0 +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 {\n  GameRewardedAdPosition = \"game_rewarded_ad_position\",\n  TaskRewardedAdPosition = \"task_rewarded_ad_position\",\n  TaskListAdPosition = \"task_list_ad_position\",\n}\n\nexport interface TelegramUserUnsafeInitData {\n  [key: string]: unknown;\n}\n\nexport interface TelegramUserInfo {\n  id?: number;\n  first_name?: string;\n  last_name?: string;\n  username?: string;\n  language_code?: string;\n  allows_write_to_pm?: boolean;\n  auth_date?: number;\n  hash?: string;\n  [key: string]: unknown;\n}\n\nexport interface SDKInitOptions {\n  /** 自定义用户信息（可选） */\n  customUser?: TelegramUserInfo;\n  /** 本地存储 Key 前缀，避免冲突 */\n  storageKeyPrefix?: string;\n  /** 自定义接口地址（可选）。不传则使用默认正式环境 */\n  baseURL?: string;\n}\n\nexport interface AuthResponseData {\n  token: string;\n  [key: string]: unknown;\n}\n\nexport interface APIResponse<T> {\n  code: number;\n  msg: string;\n  timestamp?: number;\n  datetime?: string;\n  data: T;\n}\n\nexport interface AdConfigItem {\n  id: number;\n  adTypeId: number;\n  adPlatformId: number;\n  title: string;\n  name: string;\n  spaceId: string;\n  rewardRate: number;\n  payout: number;\n  description?: string | null;\n  status: number;\n  enable: number;\n  createDatetime: string;\n  updateDatetime: string;\n  adId: number;\n  adPositionId: number;\n  adPositionName: string;\n  adPositionTitle: string;\n  rank: number;\n  adPlatformName: string; // e.g., monetag\n  adPlatformTitle: string; // e.g., Monetag\n  appId?: string | null;\n  appSecret?: string | null;\n  appUrl?: string | null;\n  adPlatformConfig?: unknown | null;\n  adTypeName: string; // e.g., interstitial_ad | popup_ad | inapp\n  adTypeTitle: string;\n  adRewardAmount?: number;\n}\n\nexport interface CreateAdParams {\n  adId: number;\n  adPositionId: number;\n  tournamentId?: number;\n  groupId?: number;\n}\n\nexport interface BindWalletResponseData {\n  id: number;\n  authId: number;\n  authHash: string;\n  authDatetime: string;\n  chatInstance: string;\n  firstName: string;\n  lastName: string;\n  username: string;\n  nickname: string | null;\n  allowsWritePm: number;\n  languageCode: string;\n  isPremiumUser: number;\n  avatarUrl: string | null;\n  email: string | null;\n  phone: string | null;\n  referrerId: number | null;\n  referrerAuthId: number | null;\n  walletAddress: string;\n  usdtWalletAddress: string;\n  points: number;\n  buyContribution: number;\n  revenuesContribution: number;\n  taskContribution: number;\n  status: number;\n  enable: number;\n}\n\nexport interface AdResponseData {\n  id: number;\n  adTypeId: number;\n  adPlatformId: number;\n  title: string;\n  name: string;\n  spaceId: string;\n  rewardRate: number;\n  payout: number;\n  description?: string | null;\n  status: number;\n  enable: number;\n  createDatetime: string;\n  updateDatetime: string;\n  adShowId: string;\n  start?: string[];\n  show?: string[];\n  error?: string[];\n  close?: string[];\n  reward?: string[];\n}\n\nexport interface MonitorUrls {\n  start?: string[];\n  show?: string[];\n  error?: string[];\n  close?: string[];\n  reward?: string[];\n}\n\nexport interface BindWalletReq {\n  wallet: string;\n  forceBind: boolean;\n}\n\nexport interface TonTransactionResult {\n  transferHash?: string;\n  boc?: string;\n  raw?: unknown;\n}\n\nexport interface MerchantPayModeItem {\n  id: number;\n  title: string;\n  name: string; // USDT | TON | STARS\n  rate: number;\n  nameDesc: string;\n}\n\nexport interface MerchantPayModeListData {\n  payModeList: MerchantPayModeItem[];\n}\n\nexport interface MerchantPayCreateRequest {\n  currencyName: string; // USDT | TON | STARS\n  amount: number; // 单价/金额\n  outTradeNo: string; // 商户订单号\n  notifyUrl: string; // 回调地址\n  attach: string; // 附加信息\n}\n\nexport interface MerchantPayTransferMessage {\n  address: string;\n  amount: string;\n  payload?: string;\n}\n\nexport interface MerchantPayTransferData {\n  validUntil: number;\n  messages: MerchantPayTransferMessage[];\n}\n\nexport interface MerchantPayOrderBase {\n  orderSn: string;\n  transactionSn: string;\n  outTradeNo: string;\n  price: number | string;\n  count: number;\n  totalPrice: number | string;\n  currencyId: number;\n  currencyName: string;\n  currencyRate: number;\n  currencyAmount: number | string;\n  payUrl: string | null;\n  payExpireDatetime: string;\n  payDatetime: string | null;\n  finishDatetime: string | null;\n  description: string;\n  status: number;\n  statusDesc: string;\n  closeCode: string | null;\n  closeCodeDesc: string | null;\n  createDatetime: string;\n  updateDatetime: string;\n  transferHash: string | null;\n  transactionHash: string | null;\n  transactionLt: string | null;\n}\n\nexport interface MerchantPayCreateResponseData extends MerchantPayOrderBase {\n  transferData: MerchantPayTransferData;\n}\n\nexport interface MerchantPayFinishRequest {\n  orderSn: string;\n  status: string; // success / failed / cancelled\n  transferHash?: string;\n  orderId?: string;\n}\n\nexport type MerchantPayFinishResponseData = MerchantPayOrderBase;\n\nexport interface MerchantPayQueryResultRequest {\n  orderSn?: string;\n  outTradeNo?: string;\n}\n\nexport type MerchantPayQueryResultResponseData = MerchantPayOrderBase;\n\nexport type MerchantPayNotifyRequest = MerchantPayOrderBase;\n\nexport interface TonWalletProvider {\n  isConnected: () => boolean;\n  connect: () => Promise<boolean>;\n  disconnect: () => Promise<void>;\n  sendTonTransaction: (\n    transferData: MerchantPayTransferData\n  ) => Promise<TonTransactionResult>;\n  sendUsdtTransaction: (\n    transferData: MerchantPayTransferData\n  ) => Promise<TonTransactionResult>;\n}\n"]}

package/package.json

@@ -0,0 +1,63 @@
+{
+    "name": "hm-tracking-sdk",
+    "version": "0.1.0",
+    "private": false,
+    "description": "Telegram tracking SDK for Web/Miniapp with TON/Stars payment integration.",
+    "license": "MIT",
+    "keywords": [
+        "telegram",
+        "sdk",
+        "tracking",
+        "webapp"
+    ],
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "unpkg": "dist/browser/index.umd.js",
+    "jsdelivr": "dist/browser/index.umd.js",
+    "sideEffects": false,
+    "engines": {
+        "node": ">=18"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "build": "tsc -p tsconfig.json",
+        "clean": "rimraf dist",
+        "dev": "vite",
+        "build:browser": "vite build -c vite.browser.config.ts",
+        "pack:local": "node ./src/pack.mjs",
+        "prepublishOnly": "yarn build && yarn build:browser"
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "browser": "./dist/browser/index.es.js",
+            "import": "./dist/index.js",
+            "default": "./dist/browser/index.es.js"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "peerDependencies": {
+        "axios": "^1.7.7",
+        "crypto-js": "^4.2.0"
+    },
+    "dependencies": {
+        "@ton/ton": "^15.3.1",
+        "@tonconnect/ui": "^2.2.0",
+        "@twa-dev/sdk": "^7.0.0",
+        "buffer": "^6.0.3"
+    },
+    "devDependencies": {
+        "@types/crypto-js": "^4.2.2",
+        "@types/node": "^24.3.0",
+        "rimraf": "^6.0.1",
+        "typescript": "^5.5.4",
+        "vite": "6.2.6",
+        "vite-plugin-node-polyfills": "^0.24.0"
+    },
+    "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
+}