qing-client 0.0.17 → 0.0.19

package/README.MD

@@ -0,0 +1,255 @@
+# qing-client
+
+`qing-client` 是一个统一的 JavaScript / TypeScript SDK，用于访问 Qing 平台提供的各类服务能力，包括：
+
+* 用户与认证
+* 消息中心
+* AI / AIGC 能力
+* 静态 HTML 托管（gateway-h5）
+
+该 SDK 为 **公开 npm 包**，任何 **拥有合法账号的第三方开发者** 均可使用。
+
+---
+
+## 特性
+
+* 前后端统一 SDK
+* 支持 浏览器 / H5 / 移动端 / Node.js
+* 自动处理认证与请求头
+* 支持多服务调用
+* 完整 TypeScript 类型定义
+* 支持静态前端托管管理（上传 zip）
+
+---
+
+## 安装
+
+```bash
+npm install qing-client
+```
+
+或
+
+```bash
+yarn add qing-client
+```
+
+---
+
+## 使用模式说明
+
+SDK 根据初始化方式不同，分为 **前端模式** 和 **后端模式**。
+
+### 前端模式（推荐）
+
+适用于：
+
+* 浏览器
+* H5 页面
+* App WebView
+* 移动端前端应用
+
+所有请求会通过 API 网关转发。
+
+### 后端模式
+
+适用于：
+
+* Node.js 服务
+* 后端应用
+* 内部服务调用
+
+请求会直连具体服务地址。
+
+---
+
+## 前端模式示例（客户端 / 移动端）
+
+### 初始化 Client
+
+```ts
+import { Client } from "qing-client";
+
+const client = new Client({
+  gatewayUrl: "https://api.example.com",
+  projectId: "your-project-id",
+  appId: "your-app-id",
+});
+```
+
+### 设置访问令牌
+
+```ts
+await client.setToken("YOUR_ACCESS_TOKEN");
+```
+
+SDK 会自动为所有请求附加：
+
+* `Authorization: Bearer <token>`
+* `x-project-id`
+* `x-app-id`
+
+---
+
+## 后端模式示例（Node.js）
+
+```ts
+import { Client } from "qing-client";
+
+const client = new Client({
+  authServiceUrl: "http://auth-service",
+  userServiceUrl: "http://user-service",
+  gatewayH5ServiceUrl: "http://gateway-h5-service",
+});
+```
+
+### 设置用户上下文（仅后端模式）
+
+```ts
+client.setUserContext({
+  userId: "123",
+  role: "ADMIN",
+  projectId: "project-1",
+});
+```
+
+---
+
+## 用户与认证
+
+### 登录
+
+```ts
+const result = await client.auth.login("username", "password");
+await client.setToken(result.access_token);
+```
+
+---
+
+## 消息与用户服务
+
+```ts
+// 获取当前用户
+const user = await client.user.getCurrentUser();
+
+// 获取消息列表
+const messages = await client.msg.getMessages();
+```
+
+---
+
+## AI / AIGC 示例
+
+```ts
+const response = await client.ai.chatCompletion({
+  sessionId: "session-id",
+  message: "你好",
+});
+```
+
+---
+
+## HTML 静态托管（gateway-h5）
+
+SDK 提供了静态 HTML 托管管理能力，用于上传和管理前端站点。
+
+> ⚠️ **重要说明**
+>
+> 平台 **不会** 帮你构建前端项目
+> 你需要 **自行 build 前端项目**，并将构建产物打包为 `.zip` 上传
+
+---
+
+### 标准流程
+
+1. 使用你自己的前端工具构建项目（如 Vite / Vue / React / Nuxt 静态模式）
+2. 将构建产物打包为 zip
+
+   * `index.html` 必须位于 zip 根目录
+3. 通过 API 上传 zip 进行部署
+
+---
+
+### 创建托管项目
+
+```ts
+import { FrontHostService } from "qing-client";
+
+const fronthost = new FrontHostService({
+  gatewayUrl: "https://api.example.com",
+  projectId: "your-project-id",
+  appId: "your-app-id",
+});
+
+await fronthost.setToken("YOUR_ACCESS_TOKEN");
+
+await fronthost.createProject({
+  deployType: "route",
+  routePath: "/my-app",
+  file: zipFile, // File 或 Blob（.zip）
+});
+```
+
+---
+
+### 部署新版本
+
+```ts
+await fronthost.deployNewVersion(projectId, zipFile);
+```
+
+---
+
+### 支持的部署类型
+
+| 类型          | 说明            |
+| ----------- | ------------- |
+| `route`     | 路径托管，如 `/app` |
+| `subdomain` | 子域名托管         |
+| `proxy`     | 自定义域名托管       |
+
+---
+
+## Token 存储说明
+
+默认情况下，Token 存储在内存中，刷新页面后会丢失。
+
+如需持久化登录状态，可自定义 Token 存储：
+
+```ts
+const client = new Client({
+  gatewayUrl: "...",
+  tokenStorage: {
+    async getToken() {
+      return localStorage.getItem("token") || undefined;
+    },
+    async setToken(token) {
+      localStorage.setItem("token", token);
+    },
+    async clearToken() {
+      localStorage.removeItem("token");
+    },
+  },
+});
+```
+
+---
+
+## TypeScript 支持
+
+SDK 完全使用 TypeScript 编写，并自带类型声明文件。
+
+---
+
+## 安全与隐私
+
+* 不暴露任何内部服务实现
+* 不包含任何敏感信息
+* 所有认证信息由使用方自行提供
+* 适合公开发布到 npm
+
+---
+
+## License
+
+MIT

