@seaverse/auth-sdk 0.3.2 → 0.3.4

package/README.md

@@ -126,6 +126,11 @@ const loginResult = await client.login({
 // 保存token
 localStorage.setItem('token', loginResult.token);
 
+// ⚠️ 注意：邀请码自动跳转
+// 如果服务器返回 INVITE_CODE_REQUIRED 错误且包含 redirectUrl，
+// SDK 会自动将用户重定向到该 URL（通常是邀请码输入页面）
+// 无需额外处理，页面会自动跳转
+
 // 获取当前用户信息
 const user = await client.getCurrentUser();
 console.log('User:', user);
@@ -591,7 +596,14 @@ if (verifyToken) {
 
 #### 邀请码绑定（账户激活）
 
-当使用外部邮箱注册或 OAuth 登录但未提供邀请码时，会创建临时账户并需要后续绑定邀请码激活。后端会重定向到 `frontend_url?error_code=INVITE_CODE_REQUIRED&user_id=xxx&email=xxx`。
+当使用外部邮箱注册或 OAuth 登录但未提供邀请码时，会创建临时账户并需要后续绑定邀请码激活。
+
+**自动跳转机制**:
+- 当 `login()` 返回 `INVITE_CODE_REQUIRED` 错误且包含 `redirectUrl` 时，SDK 会自动将页面重定向到该 URL
+- redirectUrl 通常包含 `error_code=INVITE_CODE_REQUIRED&user_id=xxx&email=xxx` 参数
+- 无需手动处理跳转逻辑，SDK 会自动完成
+
+对于其他场景(如 OAuth 登录后的重定向)，后端会直接重定向到 `frontend_url?error_code=INVITE_CODE_REQUIRED&user_id=xxx&email=xxx`。
 
 **方式一：使用 AuthModal 自动处理（推荐）**
 
@@ -887,7 +899,7 @@ SDK支持以下环境：
 | 方法 | 参数 | 返回值 | 说明 |
 |------|------|--------|------|
 | `register()` | `{ email, password, username?, invitation_code?, frontend_url? }` | `RegisterResponse` | 注册新用户，frontend_url 为邮箱验证链接的前端URL，默认为 window.location.href |
-| `login()` | `{ email, password, frontend_url? }` | `LoginResponse` | 用户登录，frontend_url 用于未验证邮箱时发送验证邮件，默认为 https://seaverse.ai/ |
+| `login()` | `{ email, password, frontend_url? }` | `LoginResponse` | 用户登录，frontend_url 用于未验证邮箱时发送验证邮件，默认为 https://seaverse.ai/。⚠️ 如果返回 INVITE_CODE_REQUIRED 且包含 redirectUrl，会自动跳转 |
 | `getCurrentUser()` | - | `User` | 获取当前用户 |
 | `logout()` | - | `SuccessResponse` | 登出 |
 | `verifyEmail()` | `verifyToken: string` | `EmailVerificationResponse` | 验证邮箱并返回自动登录 token |
@@ -1088,6 +1100,7 @@ ErrorCode.PASSWORD_TOO_WEAK      // 密码强度不够
 // 邀请码相关错误
 ErrorCode.INVALID_INVITATION_CODE // 无效的邀请码
 ErrorCode.INVITATION_REQUIRED     // 需要邀请码
+ErrorCode.INVITE_CODE_REQUIRED    // 需要邀请码（会自动跳转到 redirectUrl）
 
 // Token 相关错误
 ErrorCode.INVALID_TOKEN          // 无效的 token

package/dist/index.cjs

@@ -1157,6 +1157,7 @@ exports.ErrorCode = void 0;
     // Invitation errors
     ErrorCode["INVALID_INVITATION_CODE"] = "INVALID_INVITATION_CODE";
     ErrorCode["INVITATION_REQUIRED"] = "INVITATION_REQUIRED";
+    ErrorCode["INVITE_CODE_REQUIRED"] = "INVITE_CODE_REQUIRED";
     // Token errors
     ErrorCode["INVALID_TOKEN"] = "INVALID_TOKEN";
     ErrorCode["TOKEN_EXPIRED"] = "TOKEN_EXPIRED";
@@ -1346,17 +1347,47 @@ class SeaVerseBackendAPIClient {
             },
             ...options,
         };
-        const response = await this.httpClient.request(config);
-        // ✅ 兼容两种响应格式:
-        // 1. { data: { token, user }, success: true } (新格式)
-        // 2. { token, user } (旧格式)
-        const responseData = response.data;
-        if (responseData.data && typeof responseData.data === 'object') {
-            // 新格式: 解包 data 字段
-            return responseData.data;
+        try {
+            const response = await this.httpClient.request(config);
+            // ✅ 兼容两种响应格式:
+            // 1. { data: { token, user }, success: true } (新格式)
+            // 2. { token, user } (旧格式)
+            const responseData = response.data;
+            // ⚠️ 检查响应体中的 INVITE_CODE_REQUIRED 错误 (HTTP 200 + 错误响应体)
+            if (responseData?.code === 'INVITE_CODE_REQUIRED' && responseData?.data?.redirectUrl) {
+                const redirectUrl = responseData.data.redirectUrl;
+                // Only redirect in browser environment
+                if (typeof window !== 'undefined') {
+                    console.log('[AuthSDK] INVITE_CODE_REQUIRED detected in response, redirecting to:', redirectUrl);
+                    window.location.href = redirectUrl;
+                    // Return a pending promise to prevent further execution
+                    return new Promise(() => { });
+                }
+            }
+            if (responseData.data && typeof responseData.data === 'object') {
+                // 新格式: 解包 data 字段
+                return responseData.data;
+            }
+            // 旧格式: 直接返回
+            return responseData;
+        }
+        catch (error) {
+            // Handle HTTP error response (4xx, 5xx status codes)
+            const errorResponse = error.response?.data;
+            // Check if error is INVITE_CODE_REQUIRED and has redirectUrl
+            if (errorResponse?.code === 'INVITE_CODE_REQUIRED' && errorResponse?.data?.redirectUrl) {
+                const redirectUrl = errorResponse.data.redirectUrl;
+                // Only redirect in browser environment
+                if (typeof window !== 'undefined') {
+                    console.log('[AuthSDK] INVITE_CODE_REQUIRED detected in error, redirecting to:', redirectUrl);
+                    window.location.href = redirectUrl;
+                    // Return a pending promise to prevent further execution
+                    return new Promise(() => { });
+                }
+            }
+            // Re-throw the error if it's not INVITE_CODE_REQUIRED or no redirectUrl
+            throw error;
         }
-        // 旧格式: 直接返回
-        return responseData;
     }
     /**
      * Get current user