joytalk 0.0.26 → 0.0.27

package/README.md

@@ -40,7 +40,6 @@ pnpm add joytalk
 | `reconnectInterval` | 重连间隔（毫秒） | 否 | 3000 |
 | `maxReconnectAttempts` | 最大重连次数 | 否 | 5 |
 | `responseTimeout` | 响应消息超时时间（毫秒） | 否 | 10000 |
-| `env` | 环境(development, prodtest, production) | 否 | production |
 
 **示例：**
 
@@ -121,7 +120,7 @@ console.log(userInfo);
 
 ---
 
-### 连接到服务器
+### 连接WebSocket
 
 通过 `connect` 方法，连接到服务器。
 
@@ -140,10 +139,25 @@ JTalk.connect(consultationTypeId);
 
 ---
 
-### 监听WebSocket事件
+### 断开WebSocket
+
+通过 `disconnect` 方法，断开WebSocket连接。
+
+**示例：**
+
+```typescript
+JTalk.disconnect();
+```
+---
+
+### 监听消息事件
 
 通过 `on` 方法，监听消息事件。
 
+通过`off` 方法，取消监听消息事件，需传入与 `on` 时相同的回调引用。
+
+通过`removeAllListeners` 方法，移除所有事件监听器。
+
 **示例：**
 
 ```typescript
@@ -188,6 +202,18 @@ JTalk.on(EventType.DISCONNECTED, () => {
   console.log('连接断开');
 });
 
+// 取消监听消息事件
+const callback = (message) => {
+  console.log('收到消息', message);
+};
+JTalk.on(EventType.MESSAGE, callback);
+// 取消监听消息事件
+JTalk.off(EventType.MESSAGE, callback);
+
+// 移除所有事件监听器
+JTalk.removeAllListeners(); // 移除所有事件监听器
+JTalk.removeAllListeners(EventType.MESSAGE); // 移除指定事件类型的事件监听器
+
 ```
 
 **参数说明：**