package/lib/client/BaseClient.js

@@ -125,11 +125,13 @@ class BaseClient {
             case 'auth': return this.config.authServiceUrl;
             case 'msg': return this.config.msgServiceUrl;
             case 'users': return this.config.userServiceUrl;
-            case 'file': return this.config.fileServiceUrl;
+            case 'file': return this.config.fileServiceUrl; // V1 兼容路由
+            case 'files': return this.config.fileServiceUrl; // V2 新路由
             case 'survey': return this.config.surveyServiceUrl;
             case 'token': return this.config.tokenServiceUrl;
             case 'aigc': return this.config.aigcServiceUrl;
             case "logs": return this.config.auditLogServiceUrl;
+            case "gateway-h5": return this.config.gatewayH5ServiceUrl;
             default: throw new Error(`Unsupported service: ${this.serviceName}`);
         }
     }
@@ -229,7 +231,7 @@ class BaseClient {
             return response.data;
         }
         catch (error) {
-            this.handleApiError(error, path);
+            return this.handleApiError(error, path);
         }
     }
     // 统一错误处理方法

package/lib/index.d.ts

@@ -3,10 +3,17 @@ export { AuthService } from './service/AuthService';
 export { MsgService } from './service/MsgService';
 export { TokenService } from './service/TokenService';
 export { UserService } from './service/UserService';
+export { FileService } from './service/FileService';
 export { AigcService } from './service/AigcService';
 export { AuditLogService } from "./service/AuditLogService";
+export { FrontHostService } from "./service/FrontHostService";
 export * from './types';
 export * from './types/msg';
 export * from './types/token';
 export * from './types/user';
+export * from './types/file';
+export * from "./types/fronthost";
+export * from "./types/audit";
+export * from "./types/aigc";
+export { ApiSuccessResponse, ApiErrorResponse, PaginatedResponse, ChatCompletionRequest, ChatCompletionResponse, ChatCompletionStreamResponse, ProviderListItem, ProviderDetail, ProviderModel, ModelListItem, ModelDetail, ModelConfig, CreateAssistantRequest, UpdateAssistantRequest, AssistantResponse, AssistantListResponse, SessionMessage, SessionResponse, SessionListResponse, SessionDetailResponse, SessionStatistics, PaginatedSessionMessageResponse, SessionMessageDetail, BatchDeleteSessionsResponse, AssistantModelsResponse, ModelInfoResponse, AddMessageRequest, SwitchModelRequest, } from "./types/ai";
 export { BaseClient } from './client/BaseClient';

package/lib/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseClient = exports.AuditLogService = exports.AigcService = exports.UserService = exports.TokenService = exports.MsgService = exports.AuthService = exports.Client = void 0;
+exports.BaseClient = exports.FrontHostService = exports.AuditLogService = exports.AigcService = exports.FileService = exports.UserService = exports.TokenService = exports.MsgService = exports.AuthService = exports.Client = void 0;
 // 导出核心客户端类
 var client_1 = require("./client");
 Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return client_1.Client; } });
