@seayoo-web/gamer-api 2.4.2 → 2.4.4

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@seayoo-web/gamer-api",
   "description": "agent for gamer api",
-  "version": "2.4.2",
+  "version": "2.4.4",
   "type": "module",
   "source": "index.ts",
   "main": "./dist/index.js",
@@ -30,15 +30,15 @@
   "license": "MIT",
   "devDependencies": {
     "@types/node": "^22.13.1",
-    "@seayoo-web/request": "^3.2.0",
-    "@seayoo-web/combo-webview": "^2.5.4",
     "@seayoo-web/tsconfig": "^1.0.4",
-    "@seayoo-web/utils": "^3.5.2",
-    "@seayoo-web/scripts": "^2.5.7"
+    "@seayoo-web/combo-webview": "^2.5.4",
+    "@seayoo-web/request": "^3.2.0",
+    "@seayoo-web/scripts": "^2.5.7",
+    "@seayoo-web/utils": "^3.6.0"
   },
   "peerDependencies": {
     "@seayoo-web/combo-webview": "^2.5.4",
-    "@seayoo-web/utils": "^3.5.2"
+    "@seayoo-web/utils": "^3.6.0"
   },
   "scripts": {
     "prebuild": "pnpm -F request build && pnpm -F combo-webview build",

package/types/src/club.d.ts

@@ -21,6 +21,7 @@ export declare class ClubApi {
      * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=hIDfaMlT7m
      */
     getCurrentPlayer(requestOptions?: IRequestOptions): Promise<import("./club.define").ClubPlayer | {
+        message: string;
         error: RequestInternalError | "seayoo_account_already_deleted" | "player_not_found";
     }>;
     /**
@@ -29,6 +30,7 @@ export declare class ClubApi {
      * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=Dpb9JAKqzG
      */
     linkPlayer(requestOptions?: IRequestOptions): Promise<import("./club.define").ClubPlayer | {
+        message: string;
         error: RequestInternalError | "seayoo_user_id_has_combo_id" | "combo_id_has_seayoo_user_id";
     }>;
     /**
@@ -71,6 +73,7 @@ export declare class ClubApi {
      * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=Qt822A57jd
      */
     updateUserProfile(option: ClubUserProfile, requestOptions?: IRequestOptions): Promise<ClubUserProfile | {
+        message: string;
         error: RequestInternalError | "player_not_found" | "sensitive_nickname" | "sensitive_bio" | "sensitive_avatar";
     }>;
     /**
@@ -91,6 +94,7 @@ export declare class ClubApi {
      * https://kdocs.cn/l/cgp4gSBMbOf1?linkname=p9FlJhHnWN
      */
     updateAddress(option: SomePartial<ClubAddress, "is_default">, requestOptions?: IRequestOptions): Promise<ClubAddress | {
+        message: string;
         error: RequestInternalError | "address_not_found";
     }>;
     /**
@@ -112,6 +116,7 @@ export declare class ClubApi {
         /** 游戏账号 ID，游戏外必传 */
         player_id?: string;
     }, requestOptions?: IRequestOptions): Promise<import("./club.define").ClubUserCredit | {
+        message: string;
         error: RequestInternalError | "player_not_found";
     }>;
     /**
@@ -172,6 +177,7 @@ export declare class ClubApi {
         /** 游戏账号 ID，游戏外必传 */
         player_id?: string;
     }, requestOptions?: IRequestOptions): Promise<true | {
+        message: string;
         error: RequestInternalError | "mall_product_not_found" | "credit_not_found" | "role_not_found" | "player_level_not_enough" | "credit_balance_not_enough" | "redeem_product_quantity_exceeds_limit" | "redeem_quantity_over_stock" | "redeem_quantity_over_daily_limit" | "redeem_quantity_over_month_limit" | "redeem_quantity_over_year_limit" | "redeem_quantity_over_total_limit" | "club_redeem_condition_dissatisfied";
     }>;
     /**

package/types/src/community.d.ts

@@ -60,6 +60,7 @@ export declare class CommunityApi {
         posts: import("./community.define").Post[];
         next_token: string | undefined;
     } | {
+        message: string;
         error: RequestInternalError | "forum_not_found" | "topic_not_found";
     }>;
     /**
@@ -71,6 +72,7 @@ export declare class CommunityApi {
         posts: import("./community.define").Post[];
         next_token: string | undefined;
     } | {
+        message: string;
         error: RequestInternalError | "forum_not_found";
     }>;
     /**
@@ -79,6 +81,7 @@ export declare class CommunityApi {
      * https://kdocs.cn/l/cbggfJodHLIz?linkname=hj1AZy5rcP
      */
     getPost(postId: number, requestOptions?: IRequestOptions): Promise<import("./community.define").Post | {
+        message: string;
         error: RequestInternalError | "post_deleted";
     }>;
     /**
@@ -96,6 +99,7 @@ export declare class CommunityApi {
         post: import("./community.define").Post;
         antispam: import("./community.define").Antispam;
     } | {
+        message: string;
         error: RequestInternalError | "post_body_too_long" | "post_subject_too_long" | "post_tag_already_exists" | "moderation_check_text_error" | "moderation_check_image_error" | "unknown_moderation_suggestion" | "invalid_content_length" | "forum_disabled" | "not_allowed_to_post" | "please_real_name" | "post_tag_not_exists";
     }>;
     /**
@@ -116,6 +120,7 @@ export declare class CommunityApi {
         comments: import("./community.define").Comment[];
         next_token: string | undefined;
     } | {
+        message: string;
         error: RequestInternalError | "post_not_found" | "post_deleted";
     }>;
     /**
@@ -124,6 +129,7 @@ export declare class CommunityApi {
      * https://kdocs.cn/l/cbggfJodHLIz?linkname=RIc7oxVGae
      */
     getComment(commentId: number, requestOptions?: IRequestOptions): Promise<import("./community.define").Comment | {
+        message: string;
         error: RequestInternalError | "comment_not_found" | "comment_deleted";
     }>;
     /**
@@ -142,6 +148,7 @@ export declare class CommunityApi {
         comment: import("./community.define").Comment | undefined;
         antispam: import("./community.define").Comment | undefined;
     } | {
+        message: string;
         error: RequestInternalError | "moderation_check_text_error" | "moderation_check_image_error" | "unknown_moderation_suggestion" | "invalid_content_length" | "forum_disabled" | "post_not_found" | "post_already_deleted";
     }>;
     /**
@@ -160,9 +167,7 @@ export declare class CommunityApi {
         next_token?: string;
     }, requestOptions?: IRequestOptions): Promise<{
         replies: import("./community.define").Reply[];
-        next_token: string | undefined;
-    } | {
-        replies: never[];
+        next_token: string;
     }>;
     /**
      * 根据回复 id 获取回复详情
@@ -170,6 +175,7 @@ export declare class CommunityApi {
      * https://kdocs.cn/l/cbggfJodHLIz?linkname=kxhcSXD3MG
      */
     getReply(replyId: number, requestOptions?: IRequestOptions): Promise<import("./community.define").Reply | {
+        message: string;
         error: RequestInternalError | "reply_not_found" | "reply_deleted";
     }>;
     /**
@@ -188,6 +194,7 @@ export declare class CommunityApi {
         reply: import("./community.define").Reply | undefined;
         antispam: import("./community.define").Antispam | undefined;
     } | {
+        message: string;
         error: RequestInternalError | "moderation_check_text_error" | "moderation_check_image_error" | "comment_not_found" | "comment_deleted" | "reply_not_found" | "reply_deleted";
     }>;
     /**
@@ -201,6 +208,7 @@ export declare class CommunityApi {
         /** 目标 ID */
         target_id: number;
     }, requestOptions?: IRequestOptions): Promise<true | {
+        message: string;
         error: RequestInternalError | "post_not_found" | "post_deleted" | "comment_not_found" | "comment_deleted" | "reply_not_found" | "reply_deleted";
     }>;
     /**
@@ -214,6 +222,7 @@ export declare class CommunityApi {
         /** 目标 ID */
         target_id: number;
     }, requestOptions?: IRequestOptions): Promise<true | {
+        message: string;
         error: RequestInternalError | "post_not_found" | "post_deleted" | "comment_not_found" | "comment_deleted" | "reply_not_found" | "reply_deleted";
     }>;
     /**
@@ -247,9 +256,7 @@ export declare class CommunityApi {
         next_token?: string;
     }, requestOptions?: IRequestOptions): Promise<{
         notifications: (import("./community.define").NotificationSystem | import("./community.define").NotificationPost | import("./community.define").NotificationPostComment | import("./community.define").NotificationCommentReply | import("./community.define").NotificationComment | import("./community.define").NotificationReplyReplied | import("./community.define").NotificationReply)[];
-        next_token: string | undefined;
-    } | {
-        notifications: never[];
+        next_token: string;
     }>;
     /**
      * 获取用户未读通知数量

package/types/src/event.d.ts

@@ -57,6 +57,7 @@ export declare class EventApi {
     }, requestOptions?: IRequestOptions): Promise<{
         first_visit: boolean;
     } | {
+        message: string;
         error: RequestInternalError | "event_not_found" | "feature_not_found" | "invalid_server_id" | "invalid_role_id";
     }>;
     /**
@@ -95,7 +96,7 @@ export declare class EventApi {
          * 当玩法的 engage_account_type 为 role_id 时，可提供 server_id 和 role_id 获取具体角色的参与记录
          */
         role_id?: string;
