@gt6/sdk 1.0.9 → 1.0.11

package/README.md

@@ -1264,7 +1264,7 @@ if (financeProduct.simpleFinance) {
 }
 ```
 
-## 支付方式模块
+## 支付方式模块 (Payment Methods)
 
 SDK提供了支付方式管理功能，支持获取各种类型的支付方式。
 
@@ -1442,4 +1442,390 @@ interface FormSubmitOptions {
 }
 ```
 
-## 支付方式模块 (Payment Methods)
+## 支付方式模块 (Payment Methods)
+
+## 用户认证模块 (Users)
+
+用户认证模块提供了完整的用户登录、注册和会话管理功能。
+
+### API 方法
+
+#### `login(username, password, platformId)`
+用户登录
+
+**参数:**
+- `username` (string): 用户名
+- `password` (string): 密码
+- `platformId` (number): 平台ID
+
+**返回:** `Promise<LoginResponse>`
+
+#### `register(username, password, platformId, ibcode?)`
+用户注册
+
+**参数:**
+- `username` (string): 用户名
+- `password` (string): 密码
+- `platformId` (number): 平台ID
+- `ibcode` (string, 可选): 邀请码
+
+**返回:** `Promise<RegisterResponse>`
+
+#### `isLoggedIn()`
+检查用户是否已登录
+
+**返回:** `boolean`
+
+#### `getCurrentUser()`
+获取当前登录用户信息
+
+**返回:** `UserInfo | null`
+
+#### `getToken()`
+获取当前登录用户的token
+
+**返回:** `string | null`
+
+#### `logout()`
+用户登出
+
+#### `saveUserData(userData)`
+保存用户数据到本地存储
+
+**参数:**
+- `userData` (UserData): 用户数据对象
+
+#### `getUserData()`
+从本地存储获取用户数据
+
+**返回:** `UserData | null`
+
+#### `rememberLogin(username, password)`
+记住用户登录信息
+
+**参数:**
+- `username` (string): 用户名
+- `password` (string): 密码
+
+#### `getRememberedLogin()`
+获取记住的登录信息
+
+**返回:** `{ username: string; password: string } | null`
+
+#### `clearRememberedLogin()`
+清除记住的登录信息
+
+### 使用示例
+
+```javascript
+// 用户登录
+const loginResult = await sdk.login('username', 'password', 1);
+if (loginResult.success && loginResult.token && loginResult.user) {
+  // 保存用户数据到本地存储
+  const userData = {
+    ...loginResult.user,
+    token: loginResult.token
+  };
+  sdk.saveUserData(userData);
+  console.log('登录成功:', loginResult.user);
+} else {
+  console.error('登录失败:', loginResult.message);
+}
+
+// 用户注册
+const registerResult = await sdk.register('newuser', 'password123', 1, 'INVITE123');
+if (registerResult.success) {
+  console.log('注册成功，用户ID:', registerResult.userId);
+} else {
+  console.error('注册失败:', registerResult.message);
+}
+
+// 检查登录状态
+if (sdk.isLoggedIn()) {
+  const user = sdk.getCurrentUser();
+  const token = sdk.getToken();
+  console.log('用户已登录:', user);
+  console.log('Token:', token);
+} else {
+  console.log('用户未登录');
+}
+
+// 记住登录信息
+sdk.rememberLogin('username', 'password');
+
+// 获取记住的登录信息
+const remembered = sdk.getRememberedLogin();
+if (remembered) {
+  console.log('记住的登录信息:', remembered);
+}
+
+// 用户登出
+sdk.logout();
+```
+
+### 完整的登录流程示例
+
+```javascript
+async function completeLoginFlow() {
+  // 检查是否已登录
+  if (sdk.isLoggedIn()) {
+    console.log('用户已登录，无需重新登录');
+    return true;
+  }
+
+  // 尝试使用记住的登录信息
+  const remembered = sdk.getRememberedLogin();
+  if (remembered) {
+    console.log('使用记住的登录信息');
+    const result = await sdk.login(remembered.username, remembered.password, 1);
+    if (result.success) {
+      console.log('使用记住的信息登录成功');
+      return true;
+    }
+  }
+
+  // 手动登录
+  console.log('需要手动登录');
+  return false;
+}
+```
+
+### 表单验证示例
+
+```javascript
+// 登录验证
+async function loginWithValidation(username, password, platformId) {
+  // 基本验证
+  if (!username || !password) {
+    console.error('用户名和密码不能为空');
+    return false;
+  }
+
+  if (password.length < 6) {
+    console.error('密码长度不能少于6位');
+    return false;
+  }
+
+  // 执行登录
+  const result = await sdk.login(username, password, platformId);
+  
+  if (result.success && result.token && result.user) {
+    // 保存用户数据
+    const userData = {
+      ...result.user,
+      token: result.token
+    };
+    sdk.saveUserData(userData);
+    
+    console.log('登录成功');
+    return true;
+  } else {
+    console.error('登录失败:', result.message);
+    return false;
+  }
+}
+
+// 注册验证
+async function registerWithValidation(username, password, confirmPassword, platformId, ibcode) {
+  // 基本验证
+  if (!username || !password || !confirmPassword) {
+    console.error('用户名、密码和确认密码不能为空');
+    return false;
+  }
+
+  if (password !== confirmPassword) {
+    console.error('两次输入的密码不一致');
+    return false;
+  }
+
+  if (password.length < 6) {
+    console.error('密码长度不能少于6位');
+    return false;
+  }
+
+  if (username.length < 3) {
+    console.error('用户名长度不能少于3位');
+    return false;
+  }
+
+  // 执行注册
+  const result = await sdk.register(username, password, platformId, ibcode);
+  
+  if (result.success) {
+    console.log('注册成功，用户ID:', result.userId);
+    return true;
+  } else {
+    console.error('注册失败:', result.message);
+    return false;
+  }
+}
+```
+
+### 类型定义
+
+```typescript
+interface LoginRequest {
+  username: string;
+  password: string;
+  platformId: number;
+}
+
+interface LoginResponse {
+  success: boolean;
+  message?: string;
+  token?: string;
+  user?: {
+    userId: number;
+    username: string;
+    userLevel: number;
+    status: boolean;
+    platformId: number;
+    d1: number;
+    d2: number;
+    d3: number;
+  };
+}
+
+interface RegisterRequest {
+  username: string;
+  password: string;
+  platformId: number;
+  ibcode?: string;
+}
+
+interface RegisterResponse {
+  success: boolean;
+  message?: string;
+  userId?: number;
+}
+
+interface UserData {
+  userId: number;
+  username: string;
+  userLevel: number;
+  status: boolean;
+  platformId: number;
+  d1: number;
+  d2: number;
+  d3: number;
+  token: string;
+}
+```
+
+### 在Astro项目中使用
+
+```astro
+---
+// Layout.astro
+import { GT6SDK } from '@gt6/sdk';
+
+const sdk = new GT6SDK({
+  baseUrl: 'https://data.shopasb.io',
+  platformId: '1747558688'
+});
+
+// 检查用户登录状态
+const isLoggedIn = sdk.isLoggedIn();
+const currentUser = sdk.getCurrentUser();
+---
+
+<html>
+  <head>
+    <title>GT6TRADE</title>
+  </head>
+  <body>
+    <header>
+      {isLoggedIn ? (
+        <div>
+          <span>欢迎, {currentUser?.username}</span>
+          <button onclick="logout()">登出</button>
+        </div>
+      ) : (
+        <div>
+          <button onclick="showLoginModal()">登录</button>
+          <button onclick="showRegisterModal()">注册</button>
+        </div>
+      )}
+    </header>
+    
+    <slot />
+    
+    <script>
+      // 全局SDK实例
+      window.gt6SDK = new GT6SDK({
+        baseUrl: 'https://data.shopasb.io',
+        platformId: 1747558688
+      });
+      
+      // 登出函数
+      function logout() {
+        window.gt6SDK.logout();
+        window.location.reload();
+      }
+      
+      // 显示登录模态框
+      function showLoginModal() {
+        // 实现登录模态框显示逻辑
+      }
+      
+      // 显示注册模态框
+      function showRegisterModal() {
+        // 实现注册模态框显示逻辑
+      }
+    </script>
+  </body>
+</html>
+```
+
+### 错误处理
+
+用户认证方法返回统一的响应格式：
+
+```typescript
+// 登录成功响应
+{
+  success: true,
+  token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
+  user: {
+    userId: 123,
+    username: "testuser",
+    userLevel: 1,
+    status: true,
+    platformId: 1,
+    d1: 0,
+    d2: 0,
+    d3: 0
+  }
+}
+
+// 登录失败响应
+{
+  success: false,
+  message: "用户名或密码错误"
+}
+
+// 注册成功响应
+{
+  success: true,
+  userId: 123,
+  message: "注册成功"
+}
+
+// 注册失败响应
+{
+  success: false,
+  message: "用户名已存在"
+}
+```
+
+### 安全注意事项
+
+1. **密码安全**: 确保密码在传输前进行适当的加密
+2. **Token管理**: 妥善保存和管理用户token，避免泄露
+3. **会话管理**: 定期检查token有效性，及时清理过期会话
+4. **本地存储**: 敏感信息存储时考虑使用更安全的存储方式
+5. **输入验证**: 在客户端和服务端都进行充分的输入验证
+
+## 许可证
+
+MIT License