@@ -27,14 +27,22 @@ var TokenService_1 = require("./service/TokenService");
 Object.defineProperty(exports, "TokenService", { enumerable: true, get: function () { return TokenService_1.TokenService; } });
 var UserService_1 = require("./service/UserService");
 Object.defineProperty(exports, "UserService", { enumerable: true, get: function () { return UserService_1.UserService; } });
+var FileService_1 = require("./service/FileService");
+Object.defineProperty(exports, "FileService", { enumerable: true, get: function () { return FileService_1.FileService; } });
 var AigcService_1 = require("./service/AigcService");
 Object.defineProperty(exports, "AigcService", { enumerable: true, get: function () { return AigcService_1.AigcService; } });
 var AuditLogService_1 = require("./service/AuditLogService");
 Object.defineProperty(exports, "AuditLogService", { enumerable: true, get: function () { return AuditLogService_1.AuditLogService; } });
+var FrontHostService_1 = require("./service/FrontHostService");
+Object.defineProperty(exports, "FrontHostService", { enumerable: true, get: function () { return FrontHostService_1.FrontHostService; } });
 // 导出所有类型定义
 __exportStar(require("./types"), exports);
 __exportStar(require("./types/msg"), exports);
 __exportStar(require("./types/token"), exports);
 __exportStar(require("./types/user"), exports);
+__exportStar(require("./types/file"), exports);
+__exportStar(require("./types/fronthost"), exports);
+__exportStar(require("./types/audit"), exports);
+__exportStar(require("./types/aigc"), exports);
 var BaseClient_1 = require("./client/BaseClient");
 Object.defineProperty(exports, "BaseClient", { enumerable: true, get: function () { return BaseClient_1.BaseClient; } });

package/lib/service/FileService.d.ts

@@ -0,0 +1,33 @@
+import { BaseClient } from "../client/BaseClient";
+import { ClientConfig, RequestOptions, PaginatedResponse } from "../types";
+import { File, CreateFileRequest, UpdateFileRequest, FileListQuery } from "../types/file";
+export declare class FileService extends BaseClient {
+    constructor(config: ClientConfig);
+    /**
+     * 创建文件记录（OSS回调使用）
+     * POST /api/files (网关转发到 /api/v1/files)
+     */
+    createFile(fileData: CreateFileRequest, options?: RequestOptions): Promise<File>;
+    /**
+     * 获取文件详情
+     * GET /api/files/:id (网关转发到 /api/v1/files/:id)
+     */
+    getFileById(fileId: string, options?: RequestOptions): Promise<File>;
+    /**
+     * 更新文件
+     * PUT /api/files/:id (网关转发到 /api/v1/files/:id)
+     */
+    updateFile(fileId: string, updateData: UpdateFileRequest, options?: RequestOptions): Promise<File>;
+    /**
+     * 删除文件
+     * DELETE /api/files/:id (网关转发到 /api/v1/files/:id)
+     */
+    deleteFile(fileId: string, options?: RequestOptions): Promise<{
+        message: string;
+    }>;
+    /**
+     * 获取文件列表
+     * GET /api/files (网关转发到 /api/v1/files)
+     */
+    listFiles(query?: FileListQuery, options?: RequestOptions): Promise<PaginatedResponse<File>>;
+}

