@seaverse/auth-sdk 0.2.4 → 0.2.6

package/README.md

@@ -16,6 +16,7 @@ SeaVerse Backend API 客户端 SDK - 提供完整的认证、容器管理、技
 - 🌍 **多环境支持** - Production、Staging、Development、Local
 - ⚡ **TypeScript** - 完整的类型定义
 - 🔧 **认证集成** - 内置Auth、Hooks系统支持
+- 🔄 **响应格式兼容** - 自动兼容多种API响应格式
 
 ## 安装
 
@@ -532,7 +533,7 @@ SDK支持以下环境：
 
 | 环境 | 描述 | BaseURL |
 |------|------|---------|
-| `production` | 生产环境 | `https://api.seaverse.com` |
+| `production` | 生产环境 | `https://account-hub.seaverse.ai` |
 | `staging` | 测试环境 | `https://api.staging.seaverse.dev` |
 | `development` | 开发环境 | `https://api.dev.seaverse.dev` |
 | `local` | 本地环境 | `http://localhost:3000` |
@@ -598,6 +599,74 @@ SDK支持以下环境：
 | `getConversationStatus()` | `{ conversationId }` | `ConversationStatusResponse` | 获取对话状态 |
 | `getSpeechToken()` | - | `SpeechTokenResponse` | 获取语音Token |
 
+## 响应格式兼容性
+
+### 自动响应解包
+
+从 v0.2.5 开始，SDK 自动兼容两种API响应格式，无需手动处理：
+
+**格式 1: 包装格式**（推荐）
+```json
+{
+  "data": {
+    "token": "eyJhbGc...",
+    "user": { ... }
+  },
+  "success": true
+}
+```
+
+**格式 2: 扁平格式**（向后兼容）
+```json
+{
+  "token": "eyJhbGc...",
+  "user": { ... }
+}
+```
+
+SDK 会自动检测响应格式并提取正确的数据：
+
+```typescript
+// 无论后端返回哪种格式，以下代码都能正常工作
+const loginResult = await client.login({
+  email: 'user@example.com',
+  password: 'password123',
+});
+
+console.log(loginResult.token); // ✅ 始终能正确获取 token
+console.log(loginResult.user);  // ✅ 始终能正确获取 user
+```
+
+### 受影响的方法
+
+以下方法已实现自动响应解包：
+
+- ✅ `login()` - 登录接口
+- ✅ `register()` - 注册接口
+- ✅ `getCurrentUser()` - 获取当前用户
+
+### 实现原理
+
+SDK 内部通过以下逻辑自动处理响应格式：
+
+```typescript
+const response = await httpClient.request(config);
+const responseData = response.data;
+
+// 检测并解包
+if (responseData.data && typeof responseData.data === 'object') {
+  // 包装格式: 提取 data 字段
+  return responseData.data;
+}
+// 扁平格式: 直接返回
+return responseData;
+```
+
+这意味着：
+- 🔄 **后端格式变更无需前端修改** - 后端可以自由调整响应格式
+- 🔧 **渐进式迁移** - 可以逐步将不同接口迁移到新格式
+- ✅ **向后兼容** - 旧代码无需修改即可继续工作
+
 ## 错误处理
 
 ### 错误响应格式
@@ -1033,7 +1102,14 @@ MIT © [SeaVerse Team](mailto:support@seaverse.com)
 
 ## 更新日志
 
-### v0.2.0 (当前版本)
+### v0.2.5 (当前版本)
+- 🔄 **响应格式兼容**: 自动兼容包装格式和扁平格式的API响应
+  - 修复登录时提示 "Invalid response from server" 的问题
+  - `login()`, `register()`, `getCurrentUser()` 方法自动解包 `data` 字段
+  - 支持两种格式: `{ data: {...}, success: true }` 和 `{ ... }`
+- 📝 **文档更新**: 新增响应格式兼容性章节
+
+### v0.2.0
 - 🔄 **API路径更新**: 所有认证API从 `/api/auth/*` 迁移到 `/sdk/v1/auth/*`
 - 🏢 **多租户支持**: User模型新增 `app_id` 字段，支持多应用隔离
 - 🔑 **重要变更**: `appId` 现在是**必需参数**，SDK 自动在所有请求中添加 `X-App-ID` 请求头

package/dist/index.cjs

@@ -1043,7 +1043,7 @@ const ENVIRONMENT_CONFIGS = {
     production: {
         name: 'production',
         baseURL: 'https://account-hub.seaverse.ai',
-        wsURL: 'wss://api.seaverse.com',
+        wsURL: 'wss://account-hub.seaverse.ai',
         isProduction: true,
     },
     staging: {
@@ -1317,7 +1317,12 @@ class SeaVerseBackendAPIClient {
             ...options,
         };
         const response = await this.httpClient.request(config);
-        return response.data;
+        // ✅ 兼容两种响应格式
+        const responseData = response.data;
+        if (responseData.data && typeof responseData.data === 'object') {
+            return responseData.data;
+        }
+        return responseData;
     }
     /**
      * User login
@@ -1335,7 +1340,16 @@ class SeaVerseBackendAPIClient {
             ...options,
         };
         const response = await this.httpClient.request(config);
-        return response.data;
+        // ✅ 兼容两种响应格式:
+        // 1. { data: { token, user }, success: true } (新格式)
+        // 2. { token, user } (旧格式)
+        const responseData = response.data;
+        if (responseData.data && typeof responseData.data === 'object') {
+            // 新格式: 解包 data 字段
+            return responseData.data;
+        }
+        // 旧格式: 直接返回
+        return responseData;
     }
     /**
      * Get current user
@@ -1352,7 +1366,12 @@ class SeaVerseBackendAPIClient {
             ...options,
         };
         const response = await this.httpClient.request(config);
-        return response.data;
+        // ✅ 兼容两种响应格式
+        const responseData = response.data;
+        if (responseData.data && typeof responseData.data === 'object') {
+            return responseData.data;
+        }
+        return responseData;
     }
     /**
      * User logout