-    }, requestOptions?: IRequestOptions): Promise<never[] | {
+    }, requestOptions?: IRequestOptions): Promise<{
         engagements: import("./event.engage").UserEngagement[];
         next_token: string;
     }>;
@@ -120,6 +121,7 @@ export declare class EventApi {
         role_id?: string;
         role_name?: string;
     }, requestOptions?: IRequestOptions): Promise<import("./event.define").EngageResponse | {
+        message: string;
         error: RequestInternalError | "event_not_found" | "feature_not_found" | "invalid_weixin_appid" | "invalid_weixin_openid" | "event_not_started" | "event_already_ended" | "engage_feature_reached_limit" | "comment_too_frequently" | "lottery_reward_is_empty" | "invalid_merchant_parameter" | "budget_not_enough" | "combo_id_not_found" | "query_user_order_total_amount_err" | "unique_gift_code_is_empty" | "player_created_at_out_of_range" | "user_had_joined_a_team" | "team_is_full" | "disband_team_not_allowed" | "change_team_visibility_not_allowed" | "team_not_found" | "join_team_conflict" | "team_has_been_disbanded" | "exceeded_assembled_team_limit" | "invalid_engage_lottery_draw_ticket" | "lottery_ticket_not_found" | "draw_lottery_ticket_not_start" | "draw_lottery_ticket_is_ended" | "activation_group_not_found" | "activation_group_expired" | "no_claim_activation_key_eligibility" | "no_activation_key_available";
     }>;
     /**
@@ -133,12 +135,13 @@ export declare class EventApi {
         /** 产生奖励的来源 */
         reward_source: RewardSource;
         /** 游戏服务器 ID，领取游戏道具时为必填 */