package/lib/service/FileService.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileService = void 0;
+const BaseClient_1 = require("../client/BaseClient");
+class FileService extends BaseClient_1.BaseClient {
+    constructor(config) {
+        super(config, 'files');
+    }
+    /**
+     * 创建文件记录（OSS回调使用）
+     * POST /api/files (网关转发到 /api/v1/files)
+     */
+    async createFile(fileData, options) {
+        return this.request('', {
+            ...options,
+            method: 'POST',
+            body: {
+                bucket: fileData.bucket,
+                object: fileData.object,
+                url: fileData.url,
+                taskId: fileData.taskId,
+                size: fileData.size,
+                mimeType: fileData.mimeType,
+                fileExtension: fileData.fileExtension,
+                description: fileData.description,
+                source: fileData.source || '阿里云',
+                acl: fileData.acl || 'private',
+                etag: fileData.etag,
+                contentMd5: fileData.contentMd5,
+                folderId: fileData.folderId
+            }
+        });
+    }
+    /**
+     * 获取文件详情
+     * GET /api/files/:id (网关转发到 /api/v1/files/:id)
+     */
+    async getFileById(fileId, options) {
+        return this.request(`/${fileId}`, {
+            ...options,
+            method: 'GET'
+        });
+    }
+    /**
+     * 更新文件
+     * PUT /api/files/:id (网关转发到 /api/v1/files/:id)
+     */
+    async updateFile(fileId, updateData, options) {
+        return this.request(`/${fileId}`, {
+            ...options,
+            method: 'PUT',
+            body: {
+                acl: updateData.acl,
+                description: updateData.description,
+                folderId: updateData.folderId
+            }
+        });
+    }
+    /**
+     * 删除文件
+     * DELETE /api/files/:id (网关转发到 /api/v1/files/:id)
+     */
+    async deleteFile(fileId, options) {
+        return this.request(`/${fileId}`, {
+            ...options,
+            method: 'DELETE'
+        });
+    }
+    /**
+     * 获取文件列表
+     * GET /api/files (网关转发到 /api/v1/files)
+     */
+    async listFiles(query, options) {
+        const params = {};
+        if (query?.page !== undefined) {
+            params.page = query.page;
+        }
+        if (query?.pageSize !== undefined) {
+            params.pageSize = query.pageSize;
+        }
+        if (query?.folderId !== undefined) {
+            params.folderId = query.folderId;
+        }
+        if (query?.taskId !== undefined) {
+            params.taskId = query.taskId;
+        }
+        if (query?.acl !== undefined) {
+            params.acl = query.acl;
+        }
+        const response = await this.paginatedRequest('', {
+            ...options,
+            method: 'GET',
+            params
+        });
+        return response;
+    }
+}
+exports.FileService = FileService;

package/lib/service/FrontHostService.d.ts

@@ -0,0 +1,37 @@
+import { BaseClient } from "../client/BaseClient";
+import { ClientConfig, RequestOptions } from "../types";
+import { FrontHostCreateProjectInput, FrontHostDomainAvailabilityResponse, FrontHostHealthResponse, FrontHostMessageResponse, FrontHostProject, FrontHostProjectListResponse, FrontHostProjectVersionsResponse } from "../types/fronthost";
+/**
+ * HTML 托管网关（gateway_h5 / fronthost）管理 API
+ *
+ * 部署在 API 网关后面时，建议使用 qing-client 的前端模式（config.gatewayUrl），
+ * 这样 BaseClient 会自动加 x-project-id / x-app-id（与 gateway_h5 verifyGatewayToken 一致）。
+ */
+export declare class FrontHostService extends BaseClient {
+    constructor(config: ClientConfig);
+    /** 健康检查：GET /health */
+    health(options?: RequestOptions): Promise<FrontHostHealthResponse>;
+    /** 子域名可用性：GET /domains/available?subdomain=xx */
+    checkSubdomainAvailability(subdomain: string, options?: RequestOptions): Promise<FrontHostDomainAvailabilityResponse>;
+    /** 项目列表：GET /projects */
+    listProjects(options?: RequestOptions): Promise<FrontHostProjectListResponse>;
+    /** 项目详情：GET /projects/{id} */
+    getProject(id: string, options?: RequestOptions): Promise<FrontHostProject>;
+    /**
+     * 创建项目：POST /projects (multipart/form-data)
+     * - zip 字段名必须是 file（与服务端 r.FormFile("file") 一致）
+     * - 其他字段按 deployType 决定传哪些
+     */
+    createProject(input: FrontHostCreateProjectInput, options?: RequestOptions): Promise<FrontHostProject>;
+    /** 删除项目：DELETE /projects/{id} */
+    deleteProject(id: string, options?: RequestOptions): Promise<FrontHostMessageResponse>;
+    /**
+     * 部署新版本：PUT /projects/{id}/deploy (multipart/form-data)
+     * - 文件字段名固定 file
+     */
+    deployNewVersion(projectId: string, file: Blob | File, options?: RequestOptions): Promise<FrontHostMessageResponse>;
+    /** 版本列表：GET /projects/{id}/versions */
+    getProjectVersions(projectId: string, options?: RequestOptions): Promise<FrontHostProjectVersionsResponse>;
+    /** 回滚版本：POST /projects/{id}/rollback/{version_id} */
+    rollbackVersion(projectId: string, versionId: string, options?: RequestOptions): Promise<FrontHostMessageResponse>;
+}

