@newbeebox/newbeebox-client-web-sdk 1.0.13 → 1.0.14

package/README.md

@@ -25,6 +25,10 @@ await client.ShowSubscriptionPage();
 // 获取当前用户订阅信息
 let info = await client.GetUserSubscription();
 console.log(info);
+
+// 获取当前登录用户信息
+let user = await client.GetUserInfo();
+console.log(user);
 ```
 
 ### API
@@ -45,6 +49,10 @@ console.log(info);
 
 获取当前用户的订阅信息。
 
+#### `GetUserInfo(): Promise<UserAccountInfo>`
+
+获取当前登录用户的基础信息。用户未登录时抛出错误。
+
 #### `InstallWoWAddon(game_version_id, addon_id, secret_key?): Promise<any>`
 
 安装魔兽世界插件。
@@ -64,6 +72,18 @@ console.log(info);
 | tool_name | string | 完整API路径，如 `/tool/some_api` |
 | data | object | 请求数据（可选） |
 
+### 错误处理
+
+所有接口失败时都会抛出 `Error`，`message` 格式统一为 `<操作>发生错误:<原因>`。
+
+如果用户安装的客户端版本过低、没有所调用的接口，`<原因>` 固定为：
+
+```
+当前客户端不支持该接口，请升级新手盒子客户端
+```
+
+所有接口（含 `Patch`）行为一致，第三方应用可据此提示用户升级客户端。
+
 ---
 
 **订阅信息返回结构**：
@@ -86,3 +106,20 @@ console.log(info);
     "sign": "485d82860578ff..."  // 签名，用于服务端验证
 }
 ```
+
+
+**用户信息返回结构**：
+
+```javascript
+{
+    "id": 10001,               // 用户ID
+    "username": "Kyuu",        // 用户名
+    "avatar": "https://cdn8.newbeebox.com/....",
+    "isVip": true,             // 是否是 VIP
+    "vip": {                   // 非 VIP 时为 null
+        "isYearly": false,     // 是否年费会员
+        "adFree": true,        // 是否免广告
+        "endTime": 1790000000000  // 会员到期时间戳
+    }
+}
+```

package/index.js

@@ -105,6 +105,10 @@ function probeFirstPort(ports) {
     });
 }
 
+// 客户端接口不存在（老版本客户端没有对应路由）时，SDK 统一合成的错误响应
+const CODE_NOT_SUPPORTED = -404;
+const MSG_NOT_SUPPORTED = "当前客户端不支持该接口，请升级新手盒子客户端";
+
 export class NewBeeClient {
     app_id = "";
 
@@ -119,6 +123,45 @@ export class NewBeeClient {
         }
     }
 
