joytalk 0.0.21 → 0.0.23

package/README.md

@@ -29,6 +29,7 @@ pnpm add joytalk
 ## API 方法
 
 ### 初始化
+
 初始化 SDK，传入 token 等配置。**使用前必须调用一次。**
 
 **参数说明：**
@@ -39,8 +40,10 @@ pnpm add joytalk
 | `reconnectInterval` | 重连间隔（毫秒） | 否 | 3000 |
 | `maxReconnectAttempts` | 最大重连次数 | 否 | 5 |
 | `responseTimeout` | 响应消息超时时间（毫秒） | 否 | 10000 |
+| `env` | 环境(development, prodtest, production) | 否 | production |
 
 **示例：**
+
 ```typescript
 import JoyTalk, { EventType, ChatType, MessageCode } from 'joytalk';
 
@@ -48,16 +51,19 @@ import JoyTalk, { EventType, ChatType, MessageCode } from 'joytalk';
 const JTalk = new JoyTalk();
 
 // 初始化：传入 token 等配置（必须在使用前调用）
-await JTalk.init({
+JTalk.init({
   token: 'your-token',
 });
 ```
 
+---
+
 ### 获取咨询列表
-通过 `getConsultationList` 方法，传入入口ID，获取咨询列表。
 
+通过 `getConsultationList` 方法，传入入口 ID，获取咨询列表。
 
 **示例：**
+
 ```typescript
 const entranceId = '123456';
 // 获取咨询列表
@@ -79,20 +85,22 @@ console.log(result);
 
 **ConsultationItem 类型定义：**
 
-| 参数 | 说明 |
-|------|------|
-| `id` | 咨询类型 ID |
-| `customerGroupId` | 客服组 ID |
-| `guideText` | 引导文案 |
-| `name` | 咨询类型名称 |
-| `isDefault` | 是否默认 |
+| 参数              | 说明         |
+| ----------------- | ------------ |
+| `id`              | 咨询类型 ID  |
+| `customerGroupId` | 客服组 ID    |
+| `guideText`       | 引导文案     |
+| `name`            | 咨询类型名称 |
+| `isDefault`       | 是否默认     |
 
 ---
 
 ### 获取用户信息
+
 通过 `getUserInfo` 方法，获取用户信息。
 
 **示例：**
+
 ```typescript
 // 获取用户信息
 const userInfo = await JTalk.getUserInfo();
@@ -102,21 +110,23 @@ console.log(userInfo);
 **返回值说明：**
 | 参数 | 说明 |
 |------|------|
-| `uuid` | 用户ID |
-| `merchantId` | 商户ID |
+| `uuid` | 用户 ID |
+| `merchantId` | 商户 ID |
 | `nickname` | 用户昵称 |
 | `avatar` | 用户头像 |
 | `userSource` | 用户来源 |
-| `externalUserId` | 外部用户ID |
-| `userIp` | 用户IP |
+| `externalUserId` | 外部用户 ID |
+| `userIp` | 用户 IP |
 | `isAnonymous` | 是否匿名 |
 
 ---
 
 ### 连接到服务器
+
 通过 `connect` 方法，连接到服务器。
 
 **示例：**