package/lib/service/FrontHostService.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontHostService = void 0;
+// src/service/FrontHostService.ts
+const BaseClient_1 = require("../client/BaseClient");
+/**
+ * HTML 托管网关（gateway_h5 / fronthost）管理 API
+ *
+ * 部署在 API 网关后面时，建议使用 qing-client 的前端模式（config.gatewayUrl），
+ * 这样 BaseClient 会自动加 x-project-id / x-app-id（与 gateway_h5 verifyGatewayToken 一致）。
+ */
+class FrontHostService extends BaseClient_1.BaseClient {
+    constructor(config) {
+        // 注意：serviceName 会拼出 /api/{serviceName}，因此这里对应 /api/gateway-h5
+        super(config, "gateway-h5");
+    }
+    /** 健康检查：GET /health */
+    async health(options) {
+        return this.request("/health", {
+            ...options,
+            method: "GET",
+        });
+    }
+    /** 子域名可用性：GET /domains/available?subdomain=xx */
+    async checkSubdomainAvailability(subdomain, options) {
+        return this.request("/domains/available", {
+            ...options,
+            method: "GET",
+            params: { subdomain },
+        });
+    }
+    /** 项目列表：GET /projects */
+    async listProjects(options) {
+        return this.request("/projects", {
+            ...options,
+            method: "GET",
+        });
+    }
+    /** 项目详情：GET /projects/{id} */
+    async getProject(id, options) {
+        return this.request(`/projects/${encodeURIComponent(id)}`, {
+            ...options,
+            method: "GET",
+        });
+    }
+    /**
+     * 创建项目：POST /projects (multipart/form-data)
+     * - zip 字段名必须是 file（与服务端 r.FormFile("file") 一致）
+     * - 其他字段按 deployType 决定传哪些
+     */
+    async createProject(input, options) {
+        const form = new FormData();
+        form.append("file", input.file);
+        if (input.name)
+            form.append("name", input.name);
+        form.append("deploy_type", input.deployType);
+        if (input.subdomain)
+            form.append("subdomain", input.subdomain);
+        if (input.domain)
+            form.append("domain", input.domain);
+        if (input.routePath)
+            form.append("route_path", input.routePath);
+        if (input.proxyDomain)
+            form.append("proxy_domain", input.proxyDomain);
+        return this.request("/projects", {
+            ...options,
+            method: "POST",
+            headers: {
+                ...(options?.headers || {}),
+                // 让 axios/浏览器自动带 boundary；这里写上 multipart 意图即可
+                "Content-Type": "multipart/form-data",
+            },
+            body: form,
+        });
+    }
+    /** 删除项目：DELETE /projects/{id} */
+    async deleteProject(id, options) {
+        return this.request(`/projects/${encodeURIComponent(id)}`, {
+            ...options,
+            method: "DELETE",
+        });
+    }
+    /**
+     * 部署新版本：PUT /projects/{id}/deploy (multipart/form-data)
+     * - 文件字段名固定 file
+     */
+    async deployNewVersion(projectId, file, options) {
+        const form = new FormData();
+        form.append("file", file);
+        return this.request(`/projects/${encodeURIComponent(projectId)}/deploy`, {
+            ...options,
+            method: "PUT",
+            headers: {
+                ...(options?.headers || {}),
+                "Content-Type": "multipart/form-data",
+            },
+            body: form,
+        });
+    }
+    /** 版本列表：GET /projects/{id}/versions */
+    async getProjectVersions(projectId, options) {
+        return this.request(`/projects/${encodeURIComponent(projectId)}/versions`, {
+            ...options,
+            method: "GET",
+        });
+    }
+    /** 回滚版本：POST /projects/{id}/rollback/{version_id} */
+    async rollbackVersion(projectId, versionId, options) {
+        return this.request(`/projects/${encodeURIComponent(projectId)}/rollback/${encodeURIComponent(versionId)}`, {
+            ...options,
+            method: "POST",
+        });
+    }
+}
+exports.FrontHostService = FrontHostService;