+    // 统一请求客户端：POST JSON 到 path，自动带上 app_id，返回客户端标准响应 {code, data, message}
+    // - 接口不存在（老版本客户端返回 404）：返回统一的错误响应 {code: -404, message: MSG_NOT_SUPPORTED}
+    // - 网络错误 / 超时 / 响应非 JSON：返回 null
+    // 调用方只需判断 code === 1
+    async _post(path, data, timeout) {
+        this._ensureInitialized();
+
+        const controller = new AbortController();
+        const timeoutId = timeout ? setTimeout(() => controller.abort("请求超时"), timeout) : null;
+
+        try {
+            const response = await fetch(CLIENT_SERVICE_BASE_URL + ":" + this.newbee_client_port + path, {
+                method: "POST",
+                signal: controller.signal,
+                headers: {
+                    "Content-Type": 'application/json',
+                },
+                body: JSON.stringify({
+                    app_id: this.app_id,
+                    ...data
+                })
+            });
+
+            if (response.status === 404) {
+                console.log("客户端不支持该接口:", path);
+                return { code: CODE_NOT_SUPPORTED, data: null, message: MSG_NOT_SUPPORTED };
+            }
+
+            const result = await response.json();
+            console.log(path, "响应:", result);
+            return result;
+        } catch (e) {
+            console.log(path, "请求错误:", e);
+            return null;
+        } finally {
+            if (timeoutId) clearTimeout(timeoutId);
+        }
+    }
+
     async Init(app_id) {
         console.log(`[NewBeeBox SDK] version ${SDK_VERSION}`);
 
@@ -154,44 +197,10 @@ export class NewBeeClient {
 
     // 打开应用订阅界面
     async ShowSubscriptionPage() {
-        this._ensureInitialized();
-
-        // 创建 AbortController 实例
-        const controller = new AbortController();
-
-        const signal = controller.signal;
-
-        const timeoutId = setTimeout(() => {
-            controller.abort("请求超时"); // 超时后取消请求
-            console.log('打开订单页面超时');
-        }, TASK_REQUEST_TIMEOUT);
-
-        let show_page_response;
-
-        try {
-            // 测试成功就请求客户端授权
-            let response = await fetch(CLIENT_SERVICE_BASE_URL + ":" + this.newbee_client_port + "/tool/open_subscription_dialog", {
-                method: "POST",
-                signal: signal,
-                headers: {
-                    "Content-Type": 'application/json',
-                },
-                body: JSON.stringify({
-                    app_id: this.app_id
-                })
-            });
-
-            clearTimeout(timeoutId);
-
-            show_page_response = await response.json();
-
-            console.log("开启页面结果:", show_page_response);
-        } catch (e) {
-            console.log("打开订单页面超时", e);
-        }
+        const res = await this._post("/tool/open_subscription_dialog", null, TASK_REQUEST_TIMEOUT);
 
-        if (!show_page_response || show_page_response?.code !== 1) {
-            throw new Error("打开订单页面发生错误:" + (show_page_response?.message || "未知错误"));
+        if (!res || res.code !== 1) {
+            throw new Error("打开订单页面发生错误:" + (res?.message || "未知错误"));
         }
 
         return true;
@@ -199,99 +208,49 @@ export class NewBeeClient {
 
     // 获取当前使用的用户的订阅信息
     async GetUserSubscription() {
-        this._ensureInitialized();
+        const res = await this._post("/tool/subscription_status");
 
-        let user_subscribe_response  = null;
-        try {
-            // 测试成功就请求客户端授权
-            let response = await fetch(CLIENT_SERVICE_BASE_URL + ":" + this.newbee_client_port + "/tool/subscription_status", {
-                method: "POST",
-                headers: {
-                    "Content-Type": 'application/json',
-                },
-                body: JSON.stringify({
-                    app_id: this.app_id
-                })
-            });
+        if (!res || res.code !== 1 || !res.data) {
+            throw new Error("获取用户订阅信息发生错误:" + (res?.message || "未知错误"));
+        }
 
-            user_subscribe_response = await response.json();
+        return res.data;
+    }
 
-            console.log("用户订阅信息响应:", user_subscribe_response);
-        } catch (e) {
-            console.log("获取用户订阅错误:", e);
-        }
+    // 获取当前登录用户的基础信息（未登录时抛错）
+    async GetUserInfo() {
+        const res = await this._post("/user/info");
 
-        if (!user_subscribe_response || user_subscribe_response?.code !== 1 || !user_subscribe_response?.data) {
-            throw new Error("获取用户订阅信息发生错误:" + (user_subscribe_response?.message || "未知错误"));
+        if (!res || res.code !== 1 || !res.data) {
+            throw new Error("获取用户信息发生错误:" + (res?.message || "未知错误"));
         }
 
-        return user_subscribe_response.data
+        return res.data;
     }
 
     // 安装魔兽世界插件
     async InstallWoWAddon(game_version_id, addon_id, secret_key) {
-        this._ensureInitialized();
-
-        let install_response = null;
-        try {
-            const body = {
-                app_id: this.app_id,
-                game_version_id: game_version_id,
-                addon_id: addon_id
-            };
-            if (secret_key) {
-                body.secret_key = secret_key;
-            }
-            let response = await fetch(CLIENT_SERVICE_BASE_URL + ":" + this.newbee_client_port + "/tool/wow_install_addon", {
-                method: "POST",
-                headers: {
-                    "Content-Type": 'application/json',
-                },
-                body: JSON.stringify(body)
-            });
-
-            install_response = await response.json();
-
-            console.log("安装插件响应:", install_response);
-        } catch (e) {
-            console.log("安装插件错误:", e);
+        const body = { game_version_id, addon_id };
+        if (secret_key) {
+            body.secret_key = secret_key;
         }
+        const res = await this._post("/tool/wow_install_addon", body);
 
-        if (!install_response || install_response?.code !== 1) {
-            throw new Error("安装魔兽世界插件发生错误:" + (install_response?.message || "未知错误"));
+        if (!res || res.code !== 1) {
+            throw new Error("安装魔兽世界插件发生错误:" + (res?.message || "未知错误"));
         }
 
-        return install_response.data;
+        return res.data;
     }
 
     // 通用请求 当没有导出指定接口时可以使用这个函数补充请求
     async Patch(tool_name, data) {
-        this._ensureInitialized();
+        const res = await this._post(tool_name, data);
 
-        let patch_response = null;
-        try {
-            let response = await fetch(CLIENT_SERVICE_BASE_URL + ":" + this.newbee_client_port + tool_name, {
-                method: "POST",
-                headers: {
-                    "Content-Type": 'application/json',
-                },
-                body: JSON.stringify({
-                    app_id: this.app_id,
-                    ...data
-                })
-            });
-
-            patch_response = await response.json();
-
-            console.log("Patch响应:", patch_response);
-        } catch (e) {
-            console.log("Patch请求错误:", e);
+        if (!res || res.code !== 1) {
+            throw new Error("Patch请求发生错误:" + (res?.message || "未知错误"));
         }
 
-        if (!patch_response || patch_response?.code !== 1) {
-            throw new Error("Patch请求发生错误:" + (patch_response?.message || "未知错误"));
-        }
-
-        return patch_response.data;
+        return res.data;
     }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newbeebox/newbeebox-client-web-sdk",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "description": "NewBeeBox Client SDK for Web",
   "main": "index.js",
   "type": "module",

package/types/index.d.ts

@@ -34,6 +34,14 @@ export class NewBeeClient {
      */
     GetUserSubscription(): Promise<UserSubscribeInfo>;
 
+    /**
+     * 获取当前登录用户信息
+     * @constructor GetUserInfo
+     * @return {Promise<UserAccountInfo>}
+     * @throws 未登录、客户端版本过低时抛出错误
+     */
+    GetUserInfo(): Promise<UserAccountInfo>;
+
     /**
      * 安装魔兽世界插件
      * @param game_version_id 游戏版本ID
@@ -82,6 +90,36 @@ export interface UserInfo {
     avatar:string;
 }
 
+/**
+ * @interface UserVipInfo
+ * @description 用户 VIP 信息
+ * @property {boolean} isYearly - 是否年费会员
+ * @property {boolean} adFree - 是否免广告
+ * @property {number | null} endTime - 会员到期时间戳
+ */
+export interface UserVipInfo {
+    isYearly: boolean;
+    adFree: boolean;
+    endTime: number | null;
+}
+
+/**
+ * @interface UserAccountInfo
+ * @description 当前登录用户信息（GetUserInfo 返回）
+ * @property {number | null} id - 用户ID
+ * @property {string} username - 用户名
+ * @property {string} avatar - 用户头像
+ * @property {boolean} isVip - 是否是 VIP
+ * @property {UserVipInfo | null} vip - VIP 信息，非 VIP 时为 null
+ */
+export interface UserAccountInfo {
+    id: number | null;
+    username: string;
+    avatar: string;
+    isVip: boolean;
+    vip: UserVipInfo | null;
+}
+
 /**
  * @interface UserSubscribeInfo
  * @description 用户订阅信息