@scorehub/auth-sdk 1.2.0 → 1.4.0

package/README.md

@@ -259,6 +259,53 @@ const user = await authClient.adminCreateUser({
 await authClient.adminResetPassword('user-uuid', 'NewPassword123');
 ```
 
+### 设置用户状态
+
+```typescript
+// 将用户状态设为 DISABLED（禁用）
+await authClient.setUserStatus('user-uuid', 'DISABLED');
+
+// 将用户状态恢复为 ACTIVE（启用）
+await authClient.setUserStatus('user-uuid', 'ACTIVE');
+
+// 将用户状态设为 DELETED（软删除）
+await authClient.setUserStatus('user-uuid', 'DELETED');
+```
+
+> 状态枚举：`ACTIVE`（正常）、`DISABLED`（禁用）、`DELETED`（已删除）。
+> 使用 service token 鉴权，适合后台管理系统调用。
+
+### 删除用户（软删除）
+
+```typescript
+await authClient.deleteUser('user-uuid');
+```
+
+> 软删除：将用户状态设为 `DELETED`，保留数据用于审计，不物理删除。等效于 `setUserStatus(userId, 'DELETED')`。
+
+### 管理端修改用户信息
+
+```typescript
+// 修改用户名
+await authClient.adminUpdateUser('user-uuid', { username: 'new_username' });
+
+// 修改手机号
+await authClient.adminUpdateUser('user-uuid', { mobile: '13900139001' });
+
+// 修改真实姓名
+await authClient.adminUpdateUser('user-uuid', { realname: '张三' });
+
+// 同时修改多个字段
+await authClient.adminUpdateUser('user-uuid', {
+  username: 'new_username',
+  mobile: '13900139001',
+  realname: '张三',
+});
+```
+
+> 使用 service token 鉴权，无需短信验证码，适合后台管理系统调用。
+> `username` 和 `mobile` 唯一，冲突时抛出 409 错误（`err.authCode` 对应业务错误码）。
+
 ---
 
 ## 框架中间件

package/dist/auth-client.d.ts

@@ -155,4 +155,21 @@ export declare class AuthClient {
      * 发送短信验证码
      */
     sendSmsCode(mobile: string, type?: number): Promise<void>;
+    /**
+     * 更新用户状态 (service token 鉴权)
+     */
+    setUserStatus(userId: string, status: 'ACTIVE' | 'DISABLED' | 'DELETED'): Promise<void>;
+    /**
+     * 软删除用户 (将状态设为 DELETED，保留数据用于审计)
+     */
+    deleteUser(userId: string): Promise<void>;
+    /**
+     * 管理端修改用户信息 (service token 鉴权，无需短信验证码)
+     * 支持修改 username、mobile、realname，字段均可选
+     */
+    adminUpdateUser(userId: string, data: {
+        username?: string;
+        mobile?: string;
+        realname?: string;
+    }): Promise<void>;
 }

package/dist/auth-client.js

@@ -308,5 +308,50 @@ class AuthClient {
             throw err;
         }
     }
+    /**
+     * 更新用户状态 (service token 鉴权)
+     */
+    async setUserStatus(userId, status) {
+        const token = await this.getServiceToken();
+        const response = await fetch(`${this.serviceUrl}/users/${userId}/status`, {
+            method: 'PATCH',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${token}`,
+            },
+            body: JSON.stringify({ status }),
+        });
+        if (!response.ok) {
+            const result = await response.json();
+            const err = new Error(result.message || 'Set user status failed');
+            err.authCode = result.code;
+            throw err;
+        }
+    }
+    /**
+     * 软删除用户 (将状态设为 DELETED，保留数据用于审计)
+     */
+    async deleteUser(userId) {
+        return this.setUserStatus(userId, 'DELETED');
+    }
+    /**
+     * 管理端修改用户信息 (service token 鉴权，无需短信验证码)
+     * 支持修改 username、mobile、realname，字段均可选
+     */
+    async adminUpdateUser(userId, data) {
+        var _a;
+        const token = await this.getServiceToken();
+        const response = await fetch(`${this.serviceUrl}/users/${userId}/profile`, {
+            method: 'PATCH',
+            headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${token}` },
+            body: JSON.stringify(data),
+        });
+        if (!response.ok) {
+            const body = await response.json().catch(() => ({}));
+            const err = new Error((_a = body.message) !== null && _a !== void 0 ? _a : '修改用户信息失败');
+            err.authCode = body.code;
+            throw err;
+        }
+    }
 }
 exports.AuthClient = AuthClient;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scorehub/auth-sdk",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Auth-Service SDK for Node.js applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",