package/lib/service/MsgService.js

@@ -17,10 +17,19 @@ class MsgService extends BaseClient_1.BaseClient {
     }
     // 发送飞书消息
     async sendFeishuMessage(message, options) {
+        // 兼容旧调用：noticeUser 可能还是 [{ userId: "xxx" }]
+        const noticeUser = message.noticeUser?.map((u) => {
+            const anyU = u;
+            return { user_id: anyU.user_id ?? anyU.userId };
+        }).filter(u => !!u.user_id); // 防止传空值导致服务端校验失败
+        const fixedMessage = {
+            ...message,
+            ...(noticeUser && noticeUser.length ? { noticeUser } : {}),
+        };
         return this.request('/webhook/feishu/send', {
             ...options,
             method: 'POST',
-            body: message
+            body: fixedMessage,
         });
     }
     // === 消息中心相关接口 ===

package/lib/service/UserService.d.ts

@@ -1,6 +1,6 @@
 import { BaseClient } from "../client/BaseClient";
 import { ClientConfig, RequestOptions, PaginatedResponse } from "../types";
-import { User, UserCreateRequest, UserUpdateRequest } from "../types/user";
+import { User, UserCreateRequest, UserUpdateRequest, SelfPasswordChangeRequest, SelfUserUpdateRequest } from "../types/user";
 export declare class UserService extends BaseClient {
     constructor(config: ClientConfig);
     getCurrentUser(options?: RequestOptions): Promise<User>;
@@ -15,4 +15,8 @@ export declare class UserService extends BaseClient {
     resetPassword(userId: number, newPassword: string, options?: RequestOptions): Promise<{
         id: number;
     }>;
+    changeOwnPassword(passwordData: SelfPasswordChangeRequest, options?: RequestOptions): Promise<{
+        id: number;
+    }>;
+    updateCurrentUser(updateData: SelfUserUpdateRequest, options?: RequestOptions): Promise<User>;
 }

package/lib/service/UserService.js

@@ -91,5 +91,28 @@ class UserService extends BaseClient_1.BaseClient {
             }
         });
     }
+    // 修改自己的密码
+    async changeOwnPassword(passwordData, options) {
+        return this.request('/me/password', {
+            ...options,
+            method: 'PUT',
+            body: {
+                old_password: passwordData.old_password,
+                new_password: passwordData.new_password
+            }
+        });
+    }
+    // 更新自己的资料
+    async updateCurrentUser(updateData, options) {
+        return this.request('/me', {
+            ...options,
+            method: 'PUT',
+            body: {
+                name: updateData.name,
+                avatar: updateData.avatar,
+                phone: updateData.phone
+            }
+        });
+    }
 }
 exports.UserService = UserService;

package/lib/types/file.d.ts

