mdm-im-v3 1.4.1 → 1.4.3

package/CHANGELOG.md

@@ -39,3 +39,10 @@
 ## V1.4.1 2026-08-11
 - 发布mdm-im-v3@1.4.1版本
 1. 修改核心文件的调用方式，避免打包后无法正常使用。
+
+## V1.4.3 2026-08-11
+- 发布mdm-im-v3@1.4.3版本
+1. 修改核心文件的导出方法及对象，方便查询IM的登录状态及消息未读数。
+
+## V1.4.2 2026-08-11
+- 发布mdm-im-v3@1.4.2版本（已废弃：打包遗漏）

package/README.md

@@ -63,12 +63,11 @@ const handleLogin = () => {
 
 ```js
 // ========== 步骤1：core/index.js — 应用入口处登录 IM ==========
-import { useMessage, useChatStore } from 'mdm-im-v3/core'
-
-const chatStore = useChatStore()
+import { watch } from 'vue'
+import { useMessage } from 'mdm-im-v3/core'
 
-// 传入配置参数，自动保存到 store
-const { initIMSDK, getUnReadMessageCount } = useMessage({
+// 传入配置参数，自动保存到 store；同时解构出 loginStatus 用于监控
+const { initIMSDK, getUnReadMessageCount, loginStatus, messageStore } = useMessage({
   userID: 'your-account',        // 用户 ID，必填
   nickname: 'your-name',          // 用户昵称
   faceURL: '',                    // 用户头像
@@ -83,16 +82,13 @@ const { initIMSDK, getUnReadMessageCount } = useMessage({
 // 初始化并登录
 await initIMSDK()
 
-// 监听登录状态，登录成功后获取未读数
-watch(
-  () => chatStore.getLoginStatus,
-  status => {
-    if (status === 3) {
-      // 从服务端获取未读消息总数
-      getUnReadMessageCount(true)
-    }
+// 监控 IM 登录状态，登录成功后获取未读数
+watch(loginStatus, status => {
+  if (status === 3) {
+    // 从服务端获取未读消息总数
+    getUnReadMessageCount(true)
   }
-)
+})
 ```
 
 ```vue
@@ -199,7 +195,7 @@ chatRef.value.inviteUser('group-id-xxx', ['user1', 'user2'])
 
 ## `useMessage` API
 
-从 `mdm-im-v3/core` 导入，用于手动管理 IM 生命周期：
+从 `mdm-im-v3/core` 导入，用于手动管理 IM 生命周期。该模块同时导出 `useMessage` 和 `useChatStore`：
 
 ```js
 import { useMessage, useChatStore } from 'mdm-im-v3/core'
@@ -240,6 +236,8 @@ const { initIMSDK, clearInstance, getUnReadMessageCount, setConversationMsgAsRea
 
 | 方法/属性 | 说明 |
 |-----------|------|
+| `messageStore` | Pinia store 实例（`useChatStore()`），可直接访问所有 state/getters/actions |
+| `loginStatus` | IM 登录状态的 `computed` 引用，便于外部 `watch` 监控。值：1-未登录，2-登录中，3-已登录 |
 | `initIMSDK()` | 初始化 SDK → 绑定所有 OpenIM 事件 → 登录。需先在 store 中设置 userID、imToken、apiUrl 等。返回 `Promise<void>`。 |
 | `clearInstance(bool)` | 解绑事件 → 登出 → 清除 SDK 实例。传入 `true` 时同时清空会话列表和 `window.imInstance`。 |
 | `getUnReadMessageCount(fromServer?)` | 获取未读消息总数。`fromServer=true` 从服务端获取，默认从本地会话列表累计。 |
@@ -250,7 +248,12 @@ const { initIMSDK, clearInstance, getUnReadMessageCount, setConversationMsgAsRea
 
 ## ChatStore
 
-通过 `useChatStore()` 获取，是 Pinia store（id: `'chatMessage'`），**已开启 localStorage 持久化**，持久化字段包括：`userID`、`nickname`、`faceURL`、`platformID`、`apiUrl`、`wsUrl`、`tenantID`（`imToken` 和 `satoken` 仅保存在 Pinia 内存中，不持久化到本地存储）。
+从 `mdm-im-v3/core` 导入 `useChatStore` 后调用获取，是 Pinia store（id: `'chatMessage'`），**已开启 localStorage 持久化**，持久化字段包括：`userID`、`nickname`、`faceURL`、`platformID`、`apiUrl`、`wsUrl`、`tenantID`（`imToken` 和 `satoken` 仅保存在 Pinia 内存中，不持久化到本地存储）。
+
+```js
+import { useChatStore } from 'mdm-im-v3/core'
+const chatStore = useChatStore()
+```
 
 ### 常用 State
 

package/dist/core.es.js

@@ -1,4 +1,6 @@
-import { H as a } from "./index-CKBF2vQ0.js";
+import "vue";
+import { u as o, H as r } from "./index-CeZkCy7e.js";
 export {
-  a as useMessage
+  o as useChatStore,
+  r as useMessage
 };