@scorehub/auth-sdk 1.3.0 → 1.4.0

package/README.md

@@ -283,6 +283,29 @@ 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

@@ -163,4 +163,13 @@ export declare class AuthClient {
      * 软删除用户 (将状态设为 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

@@ -334,5 +334,24 @@ class AuthClient {
     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.3.0",
+  "version": "1.4.0",
   "description": "Auth-Service SDK for Node.js applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",