+
 ```typescript
 const consultationTypeId = '123456';
 // 连接到服务器
@@ -130,10 +140,12 @@ JTalk.connect(consultationTypeId);
 
 ---
 
-### 监听消息事件
+### 监听WebSocket事件
+
 通过 `on` 方法，监听消息事件。
 
 **示例：**
+
 ```typescript
 // 监听连接事件
 JTalk.on(EventType.CONNECTED, () => {
@@ -143,7 +155,7 @@ JTalk.on(EventType.CONNECTED, () => {
 // 监听消息事件
 JTalk.on(EventType.MESSAGE, (message) => {
   console.log('收到消息:', message);
-  
+
   // 根据消息类型处理
   switch (message.code) {
     case MessageCode.SEND_SUCCESS:
@@ -166,6 +178,16 @@ JTalk.on(EventType.STATUS_CHANGE, (status) => {
   console.log('连接状态变化:', status);
 });
 
+// 监听心跳超时事件
+JTalk.on(EventType.HEARTBEAT_TIMEOUT, () => {
+  console.log('心跳超时');
+});
+
+// 监听连接断开事件
+JTalk.on(EventType.DISCONNECTED, () => {
+  console.log('连接断开');
+});
+
 ```
 
 **参数说明：**
@@ -175,6 +197,7 @@ JTalk.on(EventType.STATUS_CHANGE, (status) => {
 | `callback` | 回调函数 | 是 | - |
 
 **EventType 枚举：**
+
 - `EventType.CONNECTED` - 连接成功
 - `EventType.DISCONNECTED` - 连接断开
 - `EventType.ERROR` - 发生错误
@@ -182,27 +205,123 @@ JTalk.on(EventType.STATUS_CHANGE, (status) => {
 - `EventType.STATUS_CHANGE` - 连接状态变化
 - `EventType.HEARTBEAT_TIMEOUT` - 心跳超时
 
+---
+### 消息处理示例
+
+通过监听 `EventType.MESSAGE`，根据 `message.code` 区分消息类型并处理。
+
+**示例：**
+
+```typescript
+JTalk.on(EventType.MESSAGE, (message) => {
+  const msgData = message.data
+  // 根据消息类型处理
+  switch (message.code) {
+    case MessageCode.MATCH_INFO:
+    case MessageCode.MATCH_SUCCESS:
+    case MessageCode.TRANSFER_USER_SUCCESS:
+    case MessageCode.REMATCH:
+      // 匹配成功/分配成功/转接成功/重新匹配，msgData 为 SessionData 类型
+      sessionData.value = msgData
+      if (message.code === MessageCode.MATCH_INFO || message.code === MessageCode.MATCH_SUCCESS) {
+        // 匹配成功/分配成功，获取聊天记录
+        getHistoryMessages()
+      }
+      break
+    case MessageCode.MATCH_FAIL:
+      console.error(message.msg || '匹配失败')
+      break
+    case MessageCode.SEND_SUCCESS:
+    case MessageCode.REPLY_SUCCESS:
+      // 发送成功/回复成功，msgData 为 MessageData 类型
+      console.log('收到回复消息', msgData)
+      break
+    case MessageCode.RETRACT:
+      // 撤回消息，msgData 为 MessageData 类型
+      console.log('收到撤回消息', msgData)
+      console.log('撤回消息的 messageId', messageId)
+      break
+    case MessageCode.EDIT:
+      // 编辑消息，msgData 为 MessageData 类型
+      console.log('收到编辑消息', msgData)
+      console.log('编辑消息的 messageId', messageId)
+      console.log('编辑后消息的内容', msgData.content)
+      break
+    default:
+      console.log('收到其他消息', msgData)
+      break
+  }
+});
+```
+
 **MessageCode 枚举：**
+
 - `MessageCode.CONNECT_SUCCESS` - 连接成功
 - `MessageCode.CONNECT_FAILED` - 连接失败
-- `MessageCode.MATCH_INFO` / `MessageCode.MATCH_SUCCESS` - 匹配成功
+- `MessageCode.TRANSFER_CUSTOMER_SUCCESS` - 转接成功通知原客服
+- `MessageCode.TRANSFER_TO_CUSTOMER_SUCCESS` - 转接成功通知转接客服
+- `MessageCode.TRANSFER_USER_SUCCESS` - 转接成功通知用户
+- `MessageCode.TRANSFER_FAIL` - 转接失败
 - `MessageCode.MATCH_FAIL` - 匹配失败
-- `MessageCode.SEND_SUCCESS` - 发送成功
-- `MessageCode.SEND_CALLBACK` - 发送回调
+- `MessageCode.MATCH_INFO` - 匹配成功，返回信息
+- `MessageCode.MATCH_SUCCESS` - 分配成功
 - `MessageCode.RETRACT` - 撤回
+- `MessageCode.RETRACT_FAIL` - 撤回失败
 - `MessageCode.EDIT` - 编辑
-- `MessageCode.TRANSFER_*` - 转接相关
+- `MessageCode.EDIT_FAIL` - 编辑失败
 - `MessageCode.COMMON_FAIL` - 通用错误
+- `MessageCode.SEND_SUCCESS` - 发送成功
+- `MessageCode.SEND_CALLBACK` - 发送回调
+- `MessageCode.CHANGE_CHAT_STATUS` - 变更会话状态
+- `MessageCode.REPLY_FAIL` - 回复消息失败
+- `MessageCode.REPLY_SUCCESS` - 回复消息成功
+- `MessageCode.UNBIND_SUCCESS` - 解绑成功
+- `MessageCode.REMATCH` - 重新匹配
+
+
+---
+
+### 获取聊天记录
+
+通过 `getHistoryMessages` 方法，获取聊天记录。
+**注意：该方法需在已匹配客服后调用。**
+
+**示例：**
+
+```typescript
+const getHistoryMessages = async (lastMsgId?: string) => {
+  const { list, hasMore } = await JTalk.getHistoryMessages({ lastMsgId, size: 50 });
+  console.log(list, hasMore);
+  return { list, hasMore };
+};
+```
+
+**参数说明：**
+
+| 参数        | 说明                  | 是否必填 | 默认值 |
+| ----------- | --------------------- | -------- | ------ |
+| `lastMsgId` | 上一页最后一条消息 ID | 否       | -      |
+| `size`      | 每页条数              | 否       | 50     |
+
+**返回值说明：**
+
+| 返回值    | 说明           |
+| --------- | -------------- |
+| `list`    | 消息列表       |
+| `hasMore` | 是否有更多数据 |
 
 ---
 
 ### 发送文本消息
+
 通过 `sendText` 方法，发送文本消息。
 
 **示例：**
+
 ```typescript
-const content = '你好，我需要帮助';
-JTalk.sendText(content);
+const content = '你好！';
+const { messageId } = await JTalk.sendText(content);
+console.log(messageId);
 ```
 
 **参数说明：**
@@ -210,77 +329,101 @@ JTalk.sendText(content);
 |------|------|----------|--------|
 | `content` | 消息内容 | 是 | - |
 
-### 发送文件消息（图片 / 文件）
-通过 `sendFile` 方法，发送图片或普通文件消息（视频见下方「发送视频消息」）。
+**返回值说明：**
+
+| 返回值      | 说明    |
+| ----------- | ------- |
+| `messageId` | 消息 ID |
+
+---
+
+### 发送文件消息（图片 / 视频 / 文件）
+
+通过 `sendFile` 方法，发送图片、视频或普通文件消息。
 
 **示例：**
+
 ```typescript
 // 发送图片
 const file = document.querySelector('input[type="file"]').files?.[0];
 if (file) {
-  await JTalk.sendFile({ file, chatType: ChatType.IMAGE });
+  const { messageId } = await JTalk.sendFile({ file, chatType: ChatType.IMAGE });
+  console.log(messageId);
 }
-// 发送文件
-await JTalk.sendFile({ file: docFile, chatType: ChatType.FILE });
-```
 
-**参数说明：**
-
-| 参数 | 说明 | 是否必填 | 默认值 |
-|------|------|----------|--------|
-| `file` | 文件对象 | 是 | - |
-| `chatType` | 聊天类型：`ChatType.IMAGE` 或 `ChatType.FILE` | 是 | - |
-
-### 发送视频消息
-通过 `sendFile` 方法并传入 `ChatType.VIDEO`，发送视频消息。建议先用 `getVideoThumbnail` 生成缩略图再发送。
-
-**示例：**
-```typescript
+// 发送视频
 const videoFile = document.querySelector('input[type="file"]').files?.[0];
 if (videoFile) {
+  // 获取视频缩略图
   const thumbnailFile = await JTalk.getVideoThumbnail(videoFile);
-  await JTalk.sendFile({
-    file: videoFile,
-    thumbnailFile,
-    chatType: ChatType.VIDEO,
-  });
+  const { messageId } = await JTalk.sendFile({ file: videoFile, thumbnailFile, chatType: ChatType.VIDEO });
+  console.log(messageId);
+}
+
+// 发送文件
+const file = document.querySelector('input[type="file"]').files?.[0];
+if (file) {
+  const { messageId } = await JTalk.sendFile({ file, chatType: ChatType.FILE });
+  console.log(messageId);
 }
 ```
 
 **参数说明：**
 
-| 参数 | 说明 | 是否必填 | 默认值 |
-|------|------|----------|--------|
-| `file` | 视频文件对象 | 是 | - |
-| `thumbnailFile` | 缩略图文件（可选，建议使用 getVideoThumbnail 生成） | 否 | - |
-| `chatType` | 固定为 `ChatType.VIDEO` | 是 | - |
+| 参数            | 说明                                                              | 是否必填 | 默认值 |
+| --------------- | ----------------------------------------------------------------- | -------- | ------ |
+| `file`          | 文件对象                                                          | 是       | -      |
+| `thumbnailFile` | 缩略图文件（可选，建议使用 getVideoThumbnail 生成）               | 否       | -      |
+| `chatType`      | 聊天类型：`ChatType.IMAGE` 或 `ChatType.VIDEO` 或 `ChatType.FILE` | 是       | -      |
 
-### 获取聊天记录
-通过 `getHistoryMessages` 方法，获取聊天记录。需在已匹配客服后调用。
+**返回值说明：**
+
+| 返回值      | 说明    |
+| ----------- | ------- |
+| `messageId` | 消息 ID |
+
+---
+
+### 发送 FAQ 消息
+
+点击 FAQ 问题时，通过 `sendFaq` 方法，将该 FAQ 问题对象作为参数传入，SDK 会自动返回该 FAQ 问题的答案。
 
 **示例：**
+
 ```typescript
-const { list, hasMore } = await JTalk.getHistoryMessages({ size: 50 });
-// 加载更多
-const next = await JTalk.getHistoryMessages({
-  lastMsgId: list[0]?.messageId,
-  size: 50,
-});
+const faqItem = {
+  faqId: 1,
+  faqItemId: 1,
+  id: 1,
+  imageUrl: ['https://example.com/image.jpg'],
+  question: '问题',
+  answer: '答案',
+  sortOrder: 1,
+  isMulti: false,
+  item: [],
+};
+await JTalk.sendFaq(faqItem);
 ```
 
 **参数说明：**
 
-| 参数 | 说明 | 是否必填 | 默认值 |
-|------|------|----------|--------|
-| `lastMsgId` | 上一页最后一条消息 ID | 否 | - |
-| `size` | 每页条数 | 否 | 50 |
+| 参数      | 说明         | 是否必填 | 默认值 |
+| --------- | ------------ | -------- | ------ |
+| `faqItem` | FAQ 问题对象 | 是       | -      |
 
-**返回值说明：**
+**FaqItem 类型定义：**
 
-| 返回值 | 说明 |
-|--------|------|
-| `list` | 消息列表 |
-| `hasMore` | 是否有更多数据 |
+| 参数        | 说明          |
+| ----------- | ------------- |
+| `faqId`     | FAQ ID        |
+| `faqItemId` | FAQ 项 ID     |
+| `id`        | ID            |
+| `imageUrl`  | 图片 URL 列表 |
+| `question`  | 问题          |
+| `answer`    | 答案          |
+| `sortOrder` | 排序          |
+| `isMulti`   | 是否多选      |
+| `item`      | 子项          |
 
 ---
 
@@ -290,7 +433,6 @@ const next = await JTalk.getHistoryMessages({
 - **`getStatus(): ConnectionStatus`** — 获取当前连接状态。
 - **`isConnected(): boolean`** — 是否已连接。
 - **`getVideoThumbnail(videoFile: File): Promise<File>`** — 获取视频首帧缩略图，发送视频时建议使用。
-- **`sendFaq(faqItem: FaqItem): void`** — 发送 FAQ 消息。
 - **`off(event, callback): void`** — 取消监听事件，需传入与 `on` 时相同的回调引用。
 - **公共属性：** `OBS_URL`（OBS 存储地址）、`userInfo`（当前用户信息，只读）。
 
@@ -366,252 +508,59 @@ const handleFileChange = async (e: Event) => {
 </html>
 ```
 
-#### 完整示例
-
-```html
-<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>客服 SDK 示例</title>
-  <!-- 引入 SDK -->
-  <script src="https://your-cdn.com/joytalk/dist/index.umd.js"></script>
-</head>
-<body>
-  <div id="app">
-    <button id="connectBtn">连接</button>
-    <button id="sendBtn">发送消息</button>
-    <input type="file" id="fileInput" accept="image/*,video/*" />
-  </div>
-
-  <script>
-    (async function () {
-      const JoyTalk = window.JoyTalk.default;
-      const { EventType, ChatType, MessageCode, ConnectionStatus, MessageType } = window.JoyTalk;
-
-      const sdk = new JoyTalk();
-
-      await sdk.init({
-        token: 'your-token',
-        autoReconnect: true,
-        reconnectInterval: 3000,
-        maxReconnectAttempts: 5,
-        responseTimeout: 10000,
-      });
-
-      sdk.on(EventType.CONNECTED, () => {
-        console.log('已连接到服务器');
-      });
-
-    // 监听消息事件
-    sdk.on(EventType.MESSAGE, (message) => {
-      console.log('收到消息:', message);
-      
-      // 根据消息类型处理
-      switch (message.code) {
-        case MessageCode.SEND_SUCCESS:
-          console.log('消息发送成功:', message.data);
-          break;
-        case MessageCode.MATCH_SUCCESS:
-          console.log('匹配成功:', message.data);
-          break;
-        // ... 其他消息类型
-      }
-    });
-
-    // 监听错误事件
-    sdk.on(EventType.ERROR, (error) => {
-      console.error('发生错误:', error);
-    });
-
-    // 监听状态变化
-    sdk.on(EventType.STATUS_CHANGE, (status) => {
-      console.log('连接状态变化:', status);
-    });
-
-    // 连接按钮
-    document.getElementById('connectBtn').addEventListener('click', async () => {
-      try {
-        await sdk.connect('customer-group-id');
-        console.log('连接成功');
-      } catch (error) {
-        console.error('连接失败:', error);
-      }
-    });
-
-    // 发送消息按钮
-    document.getElementById('sendBtn').addEventListener('click', async () => {
-      try {
-        await sdk.sendText('你好，我需要帮助');
-      } catch (error) {
-        console.error('发送失败:', error);
-      }
-    });
-
-    // 文件上传
-    document.getElementById('fileInput').addEventListener('change', async (e) => {
-      const file = e.target.files[0];
-      if (!file) return;
-
-      try {
-        if (file.type.startsWith('image/')) {
-          // 发送图片
-          await sdk.sendFile({
-            file: file,
-            chatType: ChatType.IMAGE,
-          });
-        } else if (file.type.startsWith('video/')) {
-          // 发送视频（自动生成缩略图）
-          const thumbnailFile = await sdk.getVideoThumbnail(file);
-          await sdk.sendFile({
-            file: file,
-            thumbnailFile: thumbnailFile,
-            chatType: ChatType.VIDEO,
-          });
-        } else {
-          // 发送文件
-          await sdk.sendFile({
-            file: file,
-            chatType: ChatType.FILE,
-          });
-        }
-        console.log('文件发送成功');
-      } catch (error) {
-        console.error('文件发送失败:', error);
-      }
-    });
-
-    // 获取用户信息示例
-    async function loadUserInfo() {
-      try {
-        const userInfo = await sdk.getUserInfo();
-        console.log('用户信息:', userInfo);
-        // 可以在页面上显示用户信息
-        // document.getElementById('userName').textContent = userInfo.nickname;
-      } catch (error) {
-        console.error('获取用户信息失败:', error);
-      }
-    }
-
-    // 获取咨询列表示例
-    async function loadConsultationList(entranceId) {
-      try {
-        const result = await sdk.getConsultationList(entranceId);
-        console.log('咨询列表:', result.data.list);
-        // 可以在页面上显示咨询列表
-      } catch (error) {
-        console.error('获取咨询列表失败:', error);
-      }
-    }
-
-    // 页面加载完成后可以调用
-    // loadUserInfo();
-    // loadConsultationList(123);
-    })();
-  </script>
-</body>
-</html>
-```
-
 **CDN 地址说明：**
+
 - 将 `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`
 
 **注意事项：**
+
 - CDN 引入后，SDK 会挂载到 `window.JoyTalk` 全局对象上
 - 默认导出（`default`）是 `JoyTalk` 类，通过 `window.JoyTalk.default` 访问
 - 所有枚举和类型都可以从 `window.JoyTalk` 中获取，如 `EventType`、`ChatType`、`MessageCode`、`ConnectionStatus`、`MessageType` 等
 - 确保 CDN 地址可访问，并且版本正确
 - 如果页面中已经使用了模块化构建工具（如 Webpack、Vite），建议使用 NPM 安装方式而不是 CDN
 
-### 配置选项（SDKConfig）
 
-初始化时通过 `init(config)` 传入的配置项。参数说明见上方「初始化」表格。
 
-**事件类型（EventType）：**
-- `EventType.CONNECTED` - 连接成功
-- `EventType.DISCONNECTED` - 连接断开
-- `EventType.ERROR` - 发生错误
-- `EventType.MESSAGE` - 收到消息
-- `EventType.STATUS_CHANGE` - 连接状态变化
-- `EventType.HEARTBEAT_TIMEOUT` - 心跳超时
+
+
+## 类型定义
+
+SDK 提供完整的 TypeScript 类型定义，可从 `joytalk` 按需导入。
+
+| 类型名                  | 说明                 |
+| ----------------------- | -------------------- |
+| `MessageData`           | 消息数据（联合类型） |
+| `TextMessageData`       | 文本消息数据         |
+| `FileMessageData`       | 文件消息数据         |
+| `FaqMessageData`        | FAQ 消息数据         |
+| `SessionData`           | 会话数据             |
+| `UserInfo`              | 用户信息             |
+| `ChatType`              | 聊天类型枚举         |
+| `MessageType`           | 消息类型枚举         |
+| `EventType`             | 事件类型枚举         |
+| `ConnectionStatus`      | 连接状态枚举         |
+| `MessageCode`           | 消息代码枚举         |
+| `MatchStatus`           | 匹配状态枚举         |
+| `HistoryMessagesParams` | 聊天记录查询参数     |
+| `RequestResponse<T>`    | 接口响应包装         |
 
 **消息类型（ChatType）：**
+
 - `ChatType.TEXT` - 文本消息
 - `ChatType.IMAGE` - 图片消息
 - `ChatType.VIDEO` - 视频消息
 - `ChatType.FILE` - 文件消息
 - `ChatType.FAQ` - FAQ 消息
 
-**连接状态（ConnectionStatus）：**
-- `ConnectionStatus.DISCONNECTED` - 未连接
-- `ConnectionStatus.CONNECTING` - 连接中
-- `ConnectionStatus.CONNECTED` - 已连接
-- `ConnectionStatus.RECONNECTING` - 重连中
-- `ConnectionStatus.ERROR` - 错误
+
 
 **匹配状态（MatchStatus）：**
+
 - `MatchStatus.UNMATCHED` - 未匹配
 - `MatchStatus.MATCHING` - 匹配中
 - `MatchStatus.MATCHED` - 已匹配
 - `MatchStatus.UNBIND` - 已解绑
 
-**线路测速与 Base URL：** 首次发起 API 请求时，SDK 会调用 `ListLines` 获取线路列表，并对 API 线路请求 `TestLineLatency`、对下载线路请求 `/pub/logo.png`，取最先成功的地址作为后续请求的 baseURL。
-
-**环境变量（构建时）：** `VITE_BASE_API_URL` 拉取 ListLines 的初始 API 地址（必填）；`VITE_OBS_URL` 下载线路测速失败时的下载地址兜底（可选）。
-
-## 类型定义
-
-SDK 提供完整的 TypeScript 类型定义，可从 `joytalk` 按需导入。
-
-| 类型名 | 说明 |
-|--------|------|
-| `MessageData` | 消息数据（联合类型） |
-| `TextMessageData` | 文本消息数据 |
-| `FileMessageData` | 文件消息数据 |
-| `FaqMessageData` | FAQ 消息数据 |
-| `SessionData` | 会话数据 |
-| `UserInfo` | 用户信息 |
-| `ChatType` | 聊天类型枚举 |
-| `MessageType` | 消息类型枚举 |
-| `EventType` | 事件类型枚举 |
-| `ConnectionStatus` | 连接状态枚举 |
-| `MessageCode` | 消息代码枚举 |
-| `MatchStatus` | 匹配状态枚举 |
-| `HistoryMessagesParams` | 聊天记录查询参数 |
-| `RequestResponse<T>` | 接口响应包装 |
-
-## 消息处理示例
-
-通过监听 `EventType.MESSAGE`，根据 `message.code` 区分消息类型并处理。
-
-**示例：**
-```typescript
-import JoyTalk, { EventType, MessageCode, ChatType } from 'joytalk';
-
-const JTalk = new JoyTalk();
-await JTalk.init({ token: 'your-token' });
-
-JTalk.on(EventType.MESSAGE, (message) => {
-  switch (message.code) {
-    case MessageCode.SEND_SUCCESS:
-      const messageData = message.data;
-      if (messageData.contentType === ChatType.TEXT) {
-        console.log('文本消息:', messageData.content);
-      } else if (messageData.contentType === ChatType.IMAGE) {
-        console.log('图片消息:', messageData.content.fileUrl);
-      }
-      break;
-    case MessageCode.MATCH_SUCCESS:
-      const sessionData = message.data;
-      console.log('会话ID:', sessionData.sessionId);
-      break;
-    case MessageCode.CONNECT_SUCCESS:
-      console.log('连接成功');
-      break;
-    // ... 其他消息类型
-  }
-});
-```