@@ -234,7 +260,11 @@ JTalk.on(EventType.MESSAGE, (message) => {
     case MessageCode.SEND_SUCCESS:
     case MessageCode.REPLY_SUCCESS:
       // 发送成功/回复成功，msgData 为 MessageData 类型
-      console.log('收到回复消息', msgData)
+      console.log('收到消息', msgData)
+      // 消息类型：ChatType枚举值 文字、图片、视频、文件、FAQ
+      console.log('消息类型', msgData.contentType)
+      // 消息类型：MessageType枚举值 发送、撤回、编辑、系统通知、转接、进线、回复、解绑
+      console.log('消息类型', msgData.msgType)
       break
     case MessageCode.RETRACT:
       // 撤回消息，msgData 为 MessageData 类型
@@ -278,6 +308,23 @@ JTalk.on(EventType.MESSAGE, (message) => {
 - `MessageCode.UNBIND_SUCCESS` - 解绑成功
 - `MessageCode.REMATCH` - 重新匹配
 
+**MessageType 枚举：**
+
+- `MessageType.SEND` - 发送
+- `MessageType.WITHDRAW` - 撤回
+- `MessageType.EDIT` - 编辑
+- `MessageType.SYSTEM_NOTICE` - 系统通知
+- `MessageType.TRANSFER` - 转接
+- `MessageType.INBOUND` - 进线
+- `MessageType.REPLY` - 回复
+- `MessageType.UNBIND` - 解绑
+
+**ChatType 枚举：**
+- `ChatType.TEXT` - 文字
+- `ChatType.IMAGE` - 图片
+- `ChatType.VIDEO` - 视频
+- `ChatType.FILE` - 文件
+- `ChatType.FAQ` - FAQ
 
 ---
 
@@ -429,12 +476,8 @@ await JTalk.sendFaq(faqItem);
 
 ### 其他方法
 
-- **`disconnect(): void`** — 断开连接。示例：`JTalk.disconnect();`
 - **`getStatus(): ConnectionStatus`** — 获取当前连接状态。
 - **`isConnected(): boolean`** — 是否已连接。
-- **`getVideoThumbnail(videoFile: File): Promise<File>`** — 获取视频首帧缩略图，发送视频时建议使用。
-- **`off(event, callback): void`** — 取消监听事件，需传入与 `on` 时相同的回调引用。
-- **公共属性：** `OBS_URL`（OBS 存储地址）、`userInfo`（当前用户信息，只读）。
 
 ### 在 Vue 项目中使用
 
@@ -450,26 +493,35 @@ await JTalk.sendFaq(faqItem);
 import { onMounted, onUnmounted } from 'vue';
 import JoyTalk, { EventType, ChatType } from 'joytalk';
 
-const sdk = new JoyTalk();
+const JTalk = new JoyTalk();
 
 onMounted(async () => {
-  await sdk.init({ token: 'your-token' });
-  sdk.on(EventType.MESSAGE, (message) => console.log('收到消息:', message));
-  await sdk.connect('customer-group-id');
+  JTalk.init({ token: 'your-token' });
+
+  const entranceId = '123456';
+  const consultationList = await JTalk.getConsultationList(entranceId);
+  console.log('咨询列表', consultationList);
+
+  // 获取默认客服组
+  const defaultCustomerGroup = consultationList.list.find((item) => item.isDefault) || consultationList.list[0];
+
+  JTalk.connect(defaultCustomerGroup.id);
+  JTalk.on(EventType.MESSAGE, (message) => console.log('收到消息:', message));
 });
 
 onUnmounted(() => {
-  sdk.disconnect();
+  JTalk.disconnect();
+  JTalk.removeAllListeners();
 });
 
 const sendText = async () => {
-  await sdk.sendText('Hello');
+  await JTalk.sendText('Hello');
 };
 
 const handleFileChange = async (e: Event) => {
   const file = (e.target as HTMLInputElement).files?.[0];
   if (file) {
-    await sdk.sendFile({ file, chatType: ChatType.IMAGE });
+    await JTalk.sendFile({ file, chatType: ChatType.IMAGE });
   }
 };
 </script>
@@ -494,15 +546,19 @@ const handleFileChange = async (e: Event) => {
     const JoyTalk = window.JoyTalk.default;
     const { EventType } = window.JoyTalk;
 
-    const sdk = new JoyTalk();
+    const JTalk = new JoyTalk();
+
+    JTalk.init({ token: 'your-token' });
 
-    sdk.init({ token: 'your-token' }).then(() => {
-      sdk.on(EventType.CONNECTED, () => console.log('连接成功'));
-      sdk.on(EventType.MESSAGE, (message) => console.log('收到消息:', message));
-      return sdk.connect('customer-group-id');
-    }).then(() => {
-      sdk.sendText('你好');
-    });
+    const entranceId = '123456';
+    const consultationList = await JTalk.getConsultationList(entranceId);
+    console.log('咨询列表', consultationList);
+
+    const defaultCustomerGroup = consultationList.list.find((item) => item.isDefault) || consultationList.list[0];
+    JTalk.connect(defaultCustomerGroup.id);
+
+    JTalk.on(EventType.MESSAGE, (message) => console.log('收到消息:', message));
+    JTalk.sendText('你好');
   </script>
 </body>
 </html>
@@ -512,7 +568,7 @@ const handleFileChange = async (e: Event) => {
 
 - 将 `https://your-cdn.com/joytalk/dist/index.umd.js` 替换为实际的 CDN 地址
 - 如果使用本地构建文件，可以使用相对路径：`<script src="./dist/index.umd.js"></script>`
-- 建议使用版本号锁定，如：`https://cdn.example.com/joytalk@0.0.1/dist/index.umd.js`
+
 
 **注意事项：**
 
@@ -523,9 +579,6 @@ const handleFileChange = async (e: Event) => {
 - 如果页面中已经使用了模块化构建工具（如 Webpack、Vite），建议使用 NPM 安装方式而不是 CDN
 
 
-
-
-
 ## 类型定义
 
 SDK 提供完整的 TypeScript 类型定义，可从 `joytalk` 按需导入。
@@ -547,20 +600,4 @@ SDK 提供完整的 TypeScript 类型定义，可从 `joytalk` 按需导入。
 | `HistoryMessagesParams` | 聊天记录查询参数     |
 | `RequestResponse<T>`    | 接口响应包装         |
 
-**消息类型（ChatType）：**
-
-- `ChatType.TEXT` - 文本消息
-- `ChatType.IMAGE` - 图片消息
-- `ChatType.VIDEO` - 视频消息
-- `ChatType.FILE` - 文件消息
-- `ChatType.FAQ` - FAQ 消息
-
-
-
-**匹配状态（MatchStatus）：**
-
-- `MatchStatus.UNMATCHED` - 未匹配
-- `MatchStatus.MATCHING` - 匹配中
-- `MatchStatus.MATCHED` - 已匹配
-- `MatchStatus.UNBIND` - 已解绑
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "joytalk",
-  "version": "0.0.26",
+  "version": "0.0.27",
   "description": "JoyTalk SDK - 用于集成客服功能的 JavaScript SDK",
   "type": "module",
   "scripts": {