package/dist/gt6-sdk.cjs.js

@@ -833,9 +833,201 @@ class FormsAPI {
     }
 }
 
+/**
+ * 用户管理API模块
+ * 提供用户登录、注册等功能
+ */
+class UsersAPI {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * 用户登录
+     * @param loginData 登录数据
+     * @returns 登录响应
+     */
+    async login(loginData) {
+        try {
+            const response = await this.client.request('/web/user/login', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(loginData)
+            });
+            return response;
+        }
+        catch (error) {
+            // 如果是HTTP错误，尝试解析响应体
+            if (error.statusCode && error.message) {
+                // 对于401错误，返回特定的错误信息
+                if (error.statusCode === 401) {
+                    return {
+                        success: false,
+                        message: '用户名或密码错误'
+                    };
+                }
+                // 对于其他HTTP错误，返回状态码信息
+                return {
+                    success: false,
+                    message: error.message || `HTTP ${error.statusCode} 错误`
+                };
+            }
+            // 对于网络错误或其他错误
+            return {
+                success: false,
+                message: error instanceof Error ? error.message : '登录请求失败'
+            };
+        }
+    }
+    /**
+     * 用户注册
+     * @param registerData 注册数据
+     * @returns 注册响应
+     */
+    async register(registerData) {
+        try {
+            const response = await this.client.request('/web/user/register', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(registerData)
+            });
+            return response;
+        }
+        catch (error) {
+            // 如果是HTTP错误，尝试解析响应体
+            if (error.statusCode && error.message) {
+                // 对于400错误，可能是用户名已存在等验证错误
+                if (error.statusCode === 400) {
+                    return {
+                        success: false,
+                        message: '注册信息有误，请检查输入'
+                    };
+                }
+                // 对于其他HTTP错误，返回状态码信息
+                return {
+                    success: false,
+                    message: error.message || `HTTP ${error.statusCode} 错误`
+                };
+            }
+            // 对于网络错误或其他错误
+            return {
+                success: false,
+                message: error instanceof Error ? error.message : '注册请求失败'
+            };
+        }
+    }
+    /**
+     * 保存用户数据到本地存储
+     * @param userData 用户数据
+     */
+    saveUserData(userData) {
+        if (typeof window !== 'undefined' && window.localStorage) {
+            localStorage.setItem('userData', JSON.stringify(userData));
+        }
+    }
+    /**
+     * 从本地存储获取用户数据
+     * @returns 用户数据或null
+     */
+    getUserData() {
+        if (typeof window !== 'undefined' && window.localStorage) {
+            const userDataStr = localStorage.getItem('userData');
+            if (userDataStr) {
+                try {
+                    return JSON.parse(userDataStr);
+                }
+                catch (error) {
+                    console.warn('解析用户数据失败:', error);
+                    return null;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * 清除本地存储的用户数据
+     */
+    clearUserData() {
+        if (typeof window !== 'undefined' && window.localStorage) {
+            localStorage.removeItem('userData');
+        }
+    }
+    /**
+     * 检查用户是否已登录
+     * @returns 是否已登录
+     */
+    isLoggedIn() {
+        const userData = this.getUserData();
+        return userData !== null && userData.token !== undefined;
+    }
+    /**
+     * 获取当前登录用户的token
+     * @returns token或null
+     */
+    getToken() {
+        const userData = this.getUserData();
+        return userData?.token || null;
+    }
+    /**
+     * 获取当前登录用户信息
+     * @returns 用户信息或null
+     */
+    getCurrentUser() {
+        const userData = this.getUserData();
+        if (userData) {
+            const { token, ...userInfo } = userData;
+            return userInfo;
+        }
+        return null;
+    }
+    /**
+     * 用户登出
+     */
+    logout() {
+        this.clearUserData();
+    }
+    /**
+     * 记住用户登录信息
+     * @param username 用户名
+     * @param password 密码
+     */
+    rememberLogin(username, password) {
+        if (typeof window !== 'undefined' && window.localStorage) {
+            localStorage.setItem('rememberedUsername', username);
+            localStorage.setItem('rememberedPassword', password);
+        }
+    }
+    /**
+     * 获取记住的登录信息
+     * @returns 记住的登录信息
+     */
+    getRememberedLogin() {
+        if (typeof window !== 'undefined' && window.localStorage) {
+            const username = localStorage.getItem('rememberedUsername');
+            const password = localStorage.getItem('rememberedPassword');
+            if (username && password) {
+                return { username, password };
+            }
+        }
+        return null;
+    }
+    /**
+     * 清除记住的登录信息
+     */
+    clearRememberedLogin() {
+        if (typeof window !== 'undefined' && window.localStorage) {
+            localStorage.removeItem('rememberedUsername');
+            localStorage.removeItem('rememberedPassword');
+        }
+    }
+}
+
 /**
  * GT6 SDK 主类
- * 提供文章、产品和设置管理相关的所有功能
+ * 提供文章、产品、设置、表单和用户管理相关的所有功能
  */
 class GT6SDK {
     constructor(config) {
@@ -844,6 +1036,7 @@ class GT6SDK {
         this.products = new ProductsAPI(client);
         this.settings = new SettingsAPI(client);
         this.forms = new FormsAPI(client);
+        this.users = new UsersAPI(client);
     }
     /**
      * 获取客户端实例（用于高级用法）
@@ -1025,6 +1218,72 @@ class GT6SDK {
     async submitCustomForm(aliases, formData, emailField) {
         return this.forms.submitCustomForm(aliases, formData, emailField);
     }
+    /**
+     * 28. 便捷方法：用户登录
+     */
+    async login(username, password, platformId) {
+        return this.users.login({ username, password, platformId });
+    }
+    /**
+     * 29. 便捷方法：用户注册
+     */
+    async register(username, password, platformId, ibcode) {
+        return this.users.register({ username, password, platformId, ibcode });
+    }
+    /**
+     * 30. 便捷方法：检查用户是否已登录
+     */
+    isLoggedIn() {
+        return this.users.isLoggedIn();
+    }
+    /**
+     * 31. 便捷方法：获取当前登录用户信息
+     */
+    getCurrentUser() {
+        return this.users.getCurrentUser();
+    }
+    /**
+     * 32. 便捷方法：获取当前登录用户的token
+     */
+    getToken() {
+        return this.users.getToken();
+    }
+    /**
+     * 33. 便捷方法：用户登出
+     */
+    logout() {
+        return this.users.logout();
+    }
+    /**
+     * 34. 便捷方法：保存用户数据
+     */
+    saveUserData(userData) {
+        return this.users.saveUserData(userData);
+    }
+    /**
+     * 35. 便捷方法：获取用户数据
+     */
+    getUserData() {
+        return this.users.getUserData();
+    }
+    /**
+     * 36. 便捷方法：记住登录信息
+     */
+    rememberLogin(username, password) {
+        return this.users.rememberLogin(username, password);
+    }
+    /**
+     * 37. 便捷方法：获取记住的登录信息
+     */
+    getRememberedLogin() {
+        return this.users.getRememberedLogin();
+    }
+    /**
+     * 38. 便捷方法：清除记住的登录信息
+     */
+    clearRememberedLogin() {
+        return this.users.clearRememberedLogin();
+    }
 }
 
 exports.ArticlesAPI = ArticlesAPI;
@@ -1034,5 +1293,6 @@ exports.GT6Error = GT6Error;
 exports.GT6SDK = GT6SDK;
 exports.ProductsAPI = ProductsAPI;
 exports.SettingsAPI = SettingsAPI;
+exports.UsersAPI = UsersAPI;
 exports.default = GT6SDK;
 //# sourceMappingURL=gt6-sdk.cjs.js.map