@scorehub/auth-sdk 1.2.0 → 1.3.0

package/README.md

@@ -259,6 +259,30 @@ 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')`。
+
 ---
 
 ## 框架中间件

package/dist/auth-client.d.ts

@@ -155,4 +155,12 @@ 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>;
 }

package/dist/auth-client.js

@@ -308,5 +308,31 @@ 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');
+    }
 }
 exports.AuthClient = AuthClient;

package/package.json

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