qing-client 0.0.53 → 0.0.55

package/README.MD

@@ -10,6 +10,7 @@
 * **提供商与用量**（provider、usage）
 * **组织与多租户**（org）
 * **投递流与 Ez 能力**（deliveryStream、ezAbility）
+* **IM 群组**（im：群组创建、列表、入群门槛等）
 * **静态 HTML 托管**（gateway-h5，frontHost）
 
 该 SDK 为 **公开 npm 包**，任何 **拥有合法账号的第三方开发者** 均可使用。
@@ -142,6 +143,7 @@ const client = new Client({
   gatewayH5ServiceUrl: "http://gateway-h5-service",
   deliveryStreamServiceUrl: "http://delivery-stream-service",
   ezAbilityServiceUrl: "http://ez-ability-service",
+  imServiceUrl: "http://im-service",
 });
 ```
 
@@ -182,6 +184,7 @@ client.setUserContext({
 | `client.frontHost` | 静态 HTML 托管（gateway-h5） |
 | `client.deliveryStream` | 投递流 |
 | `client.ezAbility` | Ez 能力 |
+| `client.im` | IM 群组（群组管理、入群门槛等） |
 
 `client.files` 与 `client.file` 指向同一后端（fileServiceUrl），仅路径前缀不同；也可单独 `import { FileService } from "qing-client"` 并传入配置（如 `new FileService(config, 'files')` 或 `'file'`）。
 
@@ -277,6 +280,7 @@ client.setUserContext({
 - **client.org**：组织/项目/应用 CRUD、解析等，见 `OrgService` 与 `types/org`。
 - **client.deliveryStream**：投递流、版本、需求等，见 `DeliveryStreamService` 与 `types/delivery-stream`。
 - **client.ezAbility**：需求枚举、PRD/MVPRD 生成、任务查询等，见 `EzAbilityService` 与 `types/ez-ability`。
+- **client.im**：群组创建、列表；支持 `pid`/`org_id`、`memberIds`、入群门槛（requireAdmin/requireSuperAdmin），见 `ImService` 与 `types/im`。
 - **client.files / client.file**：文件服务（files 为新路由，file 兼容老项目）；方法同下。
 - **FileService**（独立实例）：`createFile`、`getFileById`、`listFiles`、`getStorageStats`、`generateOSSUploadSign`、`getFolderTree`、`getDownloadUrl` 等，见 `FileService` 与 `types/file`。构造时可选 `new FileService(config, 'files')` 或 `'file'`。
 

package/lib/client/BaseClient.js

@@ -164,6 +164,7 @@ class BaseClient {
             case "org": return this.config.orgServiceUrl; // 组织感知服务
             case "gateway-h5": return this.config.gatewayH5ServiceUrl;
             case "ez-ability": return this.config.ezAbilityServiceUrl; // EzAI 能力服务
+            case "im": return this.config.imServiceUrl; // IM 群组服务
             default: throw new Error(`Unsupported service: ${this.serviceName}`);
         }
     }

package/lib/client/index.d.ts

@@ -12,6 +12,7 @@ import { FrontHostService } from "../service/FrontHostService";
 import { OrgService } from "../service/OrgService";
 import { DeliveryStreamService } from "../service/DeliveryStreamService";
 import { EzAbilityService } from "../service/EzAbilityService";
+import { ImService } from "../service/ImService";
 import { ClientConfig, UserContext } from "../types";
 export declare class Client {
     protected config: ClientConfig;
@@ -32,6 +33,8 @@ export declare class Client {
     readonly org: OrgService;
     readonly deliveryStream: DeliveryStreamService;
     readonly ezAbility: EzAbilityService;
+    /** IM 群组服务（群组创建、列表等） */
+    readonly im: ImService;
     protected isFrontendMode: boolean;
     constructor(config: ClientConfig);
     setUserContext(context: UserContext): this;

package/lib/client/index.js

@@ -15,6 +15,7 @@ const FrontHostService_1 = require("../service/FrontHostService");
 const OrgService_1 = require("../service/OrgService");
 const DeliveryStreamService_1 = require("../service/DeliveryStreamService");
 const EzAbilityService_1 = require("../service/EzAbilityService");
+const ImService_1 = require("../service/ImService");
 class Client {
     constructor(config) {
         this.config = config;
@@ -34,6 +35,7 @@ class Client {
         this.org = new OrgService_1.OrgService(config);
         this.deliveryStream = new DeliveryStreamService_1.DeliveryStreamService(config);
         this.ezAbility = new EzAbilityService_1.EzAbilityService(config);
+        this.im = new ImService_1.ImService(config);
     }
     // 后端模式：设置用户上下文
     setUserContext(context) {
@@ -53,6 +55,7 @@ class Client {
             this.org.setUserContext(context);
             this.deliveryStream.setUserContext(context);
             this.ezAbility.setUserContext(context);
+            this.im.setUserContext(context);
         }
         else {
             console.warn("setUserContext() 仅在后端模式下有效");
@@ -77,6 +80,7 @@ class Client {
             this.org.setProjectId(projectId);
             this.deliveryStream.setProjectId(projectId);
             this.ezAbility.setProjectId(projectId);
+            this.im.setProjectId(projectId);
         }
         else {
             console.warn("setProjectId() 仅在前端模式下有效");
@@ -101,6 +105,7 @@ class Client {
             this.org.setAppId(appId);
             this.deliveryStream.setAppId(appId);
             this.ezAbility.setAppId(appId);
+            this.im.setAppId(appId);
         }
         else {
             console.warn("setAppId() 仅在前端模式下有效");
@@ -125,6 +130,7 @@ class Client {
             this.org.setProjectAndApp(projectId, appId);
             this.deliveryStream.setProjectAndApp(projectId, appId);
             this.ezAbility.setProjectAndApp(projectId, appId);
+            this.im.setProjectAndApp(projectId, appId);
         }
         else {
             console.warn("setProjectAndApp() 仅在前端模式下有效");
@@ -148,6 +154,7 @@ class Client {
         await this.org.setToken(token);
         await this.deliveryStream.setToken(token);
         await this.ezAbility.setToken(token);
+        await this.im.setToken(token);
     }
     // 清除认证令牌（两种模式都需要）
     async clearToken() {
@@ -166,6 +173,7 @@ class Client {
         await this.org.clearToken();
         await this.deliveryStream.clearToken();
         await this.ezAbility.clearToken();
+        await this.im.clearToken();
     }
 }
 exports.Client = Client;

package/lib/index.d.ts

@@ -12,6 +12,7 @@ export { UsageService } from "./service/UsageService";
 export { OrgService } from "./service/OrgService";
 export { DeliveryStreamService } from "./service/DeliveryStreamService";
 export { EzAbilityService } from "./service/EzAbilityService";
+export { ImService } from "./service/ImService";
 export * from './types';
 export * from './types/msg';
 export * from './types/token';
@@ -27,3 +28,4 @@ export * from "./types/usage";
 export * from "./types/org";
 export * from "./types/delivery-stream";
 export * from "./types/ez-ability";
+export * from "./types/im";

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.EzAbilityService = exports.DeliveryStreamService = exports.OrgService = exports.UsageService = exports.ProviderService = exports.FrontHostService = exports.AuditLogService = exports.AigcService = exports.FileService = exports.UserService = exports.TokenService = exports.MsgService = exports.AuthService = exports.Client = void 0;
+exports.BaseClient = exports.ImService = exports.EzAbilityService = exports.DeliveryStreamService = exports.OrgService = exports.UsageService = exports.ProviderService = 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; } });
@@ -45,6 +45,8 @@ var DeliveryStreamService_1 = require("./service/DeliveryStreamService");
 Object.defineProperty(exports, "DeliveryStreamService", { enumerable: true, get: function () { return DeliveryStreamService_1.DeliveryStreamService; } });
 var EzAbilityService_1 = require("./service/EzAbilityService");
 Object.defineProperty(exports, "EzAbilityService", { enumerable: true, get: function () { return EzAbilityService_1.EzAbilityService; } });
+var ImService_1 = require("./service/ImService");
+Object.defineProperty(exports, "ImService", { enumerable: true, get: function () { return ImService_1.ImService; } });
 // 导出所有类型定义
 __exportStar(require("./types"), exports);
 __exportStar(require("./types/msg"), exports);
@@ -61,3 +63,4 @@ __exportStar(require("./types/usage"), exports);
 __exportStar(require("./types/org"), exports);
 __exportStar(require("./types/delivery-stream"), exports);
 __exportStar(require("./types/ez-ability"), exports);
+__exportStar(require("./types/im"), exports);

package/lib/service/ImService.d.ts

@@ -0,0 +1,19 @@
+import { BaseClient } from "../client/BaseClient";
+import { ClientConfig, RequestOptions, PaginatedResponse } from "../types";
+import { Group, CreateGroupRequest, GroupListQuery } from "../types/im";
+/**
+ * IM 群组服务 SDK（im-service /api/v1/groups）
+ */
+export declare class ImService extends BaseClient {
+    constructor(config: ClientConfig);
+    /**
+     * 创建群组
+     * POST /groups
+     */
+    createGroup(request: CreateGroupRequest, options?: RequestOptions): Promise<Group>;
+    /**
+     * 群组列表（当前项目+组织下）
+     * GET /groups
+     */
+    listGroups(query?: GroupListQuery, options?: RequestOptions): Promise<PaginatedResponse<Group>>;
+}

package/lib/service/ImService.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImService = void 0;
+const BaseClient_1 = require("../client/BaseClient");
+/**
+ * IM 群组服务 SDK（im-service /api/v1/groups）
+ */
+class ImService extends BaseClient_1.BaseClient {
+    constructor(config) {
+        super(config, "im");
+    }
+    /**
+     * 创建群组
+     * POST /groups
+     */
+    async createGroup(request, options) {
+        return this.request("/groups", {
+            ...options,
+            method: "POST",
+            body: request,
+        });
+    }
+    /**
+     * 群组列表（当前项目+组织下）
+     * GET /groups
+     */
+    async listGroups(query, options) {
+        return this.paginatedRequest("/groups", {
+            ...options,
+            method: "GET",
+            params: query,
+        });
+    }
+}
+exports.ImService = ImService;

package/lib/types/im.d.ts

@@ -0,0 +1,28 @@
+export interface Group {
+    id: string;
+    name: string;
+    pid: string;
+    org_id: string;
+    ownerId: string;
+    description?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateGroupRequest {
+    name: string;
+    description?: string;
+}
+export interface GroupListQuery {
+    page?: number;
+    pageSize?: number;
+}
+/** 群组列表返回格式（im-service 使用 data + pagination） */
+export interface GroupListResult {
+    data: Group[];
+    pagination: {
+        page: number;
+        per_page: number;
+        total: number;
+        total_pages: number;
+    };
+}

package/lib/types/im.js

@@ -0,0 +1,4 @@
+"use strict";
+// client/npm/src/types/im.ts
+// IM 群组服务类型（与 im-service /api/v1/groups 一致）
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/index.d.ts

@@ -35,6 +35,7 @@ export interface ClientConfig {
     orgServiceUrl?: string;
     deliveryStreamServiceUrl?: string;
     ezAbilityServiceUrl?: string;
+    imServiceUrl?: string;
     tokenStorage?: TokenStorage;
     projectId?: string;
     orgId?: string;

package/package.json

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