k2-im 0.1.28 → 0.1.30

package/dist/browser.js

@@ -1 +1 @@
-export{A as createLazyBrowserApiProtocolClient}from'./chunk-FQJBDSXT.js';import'./chunk-O7GQQMEW.js';import'./chunk-WOT6VMZA.js';
+export{B as createLazyBrowserApiProtocolClient}from'./chunk-GHZUH7RB.js';import'./chunk-4KPJTXQN.js';import'./chunk-WOT6VMZA.js';

package/dist/chat-kit-pinia.d.ts

@@ -42,8 +42,8 @@ interface ConversationDraft$1 {
     attachments: readonly [];
     updatedAt: number;
 }
-/** 消息内容类型。sticker=表情/贴图（BMessage contentType=7）；call=单聊通话记录（contentType=10）；transfer=转账（contentType=16）；miniProgram=小程序分享卡（contentType=22）；redPacket=红包卡（contentType=25）；game=小游戏（contentType=27）；未知 wire 正文统一归一为 unknown。 */
-type MessageContentType = 'text' | 'system' | 'image' | 'video' | 'voice' | 'file' | 'sticker' | 'contact' | 'miniProgram' | 'game' | 'transfer' | 'call' | 'redPacket' | 'mediaAlbum' | 'unknown';
+/** 消息内容类型。sticker=表情/贴图（BMessage contentType=7）；call=单聊通话记录（contentType=10）；transfer=转账（contentType=16）；robot=机器人卡片（contentType=18）；miniProgram=小程序分享卡（contentType=22）；redPacket=红包卡（contentType=25）；game=小游戏（contentType=27）；未知 wire 正文统一归一为 unknown。 */
+type MessageContentType = 'text' | 'system' | 'image' | 'video' | 'voice' | 'file' | 'sticker' | 'contact' | 'miniProgram' | 'game' | 'transfer' | 'call' | 'redPacket' | 'mediaAlbum' | 'robot' | 'unknown';
 /**
  * 发送态（客户端态）：消息从本地创建到服务端确认的生命周期。
  * `uploading` 仅媒体消息使用：文件上传阶段（uploading→pending→sending→sent）；
@@ -105,6 +105,8 @@ type LastMessageSummary = {
     kind: 'contact';
 } | {
     kind: 'miniProgram';
+} | {
+    kind: 'robot';
 } | {
     kind: 'game';
     gameType: ImGameType;
@@ -139,6 +141,13 @@ type LastMessageSummary = {
     firstItemKind?: 'image' | 'video';
 } | {
     kind: 'encrypted';
+}
+/**
+ * 密文解密失败/缺密钥占位。必须独立于 `encrypted`：后者只表示「还是密文」，
+ * 前者要对齐 iOS 解密失败长文案，不能再伪装成「[加密消息]」。
+ */
+ | {
+    kind: 'decrypt-failed';
 } | {
     kind: 'recalled';
     by: string;
@@ -193,8 +202,12 @@ interface ImVideoBody {
     thumbData?: Uint8Array;
     /** 视频文件 MD5（BMessage.MD5；Android 当前未赋值，保留可选）。 */
     md5?: string;
-    /** 文件大小（字节；协议 BMessage.fileLength 单位 KB，mapping 层换算）。 */
+    /** 已确认的视频大小（字节），来自本地文件或合集；历史单视频的大小单位不明确时省略，下载总量由 HTTP 响应确定。 */
     size?: number;
+    /** SDK 本地字节值标记，供持久化读取区分旧版本曾按 KB 换算的记录。 */
+    sizeUnit?: 'bytes';
+    /** 未确认单位的历史大小，十进制无符号整数；SDK 仅用于原样转发，宿主不得将它用于显示大小或规划下载。 */
+    unverifiedFileLength?: string;
     /** 视频描述（BMessage.describe，可选）。 */
     describe?: string;
     /** 文件解密 TEA key 原始字节（仅密文视频有；接收端解 BContent 后从 BMessage.teaKey 得，用于解下载到的原视频文件）。 */
@@ -329,6 +342,53 @@ interface ImMiniProgramBody {
     /** 多语言子游戏名 JSON 字符串，例如 `{"ch":"...","en":"..."}`。 */
     subGameName?: string;
 }
+/**
+ * 机器人卡片文本模块（wire `section`）。
+ *
+ * `content` 保留原文，可含 Markdown 链接与裸 URL；宿主负责展示层解析，不在 Core 拆成富文本树。
+ */
+interface ImRobotTextModule {
+    type: 'section';
+    textType: string;
+    content: string;
+}
+/** 机器人卡片图片组；`src` 是明文 http(s)，不走消息 TEA 文件通道。 */
+interface ImRobotImageGroupModule {
+    type: 'image-group';
+    images: readonly string[];
+}
+/**
+ * 机器人卡片倒计时。
+ *
+ * `endTimeMs` 已归一为 epoch 毫秒；wire 秒/毫秒混用只在 mapper 转换，宿主不要再猜单位。
+ */
+interface ImRobotCountdownModule {
+    type: 'countdown';
+    endTimeMs: number;
+}
+type ImRobotModule = ImRobotTextModule | ImRobotImageGroupModule | ImRobotCountdownModule;
+/** 机器人卡片底部指令；`miniProgram` 仅打开小程序时存在。 */
+interface ImRobotCommand {
+    menuName: string;
+    menuId?: string;
+    /** wire `msg_type`；`2` 表示打开小程序，其它走固定话术。第一期宿主可只展示。 */
+    messageType?: string;
+    miniProgram?: {
+        path?: string;
+        appId?: string;
+        domain?: string;
+    };
+}
+/**
+ * 机器人卡片正文（contentType==='robot'，协议 BMessage.contentType=18）。
+ *
+ * @remarks 排版数据在 `BMessage.content` JSON。解析失败仍保留 robot 类型与空模块，
+ * 不能退化成 unknown——iOS 此时仍画出卡片头。divider 与未识别 module 在 mapper 丢弃。
+ */
+interface ImRobotBody {
+    modules: readonly ImRobotModule[];
+    commands: readonly (readonly ImRobotCommand[])[];
+}
 /** 转账状态。0 待领取 / 1 已收款 / 2 已退还 / 3 已过期（对齐 iOS IMTranferBody，过期 3 以客户端为准）。 */
 type ImTransferStatus = 0 | 1 | 2 | 3;
 /** 转账会话类型。1 个人 / 2 群（BMessage.sessionType）。 */
@@ -523,6 +583,8 @@ interface ImMessageBody {
     redPacket?: ImRedPacketBody;
     /** contentType==='mediaAlbum' 时的媒体合集正文（配文 + 1~9 个图片/视频项）。 */
     mediaAlbum?: ImMediaAlbumBody;
+    /** contentType==='robot' 时的机器人卡片。 */
+    robot?: ImRobotBody;
     /** contentType==='unknown' 时的稳定未知正文，不含原始 wire type。 */
     unknown?: UnknownMessageBody;
 }
@@ -599,7 +661,7 @@ interface ImMessageEncryption {
     encrypted: boolean;
     /** 扩展：加密方案标识，默认 'rsa-tea'。 */
     scheme?: 'rsa-tea';
-    /** true=密文但解密失败/缺密钥（占位，非真实空正文）：供 UI 显式「无法解密」提示，与明文空消息区分。 */
+    /** true=密文但解密失败/缺密钥（占位，非真实空正文）：供 UI 显式渲染解密失败提示，与明文空消息、普通密文区分。 */
     decryptFailed?: boolean;
 }
 /** 单条消息领域模型（§4.1）。主键为客户端生成的 id（无 serverId）。 */
@@ -1790,6 +1852,41 @@ interface ImSessionFavoritePort {
     delete: (collectIds: readonly string[]) => Promise<void>;
 }
 
+/**
+ * SDK 已取得的最近一页请求结果；只是可重建缓存，不代表消息已进入 DomainState 或处理过入站副作用。
+ * 消息、Reaction 与分页边界必须整页原子保存，只有前台实际消费时才进入正常消息流程。
+ */
+interface ImRecentHistoryPage {
+    /** 缓存记录格式版本；不认识的版本不能当作有效页使用。 */
+    version: 1;
+    /** 当前账号内的精确 GROUP/CHANNEL 会话；direct 没有此远端最近页能力。 */
+    conversation: ConversationRef<'group' | 'channel'>;
+    /** 成功获取页面的毫秒时间，用于保留期限和按获取时间淘汰。 */
+    fetchedAt: number;
+    /** SDK 生成的请求与会话状态指纹；存储层不解释其内容。 */
+    fingerprint: string;
+    /** 已净化的消息事实，缓存保存不得发布消息或已读事件。 */
+    messages: readonly ImMessage[];
+    /** 解码时暂存的 Reaction 事实，预取阶段不得提前应用。 */
+    reactions: readonly ImReactionEvent[];
+    /** 服务端是否明确没有更早一页，空页也保留这一结果。 */
+    exhausted: boolean;
+    /** 服务端返回的向旧游标，存储层仅原样保存。 */
+    nextCursor?: string;
+    /** SDK 按净化后的整页计算的字节数，用于存储预算。 */
+    byteLength: number;
+}
+/** 账号隔离的最近页缓存；过期、淘汰或清理后重新请求即可，不影响消息真相。 */
+interface ImRecentHistoryCachePort {
+    /** 读取精确会话的整页；不存在或超过保留期限时返回 null。 */
+    get: (conversation: ConversationRef<'group' | 'channel'>) => Promise<ImRecentHistoryPage | null>;
+    /** 原子保存整页；仅 durable 事务提交后返回 true，预算或保留期限不允许时返回 false。 */
+    put: (page: ImRecentHistoryPage) => Promise<boolean>;
+    /** 删除精确会话的缓存页，不删除正常历史或会话。 */
+    delete: (conversation: ConversationRef<'group' | 'channel'>) => Promise<void>;
+    /** 清空当前账号的最近页缓存。 */
+    clear: () => Promise<void>;
+}
 /** 迁移期存储会话入参；新代码使用 ref，string 仅兼容唯一命中的旧调用。 */
 type ImStorageConversation = ConversationRef | string;
 /** 打开账号库的选项。namespace = 账号隔离键（登录 userId）。 */
@@ -1938,6 +2035,8 @@ type StoredConversationBackground = {
  * 失败经 `error` 事件（scope:'storage'）暴露、不静默吞、不阻塞内存主流程。
  */
 interface ImStoragePort {
+    /** 可选的最近页持久缓存；缺少该能力时 SDK 必须明确跳过持久预取。 */
+    recentHistoryCache?: ImRecentHistoryCachePort;
     /** 打开/创建账号库并跑迁移（幂等）。open 前的读写应视为未就绪并抛错（不静默兜底）。 */
     open: (options: ImStorageOpenOptions) => Promise<void>;
     /** 关闭库句柄（登出/切账号）。 */
@@ -2099,6 +2198,10 @@ interface ImStoragePort {
 type ImEvent = {
     type: 'connection:changed';
     state: ImConnectionState;
+}
+/** 同账号已由另一个浏览器页面接管；本页会话不可复用，但宿主登录仍有效。 */
+ | {
+    type: 'session:replaced';
 } | {
     type: 'message:received';
     message: ImMessage;
@@ -2700,24 +2803,32 @@ interface MediaTransferAdapterConfig {
     /** 是否启用 S3 Transfer Acceleration（默认 true；`cn-` 分区没有加速端点，会强制关闭）。 */
     useAccelerateEndpoint?: boolean;
     /**
-     * 是否允许超过分片阈值（16MiB）的上传使用 S3 分片上传（默认 true）。
+     * 统一允许 S3 分片上传和 Range 分段下载，默认 false（单次 PUT / 普通 GET）。
+     * 显式 true 后仍按 16MiB 阈值及已确认下载大小选择策略，小资源不分片。
+     * 开启前各桶须支持分片请求方法，并暴露上传 ETag、下载 Content-Range 与强 ETag。
+     * @example { multipartTransfer: true } 同时允许大资源分片上传、下载。
+     */
+    multipartTransfer?: boolean;
+    /**
+     * 总开关开启后，是否允许超过分片阈值（16MiB）的上传使用 S3 分片上传。
      *
      * 分片相比单次 PUT 需要各物理桶的 CORS 额外放行 POST（Create/CompleteMultipartUpload）、
      * DELETE（AbortMultipartUpload）并 `ExposeHeaders: ETag`；未配齐时分片会直接失败。
-     * 部署可置 false 立即退回全量单次 PutObject（大文件回到单连接与整包内存的旧行为），无需发版。
+     * @deprecated 优先使用 multipartTransfer 统一控制；本字段 false 仅进一步关闭上传，true 不能单独开启。
      */
     multipartUpload?: boolean;
     /**
-     * 大于 16MiB 的明文/simple 文件是否尝试 Range 并发下载（默认 true）。
+     * 总开关开启后，大于 16MiB 的明文/simple 文件是否尝试 Range 并发下载。
      * 需要下载域名支持 Range，并暴露 Content-Range 与强 ETag；返回 200 时消费完整响应并记录诊断。
-     * 置 false 使用单次 GET。此开关不改变上传或整文件 TEA 的行为。
+     * @deprecated 优先使用 multipartTransfer 统一控制；本字段 false 仅进一步关闭下载，true 不能单独开启。
      */
     rangeDownload?: boolean;
     /**
-     * 媒体发送阶段的并发上限；由 im-core 消费，adapter 本身仍只负责单个上传任务。
+     * 媒体发送阶段的并发上限；由 im-core 消费，限制媒体任务数而非分片请求数。
      *
-     * 并发按媒体体积分两档：图片与不超过分片阈值（16 MiB）的小文件走单次 PutObject、不占分片缓冲，
-     * 缺省 5；视频与超过阈值（或字节数未知）的文件走分片，每路各带分片缓冲，缺省 3。
+     * 并发按媒体体积分两档：不超过分片阈值（16 MiB）的非视频媒体走小文件档，
+     * 缺省 5；视频与超过阈值（或字节数未知）的内容走大文件档，缺省 3。
+     * 分档只限制媒体任务数；实际 PUT/UploadPart 另受 adapter 的六路数据请求限制。
      * 两档都只接受 1-6 的整数，超出范围由 core 显式报错。
      * - 传一个数字：所有媒体共用这一个并发数，与分档前的语义一致。
      * - 传 `{ total, largeFiles }`：显式分档，`largeFiles` 不得超过 `total`。
@@ -2766,8 +2877,8 @@ interface IndexedDbStorageAdapterOptions {
         maxPendingWriteBytes?: number;
     };
 }
-/** 官方浏览器 adapter 始终提供完整背景持久化能力；可选只存在于通用 `ImStoragePort` 兼容边界。 */
-type IndexedDbStorageAdapter = ImStoragePort & MediaAssetCachePort & Required<Pick<ImStoragePort, 'getConversationBackground' | 'saveConversationBackground' | 'deleteConversationBackground' | 'getDefaultConversationBackground' | 'saveDefaultConversationBackground' | 'deleteDefaultConversationBackground'>>;
+/** 官方浏览器 adapter 始终提供背景和最近历史缓存；可选只存在于通用 `ImStoragePort` 兼容边界。 */
+type IndexedDbStorageAdapter = ImStoragePort & MediaAssetCachePort & Required<Pick<ImStoragePort, 'getConversationBackground' | 'recentHistoryCache' | 'saveConversationBackground' | 'deleteConversationBackground' | 'getDefaultConversationBackground' | 'saveDefaultConversationBackground' | 'deleteDefaultConversationBackground'>>;
 /**
  * 创建 IndexedDB 存储 adapter（实现 ImStoragePort）。
  * 生命周期：先 `open({ namespace })`（幂等，跑 schema 迁移），再读写；`close()` 释放句柄。
@@ -3369,6 +3480,21 @@ interface ImContactApi extends ImDirectoryApi<'individual'> {
     deleteFriendship: (userId: string) => Promise<void>;
 }
 
+/** 后台最近页预取的取消条件；取消不影响正在复用同一请求的前台会话。 */
+interface ConversationPrefetchOptions {
+    signal?: AbortSignal;
+}
+/**
+ * 单个会话的后台预取结果。ready 只在完整页面已写入当前账号缓存后返回。
+ * skipped 表示当前类型、权限、存储或预算不允许预取；失败不改变正常打开会话的行为。
+ */
+interface ConversationPrefetchResult {
+    ref: ConversationRef<'direct' | 'group' | 'channel'>;
+    status: 'ready' | 'skipped' | 'failed' | 'cancelled';
+    reason?: 'unsupported' | 'unavailable' | 'storage-unavailable' | 'budget' | 'page-too-large' | 'decrypt-failed' | 'invalidated' | 'cancelled';
+    error?: ImSdkErrorShape;
+}
+
 /**
  * 当前账号草稿的产品 DTO、跨组件 API 与 handle 绑定门面。
  * 草稿按复合会话身份串行持久化，SDK DomainState 是唯一真相；附件尚未闭合时非空输入明确拒绝。
@@ -3458,6 +3584,8 @@ interface ImConversationsApi {
     pullOffline: () => Promise<ImMessage[]>;
     /** 运行 direct/GROUP/CHANNEL sibling 离线同步。 */
     sync: () => Promise<void>;
+    /** 静默准备最近页；结果成功表示当前账号缓存事务已提交。 */
+    prefetchRecent: (refs: readonly ImSupportedConversationRef[], options?: ConversationPrefetchOptions) => Promise<readonly ConversationPrefetchResult[]>;
     /** 聚合总未读；默认排除 muted 会话。 */
     getTotalUnread: (options?: {
         includeMuted?: boolean;
@@ -4046,6 +4174,8 @@ type ConversationLastMessageSummary = {
     kind: 'contact';
 } | {
     kind: 'miniProgram';
+} | {
+    kind: 'robot';
 } | {
     kind: 'transfer';
 } | {
@@ -4076,6 +4206,10 @@ type ConversationLastMessageSummary = {
     firstItemKind?: 'image' | 'video';
 } | {
     kind: 'encrypted';
+}
+/** 密文解密失败占位；与 `encrypted` 分开，列表走独立 iOS 长文案。 */
+ | {
+    kind: 'decrypt-failed';
 } | {
     kind: 'recalled';
     by: string;
@@ -4157,6 +4291,8 @@ interface ImConversationListApi extends ImConversationBackgroundApi {
     subscribe: (listener: (snapshot: ImConversationListSnapshot) => void) => () => void;
     /** 显式运行 direct/GROUP/CHANNEL sibling 同步；失败抛稳定产品错误并进入 error 快照。 */
     refresh: () => Promise<void>;
+    /** 静默预取各会话最近一页；不激活线程，ready 只表示持久缓存已完成。 */
+    prefetchRecent: (refs: readonly ConversationRef<ProductConversationListType>[], options?: ConversationPrefetchOptions) => Promise<readonly ConversationPrefetchResult[]>;
     /** 读取总未读；默认排除 muted 会话。 */
     getTotalUnread: (options?: {
         includeMuted?: boolean;
@@ -4442,6 +4578,8 @@ type ConversationInitialPosition = 'latest' | 'first-unread';
  * @remarks 选项只影响初始连续窗口和 `entryUnread` 快照；发送、历史分页、已读和 close 语义保持不变。
  */
 interface ConversationOpenOptions {
+    /** 取消尚未交付的会话打开及其历史请求；句柄交付后由 close 管理生命周期。 */
+    signal?: AbortSignal;
     /**
      * 初始连续窗口位置。
      *
@@ -5071,6 +5209,8 @@ interface ImProductEventMap {
     'connection:changed': Readonly<{
         snapshot: ImLifecycleSnapshot;
     }>;
+    /** 另一个页面接管聊天；宿主可提示刷新此页重新接管，不应退出业务登录。 */
+    'session:replaced': Readonly<Record<never, never>>;
     'message:received': Readonly<{
         ref: ConversationRef<ProductConversationListType>;
         message: ImProductMessage;
@@ -5562,15 +5702,16 @@ interface ImSettingsApi {
  *
  * 形状 = im-browser `MediaTransferAdapterConfig`：必填 `getUploadCredentials`（按逻辑桶名向宿主自己的 BFF 申请
  * STS 临时凭证）+ 各 `MediaKind`（image/video/voice/file/sticker）的**逻辑桶名** + 可选 `channelBuckets`（社群会话
- * 按类型覆盖）、`avatarBucket`、`useAccelerateEndpoint`、`multipartUpload`、`maxConcurrentUploads`。
+ * 按类型覆盖）、`avatarBucket`、`useAccelerateEndpoint`、`multipartTransfer`、`maxConcurrentUploads`。
  *
  * 上传凭证由业务后端按登录态签发（与 iOS、prod H5 同一个接口），回包同时给出**物理桶**、区域、`key_prefix` 和
  * 公开访问域名；SDK 据此拼 object key 与消息体 URL，宿主 env 里配的只是申请凭证用的逻辑桶名。凭证缓存（本地
  * 1 小时、按服务端过期时间提前 5 分钟失效）、同桶单飞与失败重签由 SDK 负责，宿主只需提供「打一次接口」的纯函数。
  *
- * ⚠ 各 bucket 需在对象存储侧配置 CORS 允许本站 origin 的 PUT + GET；超过 16MiB 的上传走 S3 分片，另需放行
+ * 默认单次 PUT/GET；仅 multipartTransfer=true 才允许大资源分片上传、下载。
+ * 各 bucket 需在对象存储侧配置 CORS 允许本站 origin 的 PUT + GET；开启分片后，超过 16MiB 的上传另需放行
  * POST（Create/CompleteMultipartUpload）、DELETE（AbortMultipartUpload）并 ExposeHeaders: ETag。CORS 未配齐时
- * 可用 `multipartUpload: false` 退回全量单次 PutObject。
+ * 下载还需暴露 Content-Range 与强 ETag；multipartTransfer=false 统一关闭分片上传和下载。
  * ⚠ 并发字段只由 SDK core 的媒体编排消费；adapter 会忽略该字段。高内存设备可设置 5-6，低内存设备建议 2-3。
  */
 type ImMediaConfig = MediaTransferAdapterConfig;
@@ -6213,7 +6354,7 @@ declare function useImApplicationsStore(pinia?: Pinia): ImApplicationsStore;
  * 二期收敛：kit 框架无关层不再直接产中文，改产本联合里的码 + 参数（如 {reason}/{label}/{size}），由宿主经 im-i18n 渲染。
  * 动态原始报错（error.message）作为 `{reason}` 参数拼接，不入 catalog（属诊断，不翻译）。
  */
-type ImServiceTextKey = 'common.notConnected' | 'common.selectOrOpenConversation' | 'common.conversationTypeNotReady' | 'common.conversationNotReady' | `recall.${RecallFailReason}` | `edit.${EditFailReason}` | 'localDelete.done' | 'localDelete.notFound' | 'localDelete.inFlight' | 'localDelete.failed' | 'channelDelete.notFound' | 'channelDelete.unsupported' | 'channelDelete.notSent' | 'channelDelete.unavailable' | 'channelDelete.forbidden' | 'channelDelete.timeout' | 'channelDelete.failed' | 'channelDelete.disconnected' | 'directBlock.contactRequired' | 'groupBlock.left' | 'groupBlock.removed' | 'groupBlock.dismissed' | 'groupBlock.unknownRestricted' | 'channelBlock.guest' | 'channelBlock.left' | 'channelBlock.removed' | 'channelBlock.dismissed' | 'channelBlock.muted' | 'channelBlock.allMembersMuted' | 'channelBlock.currentUserMuted' | 'channelBlock.blacklisted' | 'channelBlock.unknownRestricted' | 'channelProfile.loadFailed' | 'channelProfile.notFound' | 'channelProfile.retryAction' | 'channelMembers.title' | 'channelMembers.searchPlaceholder' | 'channelMembers.loading' | 'channelMembers.loadFailed' | 'channelMembers.retryAction' | 'channelMembers.empty' | 'channelMembers.loadingMore' | 'channelMembers.loadMoreFailed' | 'channelMembers.exhausted' | 'channelMembers.loadMoreAction' | 'label.image' | 'label.video' | 'label.file' | 'label.sticker' | 'send.failed' | 'send.retryFailed' | 'send.cancelFailed' | 'send.mediaFailed' | 'send.mediaEmpty' | 'send.mediaCancelled' | 'send.mediaCountLimit' | 'send.mediaTooLarge' | 'send.mediaFormatMismatch' | 'send.imageFormatUnsupported' | 'send.videoTooLong' | 'send.videoDurationUnavailable' | 'send.voiceEmpty' | 'send.voiceStorageNotConfigured' | 'send.voiceCancelled' | 'send.voiceFailed' | 'media.uploadWaiting' | 'media.voiceNotReady' | 'media.voiceLoadEmpty' | 'media.voiceLoadFailed' | 'media.videoOpenEmpty' | 'media.videoLoadFailed' | 'media.imageInvalid' | 'media.imageLoadFailed' | 'media.fileDownloadEmpty' | 'media.fileDownloadFailed' | 'conversation.muteEnableFailed' | 'conversation.muteDisableFailed' | 'conversation.backgroundLoadFailed' | 'read.markReadFailed' | 'storage.failed' | 'sync.failed' | 'draft.saveFailed' | 'history.returnLatestFailed' | 'pinned.forbidden' | 'pinned.network' | 'pinned.contract' | 'pinned.unsupported' | 'pinned.failed' | 'pinned.previewUnavailable' | 'pinned.locateFailed' | 'pinned.recalled' | 'pinned.deleted' | 'pinned.protected' | 'pinned.pinAction' | 'pinned.unpinAction' | 'pinned.unpinConfirm' | 'pinned.cancelAction' | 'lifecycle.missingLoginState' | 'lifecycle.prepareFailed' | 'lifecycle.missingConnectParams' | 'lifecycle.connectFailed' | 'lifecycle.disposed' | 'forward.emptyInput' | 'forward.allSkipped' | 'forward.partialSkipped' | 'forward.done' | 'forward.failed';
+type ImServiceTextKey = 'common.notConnected' | 'common.selectOrOpenConversation' | 'common.conversationTypeNotReady' | 'common.conversationNotReady' | `recall.${RecallFailReason}` | `edit.${EditFailReason}` | 'localDelete.done' | 'localDelete.notFound' | 'localDelete.inFlight' | 'localDelete.failed' | 'channelDelete.notFound' | 'channelDelete.unsupported' | 'channelDelete.notSent' | 'channelDelete.unavailable' | 'channelDelete.forbidden' | 'channelDelete.timeout' | 'channelDelete.failed' | 'channelDelete.disconnected' | 'directBlock.contactRequired' | 'groupBlock.left' | 'groupBlock.removed' | 'groupBlock.dismissed' | 'groupBlock.unknownRestricted' | 'channelBlock.guest' | 'channelBlock.left' | 'channelBlock.removed' | 'channelBlock.dismissed' | 'channelBlock.muted' | 'channelBlock.allMembersMuted' | 'channelBlock.currentUserMuted' | 'channelBlock.blacklisted' | 'channelBlock.unknownRestricted' | 'channelProfile.loadFailed' | 'channelProfile.notFound' | 'channelProfile.retryAction' | 'channelMembers.title' | 'channelMembers.searchPlaceholder' | 'channelMembers.loading' | 'channelMembers.loadFailed' | 'channelMembers.retryAction' | 'channelMembers.empty' | 'channelMembers.loadingMore' | 'channelMembers.loadMoreFailed' | 'channelMembers.exhausted' | 'channelMembers.loadMoreAction' | 'label.image' | 'label.video' | 'label.file' | 'label.sticker' | 'send.failed' | 'send.retryFailed' | 'send.cancelFailed' | 'send.mediaFailed' | 'send.mediaEmpty' | 'send.mediaCancelled' | 'send.mediaCountLimit' | 'send.mediaTooLarge' | 'send.mediaFormatMismatch' | 'send.imageFormatUnsupported' | 'send.videoTooLong' | 'send.videoDurationUnavailable' | 'send.voiceEmpty' | 'send.voiceStorageNotConfigured' | 'send.voiceCancelled' | 'send.voiceFailed' | 'media.uploadWaiting' | 'media.voiceNotReady' | 'media.voiceLoadEmpty' | 'media.voiceLoadFailed' | 'media.videoOpenEmpty' | 'media.videoLoadFailed' | 'media.imageInvalid' | 'media.imageLoadFailed' | 'media.fileDownloadEmpty' | 'media.fileDownloadFailed' | 'conversation.muteEnableFailed' | 'conversation.muteDisableFailed' | 'conversation.backgroundLoadFailed' | 'read.markReadFailed' | 'storage.failed' | 'sync.failed' | 'draft.saveFailed' | 'history.returnLatestFailed' | 'pinned.forbidden' | 'pinned.network' | 'pinned.contract' | 'pinned.unsupported' | 'pinned.failed' | 'pinned.previewUnavailable' | 'pinned.locateFailed' | 'pinned.recalled' | 'pinned.deleted' | 'pinned.protected' | 'pinned.pinAction' | 'pinned.unpinAction' | 'pinned.unpinConfirm' | 'pinned.cancelAction' | 'lifecycle.missingLoginState' | 'lifecycle.prepareFailed' | 'lifecycle.missingConnectParams' | 'lifecycle.connectFailed' | 'lifecycle.disposed' | 'lifecycle.connectionOccupied' | 'lifecycle.connectionCoordinationUnavailable' | 'forward.emptyInput' | 'forward.allSkipped' | 'forward.partialSkipped' | 'forward.done' | 'forward.failed';
 
 /**
  * 本文件管理图片和视频本地预览地址的完整生命周期。
@@ -6513,7 +6654,8 @@ interface ChatRuntime {
     /**
      * 在账号或 token 发生变化时，立即停止并清理旧账号运行资源。
      *
-     * 它会断开旧连接，关闭本机消息库，丢弃 SDK Client、资料缓存和媒体资源，并递增账号版本号；
+     * 它会立即停止旧连接并丢弃页面资源，异步销毁 SDK Client、关闭消息库和释放浏览器锁；
+     * 新 prepare/connect 等待清理完成，账号版本号同步递增；
      * 已注册的 Store 监听器会保留，以便新账号重新连接后继续接收事件。通常由 `applySession` 自动调用。
      */
     resetForAuthChange: () => void;
@@ -6920,6 +7062,8 @@ interface ImConversationListStore {
     readonly items: readonly ConversationListItem[];
     readonly state: ImConversationListState;
     readonly totalUnread: number;
+    /** 菜单角标使用的非免打扰未读会话数；totalUnread 仍为 SDK 原始未读消息条数。 */
+    readonly unreadConversationCount: number;
     readonly error: ImSdkErrorShape | null;
     start: () => void;
     reset: () => void;
@@ -6957,6 +7101,7 @@ declare function defineImConversationListStore(pinia: Pinia): pinia.StoreDefinit
     items: any;
     state: any;
     totalUnread: any;
+    unreadConversationCount: any;
     error: any;
     start: () => void;
     reset: () => void;
@@ -6971,6 +7116,7 @@ declare function defineImConversationListStore(pinia: Pinia): pinia.StoreDefinit
     items: any;
     state: any;
     totalUnread: any;
+    unreadConversationCount: any;
     error: any;
     start: () => void;
     reset: () => void;
@@ -6985,6 +7131,7 @@ declare function defineImConversationListStore(pinia: Pinia): pinia.StoreDefinit
     items: any;
     state: any;
     totalUnread: any;
+    unreadConversationCount: any;
     error: any;
     start: () => void;
     reset: () => void;