@seayoo-web/gamer-api 2.0.15 → 2.0.17

package/README.md

@@ -6,11 +6,17 @@
 import { NetRequest } from "@seayoo-web/request";
 import { AuthToken, EventApi, ClubApi, CommunityApi } from "@seayoo-web/gamer-api";
 import { captureException } from "@sentry/vue";
+import { GamerWebAuth } from "@seayoo-web/login";
 
 const authToken = new AuthToken(SY_GAMER_API, NetRequest);
 const eventApi = new EventApi(authToken, SY_EVENT_ID);
 const clubApi = new ClubApi(authToken);
 const communityApi = new CommunityApi(authToken);
+const loginSDK = new GamerWebAuth(autoToken, {
+  anonymous: false,
+  hidePasswordLogin: false,
+  // 更多配置 @seayoo-web/login
+});
 
 // 调整请求配置
 authToken.req.setConfig({
@@ -19,9 +25,8 @@ authToken.req.setConfig({
   },
   errorHandler({ status, rawError, sentryError, sentryTags, sentryExtra }) {
     if (status === 401) {
-      logout();
-      // 继续其他处理:提示或直接登录
-      //
+      // 提示或直接登录
+      // loginSDK.login()
       return;
     }
     // 意外错误进行上报
@@ -34,29 +39,8 @@ authToken.req.setConfig({
   },
 });
 
-// 触发登录
-export async function login() {
-  // idToken 通过通行证登录组件获取
-  const idToken = await accountLogin();
-  if (idToken) {
-    authToken.idToken = idToken;
-    // 可选自动登录调用，后续每个 api 都会自动检查并 autoLogin
-    authToken.autoLogin();
-  }
-}
-
-// 获取用户数据
-export async function getUserInfo() {
-  return authToken.isLoggedIn ? await authToken.getSession() : null;
-}
-
-// 退出登录(同步操作)
-export function logout() {
-  authToken.logout();
-}
-
 // 导出供其他功能使用
-export { eventApi, clubApi, communityApi };
+export { eventApi, clubApi, communityApi, loginSDK };
 ```
 
 ## 小程序初始化
@@ -64,42 +48,40 @@ export { eventApi, clubApi, communityApi };
 ```js
 import { NetRequest } from "@seayoo-web/request/wx";
 import { AuthToken, EventApi, ClubApi, WeixinApi } from "@seayoo-web/gamer-api";
+import { GamerWeixinAuth } from "@seayoo-web/login";
 
 const authToken = new AuthToken(SY_GAMER_API, NetRequest);
-const eventApi = new EventApi(authToken, eventId);
+const eventApi = new EventApi(authToken, SY_EVENT_ID);
 const clubApi = new ClubApi(authToken);
 const communityApi = new CommunityApi(authToken);
-const weixinApi = new WeixinApi(authToken, appId);
+const weixinApi = new WeixinApi(authToken, SY_APP_ID);
+const loginSDK = new GamerWeixinAuth(authToken, weixinApi);
 
-// 登录
-export function login() {
-    // idToken 通过通行证登录组件获取
-    const idToken = await accountLogin();
-    if(!idToken) {
-        return
+// 调整请求配置
+authToken.req.setConfig({
+  messageHandler(_, message) {
+    toast(message);
+  },
+  errorHandler({ status, rawError, sentryError, sentryTags, sentryExtra }) {
+    if (status === 401) {
+      // 提示或直接登录
+      if(loginSDK.hasLoginToken) {
+         loginSDK.login()
+      } else {
+         // 跳转到用户手机号授权页面
+      }
+      return;
     }
-    // 获取 weixinToken，成功时返回 { weixin_token, open_id, union_id }
-    const result = await weixinApi.login();
-    if(!("weixin_token" in result)) {
-        return
+    // 意外错误进行上报
+    if (rawError) {
+      captureException(sentryError, {
+        extra: sentryExtra,
+        tags: sentryTags,
+      });
     }
-    // 设置
-	  authToken.idToken = idToken
-    authToken.weixinToken = result.weixin_token;
-    // 可选自动登录调用，后续每个 api 都会自动检查并 autoLogin
-    authToken.autoLogin();
-}
-
-// 获取用户数据
-export async function getUserInfo() {
-  return authToken.isLoggedIn ? await authToken.getSession() : null;
-}
-
-// 退出登录(同步操作)
-export function logout() {
-  authToken.logout();
-}
+  },
+});
 
 // 导出供其他功能使用
-export { eventApi, clubApi, communityApi, weixinApi };
+export { eventApi, clubApi, communityApi, weixinApi, loginSDK };
 ```

package/dist/index.js

@@ -2,18 +2,18 @@ var le = Object.defineProperty;
 var me = (i, t, n) => t in i ? le(i, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : i[t] = n;
 var l = (i, t, n) => me(i, typeof t != "symbol" ? t + "" : t, n);
 import { isComboWebView as de } from "@seayoo-web/combo-webview";
-import { isPlainObject as v, useConsole as ge, Support as b, usePromise as pe, pruneURL as _e, queryString as L, pruneObject as a, v as e, omitFields as C, typedObjectGuard as o, parseJSON as be, removePara as A } from "@seayoo-web/utils";
+import { isPlainObject as v, useConsole as ge, Support as b, usePromise as pe, pruneURL as _e, queryString as L, pruneObject as a, v as e, omitFields as C, typedObjectGuard as o, parseJSON as be, removePara as N } from "@seayoo-web/utils";
 function ye(i) {
   return v(i, "gamer_token") && typeof i.gamer_token == "string";
 }
-function O(i) {
+function A(i) {
   return v(i);
 }
 const f = ge("GamerApiSDK");
 function fe(i) {
   return /^\/[a-z\d-]+$/.test(i);
 }
-async function we() {
+async function he() {
   const { promise: i, resolve: t } = pe();
   return wx.login({
     success(n) {
@@ -24,7 +24,7 @@ async function we() {
     }
   }), await i;
 }
-const he = {
+const we = {
   get(i) {
     return localStorage.getItem(i) || "";
   },
@@ -57,17 +57,18 @@ const he = {
       f.error("removeStorageSync", t);
     }
   }
-}, w = "gamer_token";
-class wr {
+}, h = "gamer_token";
+class hr {
   constructor(t, n) {
+    l(this, "$NetRequest");
     l(this, "$idToken", "");
     l(this, "$weixinToken", "");
     l(this, "$gamerToken", "");
     l(this, "req");
     l(this, "storage");
-    this.storage = b.wx ? ke : he;
+    this.storage = b.wx ? ke : we;
     const r = fe(t) ? t : `https://${_e(t)}`;
-    this.req = n({
+    this.$NetRequest = n, this.req = n({
       baseURL: `${r}/v1`,
       timeout: 1e4,
       responseRule: {
@@ -84,8 +85,11 @@ class wr {
       }
     }), de() ? this.$gamerToken = L("gamer_token") : this.loadGamerTokenCache();
   }
+  get NetRequest() {
+    return this.$NetRequest;
+  }
   loadGamerTokenCache() {
-    const n = this.storage.get(w).match(/^(\d{12,})#(.{8,})$/);
+    const n = this.storage.get(h).match(/^(\d{12,})#(.{8,})$/);
     if (n) {
       const r = parseInt(n[1]), s = n[2];
       if (r > Date.now() - (24 * 3600 - 10) * 1e3) {
@@ -93,7 +97,7 @@ class wr {
         return;
       }
     }
-    this.storage.remove(w);
+    this.storage.remove(h);
   }
   /** 当前是否为登录状态，即是否拥有 gamerToken */
   get isLoggedIn() {
@@ -127,7 +131,7 @@ class wr {
    * 直接写入 Gamer Token，并更新缓存
    */
   set gamerToken(t) {
-    this.$gamerToken = t, t ? this.storage.set(w, `${Date.now()}#${t}`) : this.storage.remove(w);
+    this.$gamerToken = t, t ? this.storage.set(h, `${Date.now()}#${t}`) : this.storage.remove(h);
   }
   /**
    * 退出登录，销毁相关 Token
@@ -183,7 +187,7 @@ class wr {
    */
   async getSession() {
     if (!await this.autoLogin()) return null;
-    const { data: t } = await this.req.get("session", O, {
+    const { data: t } = await this.req.get("session", A, {
       message: !1
     });
     return t;
@@ -195,7 +199,7 @@ class wr {
    */
   async authRealName(t) {
     if (!await this.autoLogin()) return null;
-    const { data: n } = await this.req.post("auth-real-name", a(t), O);
+    const { data: n } = await this.req.post("auth-real-name", a(t), A);
     return n;
   }
 }
@@ -206,14 +210,14 @@ const ve = {
   Male: "male",
   /** 女 */
   Female: "female"
-}, Ce = e.string().enum(ve).lock(), Ve = {
+}, Ce = e.string().enum(ve).lock(), Re = {
   /** 积分增加 */
   Increase: "increase",
   /** 积分减少 */
   Decrease: "decrease",
   /** 积分过期 */
   Expired: "expired"
-}, Re = e.string().enum(Ve).lock(), je = {
+}, Ve = e.string().enum(Re).lock(), je = {
   /** 游戏内购买 */
   Order: "order",
   /** 游戏内消耗 */
@@ -270,15 +274,15 @@ const ve = {
 }).lock(), Ee = e.object({
   server_id: e.string(),
   server_name: e.string()
-}).lock(), Ue = e.object({
+}).lock(), $e = e.object({
   role_id: e.string(),
   role_name: e.string()
 }).lock(), J = e.object({
-  ...Ue.shape,
+  ...$e.shape,
   ...Ee.shape,
   role_level: e.number(),
   last_login_time: e.number()
-}).lock(), $e = e.object({
+}).lock(), Ue = e.object({
   ...J.shape,
   /** 角色战力 */
   role_fighting: e.number(),
@@ -310,7 +314,7 @@ const ve = {
   balance_credit: e.number()
 }).lock(), Ie = e.object({
   id: e.number(),
-  change_type: Re,
+  change_type: Ve,
   change_scene: Te,
   change_credit: e.number(),
   balance: e.number(),
@@ -353,7 +357,7 @@ const ve = {
 }).lock(), Ge = e.object({
   ...C(X.shape, "tag"),
   product: Y.clone().optional()
-}).lock(), hr = e.union(
+}).lock(), wr = e.union(
   e.object({
     server_id: e.string(),
     role_id: e.string()
@@ -361,7 +365,7 @@ const ve = {
   e.object({
     address_id: e.number()
   })
-).satisfies().lock(), Ae = e.object({
+).satisfies().lock(), Ne = e.object({
   recipient: e.string(),
   mobile: e.string(),
   province: e.string(),
@@ -370,11 +374,11 @@ const ve = {
   address: e.string(),
   express_company: e.string(),
   express_number: e.string()
-}).lock(), Oe = e.object({
+}).lock(), Ae = e.object({
   server_id: e.string(),
   role_id: e.string(),
   role_name: e.string()
-}).lock(), Ne = e.object({
+}).lock(), Oe = e.object({
   redemption_id: e.number(),
   player_id: e.string(),
   product_id: e.number(),
@@ -387,12 +391,12 @@ const ve = {
   amount: e.number(),
   status: Se,
   created_at: e.number(),
-  extra_data: e.union(Ae.clone(), Oe.clone()).satisfies().optional()
-}), Be = e.guard(Le), N = o({ player: Pe }), Qe = o({ roles: e.array(J) }), T = o({ role_card: $e }), B = e.guard(Fe), Q = e.guard(K), Me = o({ addresses: e.array(K) }), He = e.guard(De), ze = o({
+  extra_data: e.union(Ne.clone(), Ae.clone()).satisfies().optional()
+}), Be = e.guard(Le), O = o({ player: Pe }), Qe = o({ roles: e.array(J) }), T = o({ role_card: Ue }), B = e.guard(Fe), Q = e.guard(K), Me = o({ addresses: e.array(K) }), He = e.guard(De), ze = o({
   credit_logs: e.array(Ie),
   next_token: e.string().optional()
 }), Je = o({ products: e.array(Y) }), Ke = o({ benefits: e.array(X) }), Xe = o({ benefit: Ge }), Ye = o({
-  redemptions: e.array(Ne),
+  redemptions: e.array(Oe),
   next_token: e.string().optional()
 });
 class kr {
@@ -417,7 +421,7 @@ class kr {
    */
   async getCurrentPlayer() {
     await this.token.autoLogin();
-    const { data: t, code: n } = await this.req.get("club/current-player", N);
+    const { data: t, code: n } = await this.req.get("club/current-player", O);
     return (t == null ? void 0 : t.player) ?? { error: n };
   }
   /**
@@ -432,7 +436,7 @@ class kr {
       {
         id_token: this.token.idToken
       },
-      N
+      O
     );
     return (t == null ? void 0 : t.player) ?? {
       error: n
@@ -624,7 +628,7 @@ class kr {
     return { redemptions: (n == null ? void 0 : n.redemptions) || [], next_token: n == null ? void 0 : n.next_token };
   }
 }
-const V = {
+const R = {
   /** 活动道具 */
   EventItem: "event_item",
   /** 游戏内道具 */
@@ -643,7 +647,7 @@ const V = {
   ExternalCode: "external_gift_code",
   /** 空奖励 */
   VoidItem: "void_item"
-}, Z = e.string().enum(V).lock(), vr = V, W = Z, Ze = {
+}, Z = e.string().enum(R).lock(), vr = R, W = Z, Ze = {
   /** 世游通行证 ID / Combo ID */
   UserId: "user_id",
   /** 游戏角色 ID */
@@ -756,12 +760,12 @@ const V = {
   Output: "output",
   /** 玩法参与奖励 */
   Engage: "engage"
-}, U = e.string().enum(at).lock(), st = {
+}, $ = e.string().enum(at).lock(), st = {
   /** 私有队伍 */
   Private: "private",
   /** 公开队伍 */
   Public: "public"
-}, ct = e.string().enum(st).lock(), h = {
+}, ct = e.string().enum(st).lock(), w = {
   /** 未知状态 */
   Unknown: "unknown",
   /** 等待开奖 */
@@ -772,7 +776,7 @@ const V = {
   Claimed: "claimed",
   /** 领奖失败 */
   Fail: "fail"
-}, Vr = e.string().enum(h).lock(), ut = {
+}, Rr = e.string().enum(w).lock(), ut = {
   /** 发起组队 */
   Assemble: "assemble",
   /** 加入队伍 */
@@ -783,14 +787,14 @@ const V = {
   ChangeVisibility: "change_visibility",
   /** 查询组队信息 */
   Query: "query"
-}, Rr = e.string().enum(ut).lock(), lt = {
+}, Vr = e.string().enum(ut).lock(), lt = {
   /** 查询抽奖券 */
   Query: "query",
   /** 开奖 */
   Draw: "draw",
   /** 领奖 */
   Claim: "claim"
-}, jr = e.string().enum(lt).lock(), mt = e.string().enum(C(V, "GiftCode", "LotteryTicket")), $ = e.object({
+}, jr = e.string().enum(lt).lock(), mt = e.string().enum(C(R, "GiftCode", "LotteryTicket")), U = e.object({
   reward_item_id: e.number(),
   reward_amount: e.number(),
   reward_item_name: e.string(),
@@ -800,11 +804,11 @@ const V = {
   reward_item_rating: e.number()
 }).lock(), dt = e.object({
   engage_count: e.number(),
-  rewards: e.array($)
+  rewards: e.array(U)
 }).lock(), gt = e.union(
   e.object({
     feature_reward_type: e.string().enum("every"),
-    reward_details: e.array($)
+    reward_details: e.array(U)
   }),
   e.object({
     feature_reward_type: e.string().enum("regular"),
@@ -832,12 +836,12 @@ const V = {
 }), bt = c.CheckIn, yt = e.object({
   ...u.shape,
   feature_type: e.string().enum(bt)
-}), ft = c.ClaimRewards, wt = e.object({
+}), ft = c.ClaimRewards, ht = e.object({
   ...u.shape,
   feature_type: e.string().enum(ft)
-}), ht = c.Comment, kt = e.object({
+}), wt = c.Comment, kt = e.object({
   ...u.shape,
-  feature_type: e.string().enum(ht),
+  feature_type: e.string().enum(wt),
   config: e.object({
     comments: e.array(e.string()),
     send_rate: e.number()
@@ -852,15 +856,15 @@ const V = {
     qr_code_url: e.string().optional(),
     platform_desc: e.string().optional()
   })
-}), Vt = c.GiftCode, Rt = e.object({
+}), Rt = c.GiftCode, Vt = e.object({
   name: e.string(),
   icon_url: e.string(),
   count: e.number()
 }), jt = e.object({
   ...u.shape,
-  feature_type: e.string().enum(Vt),
+  feature_type: e.string().enum(Rt),
   config: e.object({
-    gift_items: e.array(Rt),
+    gift_items: e.array(Vt),
     mp_url: e.string().optional(),
     mp_qrcode_url: e.string().optional()
   })
@@ -873,7 +877,7 @@ const V = {
 }), xt = c.InvitedRegister, St = e.object({
   ...u.shape,
   feature_type: e.string().enum(xt)
-}), Lt = e.string().enum(C(V, "GiftCode", "LotteryTicket")), Pt = c.Lottery, Et = e.object({
+}), Lt = e.string().enum(C(R, "GiftCode", "LotteryTicket")), Pt = c.Lottery, Et = e.object({
   reward_item_id: e.number(),
   reward_item_name: e.string(),
   reward_item_type: Lt,
@@ -881,7 +885,7 @@ const V = {
   reward_item_desc: e.string().optional(),
   reward_amount: e.number(),
   reward_remaining_stock: e.number()
-}), Ut = e.object({
+}), $t = e.object({
   ...u.shape,
   feature_type: e.string().enum(Pt),
   config: e.object({
@@ -892,9 +896,9 @@ const V = {
     consume_item_desc: e.string().optional(),
     rewards: e.array(Et)
   })
-}), $t = c.LotteryDraw, Ft = e.object({
+}), Ut = c.LotteryDraw, Ft = e.object({
   ...u.shape,
-  feature_type: e.string().enum($t),
+  feature_type: e.string().enum(Ut),
   config: e.object({
     draw_not_before: e.number(),
     draw_not_after: e.number()
@@ -902,7 +906,7 @@ const V = {
 }), Dt = c.Preregister, It = e.object({
   ...u.shape,
   feature_type: e.string().enum(Dt)
-}), Gt = c.Quest, At = e.object({
+}), Gt = c.Quest, Nt = e.object({
   ...u.shape,
   feature_type: e.string().enum(Gt),
   config: e.object({
@@ -913,9 +917,9 @@ const V = {
       completion_value: e.number()
     }).optional()
   })
-}), Ot = c.Register, Nt = e.object({
+}), At = c.Register, Ot = e.object({
   ...u.shape,
-  feature_type: e.string().enum(Ot)
+  feature_type: e.string().enum(At)
 }), Bt = c.Share, Qt = e.object({
   ...u.shape,
   feature_type: e.string().enum(Bt),
@@ -963,22 +967,22 @@ const V = {
     finalists_amount: e.number(),
     source: ot,
     options: e.array(Zt),
-    rewards: e.array($)
+    rewards: e.array(U)
   })
 }), en = e.union(
   _t,
   yt,
-  wt,
+  ht,
   kt,
   Ct,
   jt,
   qt,
   St,
-  Ut,
+  $t,
   Ft,
   It,
-  At,
   Nt,
+  Ot,
   Qt,
   Ht,
   Jt,
@@ -1006,7 +1010,7 @@ const V = {
 }), ne = e.object({
   reward_id: e.number(),
   reward_item_id: e.number(),
-  reward_source: U,
+  reward_source: $,
   reward_item_name: e.string(),
   reward_item_type: Z,
   reward_item_icon_url: e.string(),
@@ -1023,14 +1027,14 @@ const V = {
   // https://kdocs.cn/l/ckWFDcOsYEUA?linkname=merUzJsVYH
   // 后续会格式化为具体的类型，此处的校验需要对应增加
   extra_data: e.record(e.unknown()).optional()
-}), sn = e.string().enum(h.Unknown, h.Pending), cn = e.union(
+}), sn = e.string().enum(w.Unknown, w.Pending), cn = e.union(
   e.object({
     ticket: e.string(),
     status: sn
   }),
   e.object({
     ticket: e.string(),
-    status: e.string().enum(C(h, "Unknown", "Pending")),
+    status: e.string().enum(C(w, "Unknown", "Pending")),
     reward: ne
   })
 ).satisfies(), un = e.object({
@@ -1104,20 +1108,20 @@ const V = {
     "EmptyObject",
     (i) => v(i) && Object.keys(i).length === 0
   )
-).satisfies().lock(), wn = e.object({
+).satisfies().lock(), hn = e.object({
   reward_id: e.number(),
   reward_item_id: e.number(),
   reward_item_type: W,
   reward_count: e.number(),
   reward_status: te,
-  reward_source: U,
+  reward_source: $,
   reward_item_name: e.string(),
   reward_item_icon_url: e.string(),
   reward_item_desc: e.string().optional(),
   reward_item_rating: e.number(),
   receive_time: e.number(),
   extra_data: e.union(...re.validators, e.record(e.unknown())).satisfies().optional()
-}), hn = e.object({
+}), wn = e.object({
   reward_id: e.number(),
   reward_item_id: e.number(),
   reward_item_name: e.string(),
@@ -1126,7 +1130,7 @@ const V = {
   reward_item_desc: e.string().optional(),
   reward_amount: e.number(),
   reward_status: te,
-  reward_source: U,
+  reward_source: $,
   extra_data: e.record(e.unknown()).optional()
 }), ie = e.object({
   engagement_id: e.number(),
@@ -1138,7 +1142,7 @@ const V = {
   server_id: e.string().optional(),
   role_id: e.string().optional(),
   created_at: e.number(),
-  rewards: e.array(wn).optional()
+  rewards: e.array(hn).optional()
 }).lock(), kn = e.object({
   allowed: e.bool(),
   registered: e.bool()
@@ -1156,12 +1160,12 @@ const V = {
     role_id: e.string(),
     data: ie.clone().optional()
   }).optional(),
-  rewards: e.array(hn).optional(),
+  rewards: e.array(wn).optional(),
   scan: e.bool().optional()
-}), Vn = e.object({
+}), Rn = e.object({
   reward_id: e.number(),
   reward_status: E
-}), Rn = e.guard(tn), jn = e.guard(kn), x = o({ count: e.number() }), Tn = o({ first_visit: e.bool() }), qn = o({
+}), Vn = e.guard(tn), jn = e.guard(kn), x = o({ count: e.number() }), Tn = o({ first_visit: e.bool() }), qn = o({
   engagements: e.union(e.array(fn), e.array(_n))
 }), xn = o({
   status: e.array(vn)
@@ -1169,13 +1173,13 @@ const V = {
   engagements: e.array(ie),
   next_token: e.string().optional()
 }), Ln = e.guard(Cn), Pn = o({
-  claimed_items: e.array(Vn)
+  claimed_items: e.array(Rn)
 }), En = o({
   reward_status: E
-}), Un = o({
+}), $n = o({
   user_rewards: e.array(ne),
   next_token: e.string().optional()
-}), $n = o({
+}), Un = o({
   scene: e.string()
 }), Fn = o({
   params: e.string()
@@ -1206,7 +1210,7 @@ class qr {
    * https://kdocs.cn/l/ckWFDcOsYEUA?linkname=wFXxtdNKPm
    */
   async getConfig() {
-    const { data: t } = await this.req.get(`event/${this.event}/event-config`, Rn);
+    const { data: t } = await this.req.get(`event/${this.event}/event-config`, Vn);
     return t;
   }
   /**
@@ -1361,7 +1365,7 @@ class qr {
     const { data: n } = await this.req.post(
       "event/user-rewards",
       a({ max_results: 20, ...t, event_id: this.event }),
-      Un
+      $n
     );
     return {
       user_rewards: ((n == null ? void 0 : n.user_rewards) || []).map((r) => (r.reward_status = r.reward_status === _.UnclaimedErr ? _.Unclaimed : r.reward_status, r)),
@@ -1399,7 +1403,7 @@ class qr {
    */
   async getUnlimitQrcodeScene(t) {
     if (!await this.token.autoLogin()) return null;
-    const { data: n } = await this.req.get("event/unlimit-qrcode-scene", $n, {
+    const { data: n } = await this.req.get("event/unlimit-qrcode-scene", Un, {
       params: { params: t }
     });
     return (n == null ? void 0 : n.scene) ?? null;
@@ -1433,7 +1437,7 @@ const In = {
   All: "all",
   /** 指定用户可发帖 */
   Limit: "limit"
-}, Gn = e.string().enum(In).lock(), An = {
+}, Gn = e.string().enum(In).lock(), Nn = {
   /** 待审核（仅自己可见） */
   Pending: "pending",
   /** 审核通过 */
@@ -1442,14 +1446,14 @@ const In = {
   Failed: "failed",
   /** 嫌疑（仅自己可见） */
   Suspect: "suspect"
-}, oe = e.string().enum(An).lock(), On = {
+}, oe = e.string().enum(Nn).lock(), An = {
   /** 系统通知 */
   System: "system",
   /** 评论我的 */
   Comment: "comment",
   /** 点赞通知 */
   Like: "like"
-}, xr = e.string().enum(On).lock(), m = {
+}, xr = e.string().enum(An).lock(), m = {
   /** 系统通知 */
   System: "system",
   /** 帖子被置顶 */
@@ -1474,7 +1478,7 @@ const In = {
   ReplyLiked: "reply_liked",
   /** 回复被删除 */
   ReplyDeleted: "reply_deleted"
-}, Nn = e.string().enum(m).lock(), ae = e.object({
+}, On = e.string().enum(m).lock(), ae = e.object({
   forum_id: e.number(),
   icon_url: e.string(),
   name: e.string(),
@@ -1516,7 +1520,7 @@ const In = {
   replied_by: e.string(),
   nickname: e.string(),
   avatar_url: e.string()
-}).lock(), R = e.object({
+}).lock(), V = e.object({
   reply_id: e.number(),
   comment_id: e.number(),
   comment_content: e.string().optional(),
@@ -1550,14 +1554,14 @@ const In = {
   image_url: e.string(),
   create_time: e.number(),
   status: oe,
-  replies: e.array(R).optional()
+  replies: e.array(V).optional()
 }).lock(), Qn = e.object({
   image_url: e.string(),
   upload_url: e.string(),
   existed: e.bool()
 }).lock(), y = e.object({
   notification_id: e.string(),
-  notification_type: Nn,
+  notification_type: On,
   is_read: e.bool(),
   create_time: e.number(),
   origin_user_id: e.string(),
@@ -1629,10 +1633,10 @@ const In = {
   posts: e.array(D),
   next_token: e.string().optional()
 }), ir = o({ post: D, antispam: se }), or = o({
-  replies: e.array(R),
+  replies: e.array(V),
   next_token: e.string().optional()
-}), ar = o({ reply: R }), sr = o({
-  reply: R.clone().optional(),
+}), ar = o({ reply: V }), sr = o({
+  reply: V.clone().optional(),
   antispam: se.clone().optional()
 }), cr = o({ comment: k }), ur = o({
   comments: e.array(k),
@@ -1892,9 +1896,12 @@ class Lr {
    */
   constructor(t, n) {
     l(this, "token");
-    l(this, "appid");
+    l(this, "$appid");
     l(this, "req");
-    this.token = t, this.req = t.req, this.appid = n, this.getLoginCache();
+    this.token = t, this.req = t.req, this.$appid = n, this.getLoginCache();
+  }
+  get appid() {
+    return this.$appid;
   }
   /**
    * 检查缓存中的登录数据
@@ -1933,7 +1940,7 @@ class Lr {
     const t = await this.getLoginCache();
     if (t)
       return t;
-    const n = await we(), { data: r, code: s } = await this.req.post(
+    const n = await he(), { data: r, code: s } = await this.req.post(
       "weixin/login",
       { code: n, appid: this.appid },
       S,
@@ -1960,7 +1967,7 @@ class Lr {
   async webLogin(t = "snsapi_userinfo") {
     const n = L("code"), r = Date.now(), s = +L("state");
     if (!n || !s || s < r - 1e3 * 60 * 5 || s > r) {
-      const ue = A(["code", "state"]);
+      const ue = N(["code", "state"]);
       location.replace(
         `https://open.weixin.qq.com/connect/oauth2/authorize?appid=${this.appid}&redirect_uri=${encodeURIComponent(ue)}&response_type=code&scope=${t}&state=${r}#wechat_redirect`
       );
@@ -1968,7 +1975,7 @@ class Lr {
     }
     if (/^100\d{2}$/.test(n))
       return { error: n };
-    const d = A(["code", "state"]);
+    const d = N(["code", "state"]);
     "replaceState" in history && history.replaceState({}, "", d);
     const { data: p, code: ce } = await this.req.post(
       "weixin/login",
@@ -2019,19 +2026,19 @@ class Lr {
 }
 export {
   se as AntispamValidator,
-  wr as AuthToken,
+  hr as AuthToken,
   nn as CashbackEngagementDataValidator,
   _ as ClaimRewardStatus,
   E as ClaimRewardStatusValidator,
-  Vn as ClaimedItemValidator,
+  Rn as ClaimedItemValidator,
   K as ClubAddressValidator,
   kr as ClubApi,
   X as ClubBenefitSummaryValidator,
   Ge as ClubBenefitValidator,
   je as ClubCreditChangeScene,
   Te as ClubCreditChangeSceneValidator,
-  Ve as ClubCreditChangeType,
-  Re as ClubCreditChangeTypeValidator,
+  Re as ClubCreditChangeType,
+  Ve as ClubCreditChangeTypeValidator,
   Ie as ClubCreditLogValidator,
   Le as ClubGlobalConfigValidator,
   qe as ClubItemType,
@@ -2048,22 +2055,22 @@ export {
   Ze as EngageAccountType,
   We as EngageAccountTypeValidator,
   Cn as EngageResponseValidator,
-  hn as EngageRewardValidator,
+  wn as EngageRewardValidator,
   qr as EventApi,
   tn as EventConfigValidator,
   _t as EventFeatureConfigOfCashbackValidator,
   yt as EventFeatureConfigOfCheckInValidator,
-  wt as EventFeatureConfigOfClaimRewardsValidator,
+  ht as EventFeatureConfigOfClaimRewardsValidator,
   kt as EventFeatureConfigOfCommentValidator,
   Ct as EventFeatureConfigOfFollowValidator,
   jt as EventFeatureConfigOfGiftCodeValidator,
   qt as EventFeatureConfigOfInviteValidator,
   St as EventFeatureConfigOfInvitedRegisterValidator,
   Ft as EventFeatureConfigOfLotteryDrawValidator,
-  Ut as EventFeatureConfigOfLotteryValidator,
+  $t as EventFeatureConfigOfLotteryValidator,
   It as EventFeatureConfigOfPreregisterValidator,
-  At as EventFeatureConfigOfQuestValidator,
-  Nt as EventFeatureConfigOfRegisterValidator,
+  Nt as EventFeatureConfigOfQuestValidator,
+  Ot as EventFeatureConfigOfRegisterValidator,
   Qt as EventFeatureConfigOfShareValidator,
   Ht as EventFeatureConfigOfSubscribeValidator,
   Jt as EventFeatureConfigOfSurveyValidator,
@@ -2072,16 +2079,16 @@ export {
   en as EventFeatureConfigValidator,
   et as EventPeriodType,
   tt as EventPeriodTypeValidator,
-  $ as EventRewardItemConfigValidator,
-  Oe as ExtraGameRewardValidator,
-  Ae as ExtraPhysicalShipmentValidator,
+  U as EventRewardItemConfigValidator,
+  Ae as ExtraGameRewardValidator,
+  Ne as ExtraPhysicalShipmentValidator,
   gt as FeatureRewardValidator,
   c as FeatureType,
   nt as FeatureTypeValidator,
   In as ForumMode,
   Gn as ForumModeValidator,
   ae as ForumValidator,
-  V as GamerItemType,
+  R as GamerItemType,
   Z as GamerItemTypeValidator,
   ve as Gender,
   Ce as GenderValidator,
@@ -2091,10 +2098,10 @@ export {
   jr as LotteryDrawActionValidator,
   un as LotteryDrawEngagementDataValidator,
   an as LotteryEngagementDataValidator,
-  h as LotteryTicketStatus,
-  Vr as LotteryTicketStatusValidator,
+  w as LotteryTicketStatus,
+  Rr as LotteryTicketStatusValidator,
   y as NotificationBaseValidator,
-  On as NotificationCategory,
+  An as NotificationCategory,
   xr as NotificationCategoryValidator,
   Kn as NotificationCommentReplyValidator,
   Xn as NotificationCommentValidator,
@@ -2108,11 +2115,11 @@ export {
   Zn as NotificationReplyValidator,
   Hn as NotificationSystemValidator,
   m as NotificationType,
-  Nn as NotificationTypeValidator,
+  On as NotificationTypeValidator,
   Wn as NotificationValidator,
-  $e as PlayerRoleCardValidator,
+  Ue as PlayerRoleCardValidator,
   J as PlayerRoleValidator,
-  An as PostStatus,
+  Nn as PostStatus,
   oe as PostStatusValidator,
   D as PostValidator,
   ln as PreregisterEngagementDataValidator,
@@ -2120,26 +2127,26 @@ export {
   mn as QuestEngagementDataValidator,
   rt as QuestObjective,
   ee as QuestObjectiveValidator,
-  hr as RedeemParamsValidator,
-  Ne as RedemptionValidator,
+  wr as RedeemParamsValidator,
+  Oe as RedemptionValidator,
   dt as RegularRewardValidator,
   Bn as ReplyToValidator,
-  R as ReplyValidator,
+  V as ReplyValidator,
   vr as RewardItemType,
   W as RewardItemTypeValidator,
   at as RewardSource,
-  U as RewardSourceValidator,
+  $ as RewardSourceValidator,
   g as RewardStatus,
   P as RewardStatusSuffix,
   te as RewardStatusSuffixValidator,
   Cr as RewardStatusValidator,
-  wn as RewardValidator,
-  Ue as RoleBaseInfoValidator,
+  hn as RewardValidator,
+  $e as RoleBaseInfoValidator,
   Ee as ServerBaseInfoValidator,
   dn as ShareEngagementDataValidator,
   pn as SurveyEngagementDataValidator,
   ut as TeamAction,
-  Rr as TeamActionValidator,
+  Vr as TeamActionValidator,
   bn as TeamEngagementDataValidator,
   _n as TeamEngagementValidator,
   Tr as TeamMemberValidator,

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@seayoo-web/gamer-api",
   "description": "agent for gamer api",
-  "version": "2.0.15",
+  "version": "2.0.17",
   "type": "module",
   "source": "index.ts",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./types/index.d.ts",
+  "sideEffects": false,
   "files": [
     "dist",
     "types",
@@ -22,16 +23,16 @@
   "license": "MIT",
   "devDependencies": {
     "@types/node": "^22.13.1",
-    "@seayoo-web/combo-webview": "^2.5.3",
-    "@seayoo-web/request": "^3.0.3",
-    "@seayoo-web/scripts": "^2.0.4",
+    "@seayoo-web/combo-webview": "^2.5.4",
+    "@seayoo-web/utils": "^3.5.1",
+    "@seayoo-web/request": "^3.0.4",
     "@seayoo-web/tsconfig": "^1.0.3",
-    "@seayoo-web/utils": "^3.4.4"
+    "@seayoo-web/scripts": "^2.1.0"
   },
   "peerDependencies": {
-    "@seayoo-web/combo-webview": "^2.5.3",
-    "@seayoo-web/request": "^3.0.3",
-    "@seayoo-web/utils": "^3.4.4"
+    "@seayoo-web/request": "^3.0.4",
+    "@seayoo-web/utils": "^3.5.1",
+    "@seayoo-web/combo-webview": "^2.5.4"
   },
   "scripts": {
     "prebuild": "pnpm -F request build && pnpm -F combo-webview build",

package/types/src/token.d.ts

@@ -1,4 +1,4 @@
-import type { StorageHelper } from "./utils";
+import { type StorageHelper } from "./utils";
 import type { NetRequestFactory } from "@seayoo-web/request";
 export * from "./token.define";
 /**
@@ -11,82 +11,83 @@ export * from "./token.define";
  * - [Weixin Token](https://kdocs.cn/l/cf2mO2uRLqh9?linkname=YtzQpmRQ0v)
  */
 export declare class AuthToken {
-  private $idToken;
-  private $weixinToken;
-  private $gamerToken;
-  req: ReturnType<NetRequestFactory>;
-  storage: StorageHelper;
-  constructor(
+    private $NetRequest;
+    private $idToken;
+    private $weixinToken;
+    private $gamerToken;
+    req: ReturnType<NetRequestFactory>;
+    storage: StorageHelper;
+    constructor(
     /**
      * 服务端点
      *
      * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=k2iGGXbfov
      */
-    endpoint: string,
+    endpoint: string, 
     /** request 工具类 */
-    NetRequest: NetRequestFactory,
-  );
-  private loadGamerTokenCache;
-  /** 当前是否为登录状态，即是否拥有 gamerToken */
-  get isLoggedIn(): boolean;
-  /** 读取已经设置的 idToken */
-  get idToken(): string;
-  /** 设置从登录组件获取的 Id Token，用于后续请求自动置换 Gamer Token */
-  set idToken(value: string);
-  /** 读取设置 weixinToken */
-  get weixinToken(): string;
-  /**
-   * 设置 Weixin Token，用于后续请求自动置换 Gamer Token
-   *
-   * 仅仅在微信小程序模式下有效
-   */
-  set weixinToken(value: string);
-  /** 读取自动置换的 gamerToken */
-  get gamerToken(): string;
-  /**
-   * 直接写入 Gamer Token，并更新缓存
-   */
-  set gamerToken(value: string);
-  /**
-   * 退出登录，销毁相关 Token
-   */
-  logout(): void;
-  /**
-   * 用世游通行证统一登录能力签发的 ID Token / Weixin Token，自动置换 Gamer Token，成功后会自动设置后续 Request Headers
-   *
-   * [世游通行证统一登录](https://kdocs.cn/l/cf2mO2uRLqh9?linkname=FJXYgqvLHs)
-   *
-   * [世游通行证统一登录 - Web 站点](https://365.kdocs.cn/l/cf57sp1qLlZh)
-   *
-   * [世游通行证统一登录 - 微信小程序](https://365.kdocs.cn/l/ccHVuUs0UsZs)
-   *
-   * - 此方法通常不需要手动调用，在需要登录的接口调用时会自动执行
-   * - 为了提高页面执行速度，可以在设置 Token 后立即调用 autoLogin
-   *
-   * 🔕请求静默进行，无消息提示
-   *
-   * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=ReeJpWraRO
-   */
-  autoLogin(): Promise<boolean>;
-  /**
-   * 获取当前登录用户的 Session 的信息
-   *
-   * 🔕请求静默进行，无消息提示
-   *
-   * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=OdGVCdQxEu
-   */
-  getSession(): Promise<import("./token.define").GamerSession | null>;
-  /**
-   * 实名认证
-   *
-   * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=kZYnwX6RcF
-   */
-  authRealName(option: {
-    /** 用户输入的真实姓名。明文或者密文 */
-    real_name: string;
-    /** 用户输入的身份证号码。明文或者密文 */
-    identity_card: string;
-    /** 预留参数，是否加密 real_name 和 identity_card，加密的密钥应当使用 api 服务的 ECDSA Public Key */
-    encrypted?: boolean;
-  }): Promise<import("./token.define").GamerSession | null>;
+    NetRequest: NetRequestFactory);
+    get NetRequest(): typeof import("@seayoo-web/request").NetRequest;
+    private loadGamerTokenCache;
+    /** 当前是否为登录状态，即是否拥有 gamerToken */
+    get isLoggedIn(): boolean;
+    /** 读取已经设置的 idToken */
+    get idToken(): string;
+    /** 设置从登录组件获取的 Id Token，用于后续请求自动置换 Gamer Token */
+    set idToken(value: string);
+    /** 读取设置 weixinToken */
+    get weixinToken(): string;
+    /**
+     * 设置 Weixin Token，用于后续请求自动置换 Gamer Token
+     *
+     * 仅仅在微信小程序模式下有效
+     */
+    set weixinToken(value: string);
+    /** 读取自动置换的 gamerToken */
+    get gamerToken(): string;
+    /**
+     * 直接写入 Gamer Token，并更新缓存
+     */
+    set gamerToken(value: string);
+    /**
+     * 退出登录，销毁相关 Token
+     */
+    logout(): void;
+    /**
+     * 用世游通行证统一登录能力签发的 ID Token / Weixin Token，自动置换 Gamer Token，成功后会自动设置后续 Request Headers
+     *
+     * [世游通行证统一登录](https://kdocs.cn/l/cf2mO2uRLqh9?linkname=FJXYgqvLHs)
+     *
+     * [世游通行证统一登录 - Web 站点](https://365.kdocs.cn/l/cf57sp1qLlZh)
+     *
+     * [世游通行证统一登录 - 微信小程序](https://365.kdocs.cn/l/ccHVuUs0UsZs)
+     *
+     * - 此方法通常不需要手动调用，在需要登录的接口调用时会自动执行
+     * - 为了提高页面执行速度，可以在设置 Token 后立即调用 autoLogin
+     *
+     * 🔕请求静默进行，无消息提示
+     *
+     * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=ReeJpWraRO
+     */
+    autoLogin(): Promise<boolean>;
+    /**
+     * 获取当前登录用户的 Session 的信息
+     *
+     * 🔕请求静默进行，无消息提示
+     *
+     * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=OdGVCdQxEu
+     */
+    getSession(): Promise<import("./token.define").GamerSession | null>;
+    /**
+     * 实名认证
+     *
+     * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=kZYnwX6RcF
+     */
+    authRealName(option: {
+        /** 用户输入的真实姓名。明文或者密文 */
+        real_name: string;
+        /** 用户输入的身份证号码。明文或者密文 */
+        identity_card: string;
+        /** 预留参数，是否加密 real_name 和 identity_card，加密的密钥应当使用 api 服务的 ECDSA Public Key */
+        encrypted?: boolean;
+    }): Promise<import("./token.define").GamerSession | null>;
 }

package/types/src/weixin.d.ts

@@ -1,104 +1,97 @@
-import type { WeixinWebLoginErrorCode } from "./weixin.define";
+import { type WeixinWebLoginErrorCode } from "./weixin.define";
 import type { AuthToken } from "./token";
 import type { RequestInternalError } from "@seayoo-web/request";
 export * from "./weixin.define";
 export declare class WeixinApi {
-  private token;
-  private appid;
-  private req;
-  /**
-   * 创建微信相关功能接口
-   *
-   * - authToken 需要导入 AuthToken 进行初始化后传入
-   * - appid 可以静态设置，也可以在小程序中动态获取，见下示例代码
-   *
-   * ```js
-   * const info = wx.getAccountInfoSync();
-   * console.log(info.miniProgram.appId)
-   * ```
-   *
-   * https://developers.weixin.qq.com/miniprogram/dev/api/open-api/account-info/wx.getAccountInfoSync.html
-   */
-  constructor(authToken: AuthToken, appid: string);
-  /**
-   * 检查缓存中的登录数据
-   *
-   * 如果没有缓存或缓存数据错误，则需要调用 [wx.login](https://developers.weixin.qq.com/miniprogram/dev/api/open-api/login/wx.login.html) 后调用 login 方法
-   *
-   * 也可以直接调用 login 方法，并传入 weixin code 的读取函数
-   */
-  getLoginCache(): Promise<import("./weixin.define").WeixinLoginResponse | null>;
-  /**
-   * 小程序页面微信静默登录，获取 weixinToken / open_id / union_id。
-   *
-   * 使用场景：
-   *
-   * - 小程序的任意页面打开后应该优先调用此方法以获取登录状态
-   *
-   * 注意：
-   *
-   * - 登录成功后会将登录信息缓存到本地，重复或并发调用不会引起任何副作用。
-   * - 由于小程序的存储是以用户维度隔离的，每个微信用户在每个小程序下只要成功调用一次此 API 就会缓存请求结果。
-   * - 微信公众号网页授权请使用 webLogin 方法
-   *
-   * 🔕请求静默进行，无消息提示
-   *
-   * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=GwIZ0givCb
-   */
-  login(): Promise<
-    | import("./weixin.define").WeixinLoginResponse
-    | {
+    private token;
+    private $appid;
+    private req;
+    /**
+     * 创建微信相关功能接口
+     *
+     * - authToken 需要导入 AuthToken 进行初始化后传入
+     * - appid 可以静态设置，也可以在小程序中动态获取，见下示例代码
+     *
+     * ```js
+     * const info = wx.getAccountInfoSync();
+     * console.log(info.miniProgram.appId)
+     * ```
+     *
+     * https://developers.weixin.qq.com/miniprogram/dev/api/open-api/account-info/wx.getAccountInfoSync.html
+     */
+    constructor(authToken: AuthToken, appid: string);
+    get appid(): string;
+    /**
+     * 检查缓存中的登录数据
+     *
+     * 如果没有缓存或缓存数据错误，则需要调用 [wx.login](https://developers.weixin.qq.com/miniprogram/dev/api/open-api/login/wx.login.html) 后调用 login 方法
+     *
+     * 也可以直接调用 login 方法，并传入 weixin code 的读取函数
+     */
+    getLoginCache(): Promise<import("./weixin.define").WeixinLoginResponse | null>;
+    /**
+     * 小程序页面微信静默登录，获取 weixinToken / open_id / union_id。
+     *
+     * 使用场景：
+     *
+     * - 小程序的任意页面打开后应该优先调用此方法以获取登录状态
+     *
+     * 注意：
+     *
+     * - 登录成功后会将登录信息缓存到本地，重复或并发调用不会引起任何副作用。
+     * - 由于小程序的存储是以用户维度隔离的，每个微信用户在每个小程序下只要成功调用一次此 API 就会缓存请求结果。
+     * - 微信公众号网页授权请使用 webLogin 方法
+     *
+     * 🔕请求静默进行，无消息提示
+     *
+     * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=GwIZ0givCb
+     */
+    login(): Promise<import("./weixin.define").WeixinLoginResponse | {
         error: RequestInternalError | "invalid_weixin_appid" | "invalid_weixin_code";
-      }
-  >;
-  /**
-   * 在微信内嵌网页中调用微信公众号授权登录【暂未启用】
-   *
-   * 注意：
-   *
-   * - 登录回调地址强制是当前页面，包括 location search 和 location hash 部分
-   * - 登录跳转返回 code 后，会将 code 从 url 中删除以防止 code 泄露，如需设置分享则需要在此方法执行完毕之后
-   *
-   * 官方参考资料：
-   *
-   * - [微信网页开发 / 网页授权](https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html)
-   *
-   * @param scope - 网页授权作用域
-   *  - snsapi_base 不弹出授权页面，用户无感知，只能获取用户 openid，如果需要获取 union_id 则需要 snsapi_userinfo
-   *  - snsapi_userinfo 【默认】弹出授权页面，可拿到 openid、union_id、昵称、头像等信息，但用户也可能会拒绝授权
-   */
-  webLogin(scope?: "snsapi_base" | "snsapi_userinfo"): Promise<
-    | import("./weixin.define").WeixinLoginResponse
-    | {
+    }>;
+    /**
+     * 在微信内嵌网页中调用微信公众号授权登录【暂未启用】
+     *
+     * 注意：
+     *
+     * - 登录回调地址强制是当前页面，包括 location search 和 location hash 部分
+     * - 登录跳转返回 code 后，会将 code 从 url 中删除以防止 code 泄露，如需设置分享则需要在此方法执行完毕之后
+     *
+     * 官方参考资料：
+     *
+     * - [微信网页开发 / 网页授权](https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html)
+     *
+     * @param scope - 网页授权作用域
+     *  - snsapi_base 不弹出授权页面，用户无感知，只能获取用户 openid，如果需要获取 union_id 则需要 snsapi_userinfo
+     *  - snsapi_userinfo 【默认】弹出授权页面，可拿到 openid、union_id、昵称、头像等信息，但用户也可能会拒绝授权
+     */
+    webLogin(scope?: "snsapi_base" | "snsapi_userinfo"): Promise<import("./weixin.define").WeixinLoginResponse | {
         error: WeixinWebLoginErrorCode;
-      }
-    | {
+    } | {
         error: RequestInternalError | "invalid_weixin_appid" | "invalid_weixin_code";
-      }
-    | undefined
-  >;
-  /**
-   * 关联游戏账号，无返回值，全程静默
-   *
-   * 用于从游戏内跳转至小程序时，将微信用户身份和游戏内身份关联起来，使得后续的企业微信客服流程能够知道该微信用户在游戏内的身份。
-   *
-   * 🔕请求静默进行，无消息提示
-   *
-   * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=ci73N833Mk
-   *
-   * @param weixinToken 调用 login 后，得到的 weixinToken，如果 weixinToken 为空则跳过不处理
-   * @param gameCode 从游戏内跳转至小程序时，通过请求参数 query 携带的 game_code，如果值为空则跳过不处理
-   */
-  linkPlayer(weixinToken: string, gameCode: string): Promise<void>;
-  /**
-   * 获取集成 JSSDK 所需的签名信息
-   *
-   * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=CuWOqxr9Ue
-   */
-  getJSSDKConfig(): Promise<{
-    appid: string;
-    nonceStr: string;
-    timestamp: number;
-    signature: string;
-  } | null>;
+    } | undefined>;
+    /**
+     * 关联游戏账号，无返回值，全程静默
+     *
+     * 用于从游戏内跳转至小程序时，将微信用户身份和游戏内身份关联起来，使得后续的企业微信客服流程能够知道该微信用户在游戏内的身份。
+     *
+     * 🔕请求静默进行，无消息提示
+     *
+     * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=ci73N833Mk
+     *
+     * @param weixinToken 调用 login 后，得到的 weixinToken，如果 weixinToken 为空则跳过不处理
+     * @param gameCode 从游戏内跳转至小程序时，通过请求参数 query 携带的 game_code，如果值为空则跳过不处理
+     */
+    linkPlayer(weixinToken: string, gameCode: string): Promise<void>;
+    /**
+     * 获取集成 JSSDK 所需的签名信息
+     *
+     * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=CuWOqxr9Ue
+     */
+    getJSSDKConfig(): Promise<{
+        appid: string;
+        nonceStr: string;
+        timestamp: number;
+        signature: string;
+    } | null>;
 }