@@ -0,0 +1,52 @@
+export interface File {
+    id: string;
+    bucket?: string;
+    object: string;
+    url: string;
+    taskId: string;
+    size?: number;
+    mimeType?: string;
+    fileExtension?: string;
+    description?: string;
+    source: string;
+    acl: 'private' | 'public-read';
+    etag?: string;
+    contentMd5?: string;
+    folderId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateFileRequest {
+    bucket?: string;
+    object: string;
+    url: string;
+    taskId: string;
+    size?: number;
+    mimeType?: string;
+    fileExtension?: string;
+    description?: string;
+    source?: string;
+    acl?: 'private' | 'public-read';
+    etag?: string;
+    contentMd5?: string;
+    folderId?: string;
+}
+export interface UpdateFileRequest {
+    acl?: 'private' | 'public-read';
+    description?: string;
+    folderId?: string | null;
+}
+export interface FileListQuery {
+    page?: number;
+    pageSize?: number;
+    folderId?: string;
+    taskId?: string;
+    acl?: 'private' | 'public-read';
+}
+export interface FileListResponse {
+    data: File[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+}

package/lib/types/file.js

@@ -0,0 +1,4 @@
+"use strict";
+// client/npm/src/types/file.ts
+// 文件模型和请求类型
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/fronthost.d.ts

@@ -0,0 +1,62 @@
+/** 部署类型：子域名 / 路由 / 代理域名 */
+export type FrontHostDeployType = "subdomain" | "route" | "proxy";
+/** 项目（后端返回的视图模型） */
+export interface FrontHostProject {
+    id: string;
+    name: string;
+    /** 对外域名（根据 deploy_type 不同含义略有不同） */
+    domain: string;
+    /** 访问 URL（服务端动态拼出来） */
+    url: string;
+    deployType: FrontHostDeployType;
+    routePath: string;
+    proxyDomain: string;
+    status: string;
+    createdAt: string;
+}
+/** 列表接口返回 */
+export interface FrontHostProjectListResponse {
+    projects: FrontHostProject[];
+}
+/** 创建项目：表单字段（文件用 FormData 传） */
+export interface FrontHostCreateProjectInput {
+    name?: string;
+    deployType: FrontHostDeployType;
+    /** subdomain 模式 */
+    subdomain?: string;
+    domain?: string;
+    /** route 模式 */
+    routePath?: string;
+    /** proxy 模式 */
+    proxyDomain?: string;
+    /** zip 包（字段名必须是 file，与服务端一致） */
+    file: Blob | File;
+}
+/** 版本信息（根据你们服务端 models.ProjectVersion 常见字段做的贴合注解）
+ *  如果服务端字段与你们实际不一致，把这里字段名对齐即可
+ */
+export interface FrontHostProjectVersion {
+    id: string;
+    projectId: string;
+    versionNumber: number;
+    isActive: boolean;
+    deployedAt: string;
+}
+/** 获取项目版本列表 */
+export interface FrontHostProjectVersionsResponse {
+    versions: FrontHostProjectVersion[];
+}
+/** 回滚/删除等简单操作 */
+export interface FrontHostMessageResponse {
+    message: string;
+}
+/** 域名/子域名可用性 */
+export interface FrontHostDomainAvailabilityResponse {
+    subdomain: string;
+    available: boolean;
+}
+/** health */
+export interface FrontHostHealthResponse {
+    status: "ok" | string;
+    timestamp: string;
+}

package/lib/types/fronthost.js

@@ -0,0 +1,3 @@
+"use strict";
+// src/types/fronthost.ts
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/index.d.ts

@@ -30,6 +30,7 @@ export interface ClientConfig {
     tokenServiceUrl?: string;
     aigcServiceUrl?: string;
     auditLogServiceUrl?: string;
+    gatewayH5ServiceUrl?: string;
     tokenStorage?: TokenStorage;
     projectId?: string;
     appId?: string;

package/lib/types/msg.d.ts

@@ -24,7 +24,7 @@ export interface FeishuMessage {
         color?: string;
     }>;
     noticeUser?: Array<{
-        userId: string;
+        user_id: string;
     }>;
     actions?: Array<{
         text: string;

package/lib/types/token.d.ts

@@ -20,12 +20,14 @@ export interface WxSignatureResponse {
 export interface WxMiniProgramTokenResponse {
     access_token: string;
 }
+/**
+ * 微信小程序登录响应（SDK 实际返回值）
+ *
+ * 注意：BaseClient.request 会对后端返回做解包，最终返回 response.data.data
+ * 后端原始结构是 { success, message, data: {...} }，但 SDK 返回的是 data 这一层。
+ */
 export interface WxMiniProgramLoginResponse {
-    success: boolean;
-    message: string;
-    data: {
-        openid: string;
-        session_key: string;
-        unionid?: string | null;
-    };
+    openid: string;
+    session_key: string;
+    unionid?: string | null;
 }

package/lib/types/user.d.ts

@@ -38,6 +38,15 @@ export interface LoginResponse {
 export interface PasswordResetRequest {
     new_password: string;
 }
+export interface SelfPasswordChangeRequest {
+    old_password: string;
+    new_password: string;
+}
+export interface SelfUserUpdateRequest {
+    name?: string;
+    avatar?: string;
+    phone?: string;
+}
 export interface UserOperationResponse {
     id: number;
     message?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qing-client",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "scripts": {