-        server_id?: number;
+        server_id?: string | number;
         /** 游戏角色 ID，领取游戏道具时为必填 */
         role_id?: string;
         /** 游戏角色名 */
         role_name?: string;
     }, requestOptions?: IRequestOptions): Promise<import("./event.define").ClaimedItem[] | {
+        message: string;
         error: RequestInternalError | "invalid_server_id" | "invalid_role_id" | "event_not_found" | "engagement_not_found" | "event_not_started" | "event_already_ended" | "claim_rewards_not_started" | "claim_rewards_already_ended" | "no_rewards_to_claim" | "reward_received" | "claim_reward_error";
     }>;
     /**
@@ -149,6 +152,7 @@ export declare class EventApi {
     claimWeixinHongbao(rewardId: number, requestOptions?: IRequestOptions): Promise<{
         reward_status: ClaimRewardStatus;
     } | {
+        message: string;
         error: RequestInternalError | "invalid_weixin_openid" | "event_not_started" | "event_already_ended" | "no_rewards_to_claim" | "reward_received" | "invalid_merchant_parameter" | "budget_not_enough";
     }>;
     /**
@@ -158,7 +162,9 @@ export declare class EventApi {
      */
     verifyActivationKey(activationKey: string, requestOptions?: IRequestOptions): Promise<true | {
         readonly error: "not_logged_in";
+        message?: undefined;
     } | {
+        message: string;
         error: RequestInternalError | "invalid_activation_key" | "activation_key_expired";
     }>;
     /**
@@ -185,7 +191,7 @@ export declare class EventApi {
      */
     getUserItemCount(itemId: number, requestOptions?: IRequestOptions): Promise<number | null>;
     /**
-     * 填写实物奖励收货地址
+     * 填写实物奖励收货地址，返回 null 表示未登录
      *
      * https://kdocs.cn/l/ckWFDcOsYEUA?linkname=QIwGhnaexb
      */

package/types/src/weixin.d.ts

@@ -46,7 +46,8 @@ export declare class WeixinApi {
      *
      * https://kdocs.cn/l/cf2mO2uRLqh9?linkname=GwIZ0givCb
      */
-    login(): Promise<import("./weixin.define").WeixinLoginResponse | {
+    login(requestOptions?: IRequestOptions): Promise<import("./weixin.define").WeixinLoginResponse | {
+        message: string;
         error: RequestInternalError | "invalid_weixin_appid" | "invalid_weixin_code";
     }>;
     /**
@@ -66,8 +67,10 @@ export declare class WeixinApi {
      *  - snsapi_userinfo 【默认】弹出授权页面，可拿到 openid、union_id、昵称、头像等信息，但用户也可能会拒绝授权
      */
     webLogin(scope?: "snsapi_base" | "snsapi_userinfo", requestOptions?: IRequestOptions): Promise<import("./weixin.define").WeixinLoginResponse | {
+        message: string;
         error: WeixinWebLoginErrorCode;
     } | {
+        message: string;
         error: RequestInternalError | "invalid_weixin_appid" | "invalid_weixin_code";
     } | undefined>;
     /**
@@ -82,7 +85,7 @@ export declare class WeixinApi {
      * @param weixinToken 调用 login 后，得到的 weixinToken，如果 weixinToken 为空则跳过不处理
      * @param gameCode 从游戏内跳转至小程序时，通过请求参数 query 携带的 game_code，如果值为空则跳过不处理
      */
-    linkPlayer(weixinToken: string, gameCode: string, requestOptions?: IRequestOptions): Promise<void>;
+    linkPlayer(weixinToken: string, gameCode: string, requestOptions?: IRequestOptions): Promise<boolean>;
     /**
      * 获取集成 JSSDK 所需的签名信息
      *