k2-im 0.1.25 → 0.1.26

package/dist/index.d.ts

@@ -1,15 +1,3 @@
-/** IM 领域支持的 5 个展示 locale（与宿主规范 locale 一致）。 */
-type ImLocale = 'en-US' | 'th-TH' | 'vi-VN' | 'zh-CN' | 'zh-TW';
-/** 默认展示语言；缺译 / 未知 locale 一律回退至此（对齐 NUXT_PUBLIC_DEFAULT_LOCALE 默认值）。 */
-declare const DEFAULT_LOCALE: ImLocale;
-/**
- * 把宿主更宽的 locale 联合归一到 ImLocale：精确命中 5 个规范 locale 之一即原样返回，
- * 非法 / 未知输入回退 `DEFAULT_LOCALE`。供宿主 `env.locale`（如 `useI18n().locale`）安全窄化。
- * @example normalizeImLocale('zh-CN') // 'zh-CN'
- * @example normalizeImLocale('fr-FR') // 'zh-CN'（DEFAULT_LOCALE）
- */
-declare function normalizeImLocale(input: string): ImLocale;
-
 /** 媒体业务类型：实现据此选对象存储逻辑桶；sticker 对应 app-sticker。 */
 type MediaKind = 'image' | 'video' | 'voice' | 'file' | 'sticker';
 
@@ -1062,8 +1050,8 @@ type ChannelMiniProgramRelConfigType = 'pinned-game' | 'float-link' | 'float-gam
 /**
  * 频道资料上的关联小程序（`/user_radio/info` 的 `mini_program_rel_list`）。
  *
- * @remarks 这不是消息 22。语言/币种 CSV 原样保留，由宿主按大厅状态过滤。
- * 打开小程序、半屏 iframe 与鉴权属于宿主，不进本 DTO。
+ * @remarks 这不是消息 22。语言/币种 CSV 原样保留，SDK 不过滤；可见性与打开资格由 Chat Kit 纯函数处理。
+ * 打开器、半屏 iframe 与鉴权属于宿主，不进本 DTO。
  */
 interface ChannelMiniProgramRel {
     configType: ChannelMiniProgramRelConfigType;
@@ -2808,802 +2796,292 @@ declare function parseSessionFavoriteAlbumItems(body: Readonly<Record<string, un
 declare function resolveSessionFavoriteAlbumCaption(item: Pick<ImSessionFavoriteItem$1, 'kind' | 'text' | 'body'>): string;
 
 /**
- * IM 语义文案 catalog 的键、参数和完整性合同。
- * 键描述领域含义而非组件位置，使 Web/H5/SSR 可共享 formatter，宿主布局文案不进入此 schema。
+ * 在宿主显式授权时迁移旧 `cache.prefix` 下的当前账号本地数据。
+ * 迁移使用新旧 namespace factory 精确定位，不扫描未知库，也不自动删除源数据；失败必须由调用方处理。
  */
 
-/** 系统消息文案（formatSystemMessage 用）。占位符 `{x}` 由 formatSystemMessage 按 body + resolveName 插值。 */
-interface ImSystemCatalog {
-    /** 成为联系人后的 direct 建立会话提示。参数：{target}。 */
-    directContactEstablished: string;
-    /** direct 非好友发送被拒后的提示；“申请添加”由 UI 作为 action 单独渲染。 */
-    directContactRequired: string;
-    /** direct 消息被对方黑名单策略拒收后的本地系统提示。 */
-    directMessageRefused: string;
-    /** 自己（operator/target === selfId 时的显示名）。 */
-    you: string;
-    /**
-     * 多个成员名之间的分隔符（如一次邀请多人时拼接名单）。
-     * 中文用顿号、拉丁与泰/越语用逗号加空格，对齐 iOS `SIMManager` 的同名拼接规则。
-     */
-    nameSeparator: string;
-    /** 成员名缺省占位（退群 / 被踢 / 改名 target 缺失时）。 */
-    member: string;
-    /** 新成员名缺省占位（加群 target 缺失时）。 */
-    newMember: string;
-    /** 新群主名缺省占位（群主变更 target 缺失时）。 */
-    newMaster: string;
-    /** 加入群聊。参数：{target}。 */
-    groupMemberJoined: string;
-    /** 当前账号已经加入普通群。 */
-    groupSelfJoined: string;
-    /** 当前账号邀请成员加入普通群。参数：{target}。 */
-    groupMemberInvitedBySelf: string;
-    /** 当前账号作为被邀请者已经加入普通群。 */
-    groupSelfInvited: string;
-    /**
-     * 他人同时邀请了当前账号和其他成员加入普通群。参数：{operator} {target}。
-     * 模板自带「你」，{target} 只填其余成员，避免名单里重复出现当前账号。
-     */
-    groupMemberInvitedYouAndOthers: string;
-    /** 其他成员邀请目标加入普通群。参数：{operator} {target}。 */
-    groupMemberInvitedByOperator: string;
-    /** 缺少邀请者时的第三人称加入文案。参数：{target}。 */
-    groupMemberInvited: string;
-    /** 退出群聊。参数：{target}。 */
-    groupMemberLeft: string;
-    /** 当前账号主动退出普通群。 */
-    groupSelfLeft: string;
-    /** 操作者移出成员。参数：{operator} {target}。 */
-    groupMemberRemovedByOperator: string;
-    /** 当前账号被移出普通群时的固定终态提示。 */
-    groupSelfRemoved: string;
-    /** 被移出群聊（无操作者）。参数：{target}。 */
-    groupMemberRemoved: string;
-    /** 修改群昵称。参数：{target}。 */
-    groupMemberRenamed: string;
-    /** 成为新群主。参数：{target}。 */
-    groupMasterChanged: string;
-    /** 当前账号成为普通群群主。 */
-    groupSelfMasterChanged: string;
-    /** 群名称变更。参数：{name}。 */
-    groupInfoRenamed: string;
-    /** 群资料变更（无新群名）。 */
-    groupInfoChanged: string;
-    /** 群解散。 */
-    groupDismissed: string;
-    /** 消息置顶。参数：{operator}。 */
-    groupMessagePinned: string;
-    /** 移除置顶。参数：{operator}。 */
-    groupMessageUnpinned: string;
-    /** 自己发起群通话。对齐 Android `you_started_a_group_call` / iOS `rea_yousendgroupmediasession`。 */
-    groupCallStartedBySelf: string;
-    /** 他人发起群通话。参数：{operator}。对齐 Android `somebody_started_a_group_call` / iOS `rea_othersendgroupmediasession`。 */
-    groupCallStarted: string;
-    /** 群通话已结束。对齐 Android `group_cal_ended` / iOS `rea_grouphaveend`。 */
-    groupCallEnded: string;
-    /** 群通话未接听。对齐 Android `group_call_missed` / iOS `rea_groupunconnect`。 */
-    groupCallMissed: string;
-    channelNameChanged: string;
-    channelAvatarChanged: string;
-    channelAnnouncementChanged: string;
-    channelMemberJoined: string;
-    channelSelfJoined: string;
-    channelMemberInvited: string;
-    channelMemberInvitedBySelf: string;
-    channelSelfInvited: string;
-    /** 他人同时邀请了当前账号和其他成员加入 CHANNEL；模板自带「你」，{target} 只填其余成员。参数：{operator} {target}。 */
-    channelMemberInvitedYouAndOthers: string;
-    channelMemberInvitedByOperator: string;
-    channelMemberLeft: string;
-    channelSelfLeft: string;
-    /** 当前账号被移出 CHANNEL 时的固定终态提示；独立于 GROUP 文案键维护。 */
-    channelSelfRemoved: string;
-    channelMemberRemoved: string;
-    channelOwnerTransferred: string;
-    channelSelfOwnerTransferred: string;
-    channelAdminAdded: string;
-    channelAdminRemoved: string;
-    channelDismissed: string;
-    channelAllMuted: string;
-    channelAllUnmuted: string;
-    channelCreated: string;
-    channelPrivateChatDisabled: string;
-    channelPrivateChatEnabled: string;
-    channelMemberRenamed: string;
-    channelMemberMuted: string;
-    channelMemberUnmuted: string;
-    /** CHANNEL 消息置顶。参数：{operator}。 */
-    channelMessagePinned: string;
-    /** CHANNEL 移除置顶。参数：{operator}。 */
-    channelMessageUnpinned: string;
-    channelUnknown: string;
-    /** 自己领取了自己发的红包。来源 iOS `redpacket_grabbed_self`。 */
-    redPacketClaimedSelf: string;
-    /** 他人领取了你的红包。参数：{name}。来源 iOS `redpacket_grabbed_yours`。 */
-    redPacketClaimedYours: string;
-    /** 你领取了他人的红包。参数：{name}。来源 iOS `redpacket_you_grabbed`。 */
-    redPacketYouClaimed: string;
-    /** 他人领取了你的红包并踩雷。参数：{name}。来源 iOS `redpacket_grabbed_yours_boom`。 */
-    redPacketClaimedYoursThunder: string;
-    /** 你领取了他人的红包并踩雷。参数：{recipient} {senderName}。来源 iOS `redpacket_you_grabbed_boom`。 */
-    redPacketYouClaimedThunder: string;
-    /** 未知事件兜底（仅当无 fallbackText 时用）。 */
-    unknown: string;
-}
-/** @提及展示文案（formatMentionAll 用；@所有人 的本地化词，展示按接收端语言、与识别词表分离）。 */
-interface ImMentionCatalog {
-    /** @所有人 的本地化词（不含 `@`，由 formatMentionAll 统一拼 `@`）。 */
-    all: string;
-}
-/** 媒体占位文案（formatMediaPlaceholder 用；对齐回复摘要 use-message-preview）。 */
-interface ImMediaCatalog {
-    image: string;
-    video: string;
-    voice: string;
-    /** 带时长语音。参数：{duration}（已格式化 m:ss / h:mm:ss）。 */
-    voiceWithDuration: string;
-    file: string;
-    /** EXPRESSION + imageType=1。 */
-    gif: string;
-    /** EXPRESSION 的静态贴图及未知 imageType。 */
-    sticker: string;
-    contact: string;
-    /** 小程序卡片回复摘要，对齐 iOS `min_program_name`。 */
-    miniProgram: string;
-    /** 转账卡片回复摘要，对齐 iOS `chat_tranfer`。 */
-    transfer: string;
-    /** 语音通话记录回复摘要。 */
-    callAudio: string;
-    /** 视频通话记录回复摘要。 */
-    callVideo: string;
-    /** 红包卡片回复摘要，对齐 iOS `red_envelope` / Android `txt_asset_detail_tab_red_envelope`。 */
-    redPacket: string;
-    /** 骰子消息的回复摘要。 */
-    gameDice: string;
-    /** 石头剪刀布消息的回复摘要。 */
-    gameRockPaperScissors: string;
-    /**
-     * 媒体合集：多张照片，参数 `{count}`（≥2；恰好 1 项时复用 `image`，避免每种语言再写一套单数模板）。
-     *
-     * 这一组与 `lastMessage.mediaAlbum*` 现在是**同一份词**（都不带方括号，决策 D26）。两边仍保留
-     * 各自的 key，是因为两个界面的其它类型并不一致：会话列表给没有图标的类型加方括号，回复摘要一律不加。
-     * 有配文的合集显示配文而不是这些文案，但那是调用方的取舍——与单视频消息的 `describe` 一样，
-     * `formatMediaPlaceholder` 只负责类型占位，不读正文文本。
-     */
-    mediaAlbumPhotos: string;
-    /** 媒体合集：多个视频，参数 `{count}`（≥2；恰好 1 项时复用 `video`）。 */
-    mediaAlbumVideos: string;
-    /** 媒体合集：图片与视频混合，参数 `{photoCount}` `{videoCount}`（各语言自行决定量词与连接符）。 */
-    mediaAlbumMixed: string;
-}
-/** 失败气泡文案（formatFailure 用；逐字对齐 core 现有 ImMessageFailure.message，阶段 4b 零回归）。 */
-interface ImFailureCatalog {
-    /** 媒体类型名（mediaKind → 文案，供 media.* 模板 {label}）。 */
-    mediaLabel: Record<MediaKind, string>;
-    /** media.empty，参数 {label}。 */
-    mediaEmpty: string;
-    /** media.noCrypto，参数 {label}。 */
-    mediaNoCrypto: string;
-    /** media.previewFailed，参数 {label}。 */
-    mediaPreviewFailed: string;
-    /** media.encryptFailed，参数 {label}。 */
-    mediaEncryptFailed: string;
-    /** media.uploadFailed，参数 {label}。 */
-    mediaUploadFailed: string;
-    /** media.cancelled，参数 {label}。 */
-    mediaCancelled: string;
-    /** media.invalidDuration，参数 {label}。 */
-    mediaInvalidDuration: string;
-    /** media.uploadInterrupted，参数 {label}。 */
-    mediaUploadInterrupted: string;
-    /**
-     * media.contentTooLarge：媒体合集的出站正文体积未通过发送前闸门。
-     *
-     * 与其它 media.* 不同，**不带 {label}**——一条合集里可能同时有照片和视频，没有单一媒体类型名。
-     */
-    mediaContentTooLarge: string;
-    /** direct 0x8201：双方已不是好友。 */
-    contactRequired: string;
-    /** direct 0x8212：消息因对方黑名单策略被拒收。 */
-    messageRefused: string;
-    /** forbiddenOrLeft（GROUP ACK ERR_CHAT_FORBIDDEN）。 */
-    forbiddenOrLeft: string;
-    /** contentRejected（ACK ERR_CHAT_UNHEALTHY）。 */
-    contentRejected: string;
-    /** groupDismissed（ACK ERR_GROUP_DISMISSED）。 */
-    groupDismissed: string;
-    /** groupUnavailable（ACK ERR_GROUP_NETWORKEXCEPTION）。 */
-    groupUnavailable: string;
-    /** CHANNEL RADIO ACK 0x8501–0x8504。 */
-    channelDismissed: string;
-    channelMuted: string;
-    channelNotMember: string;
-    channelAdminRequired: string;
-    /** conversationUnsupported（未接入会话类型），参数 {type}。 */
-    conversationUnsupported: string;
-    /** sessionLoggedOut（生命周期 logout：退账号时在途消息移出自动复发，可手动重试）。 */
-    sessionLoggedOut: string;
-    /** sendCanceled（仅本地取消从未进入 transport 的 Outbox queued 项，不表示远端撤回）。 */
-    sendCanceled: string;
-    /** timeout / network / unknown 通用兜底。 */
-    timeout: string;
-    network: string;
-    unknown: string;
+/** 单账号缓存前缀迁移上下文；账号只用于定位数据，不得拼入宿主 prefix。 */
+interface ImCachePrefixMigrationContext {
+    /** 待迁移账号的稳定 id，仅用于选择该账号的数据分区。 */
+    accountId: string;
+    /** 仍保留源数据的旧产品/环境前缀。 */
+    fromPrefix: string;
+    /** 迁移成功后由宿主传给 `createImClient()` 的新前缀。 */
+    toPrefix: string;
+    /** 读取源账号数据时唯一允许使用的 namespace factory。 */
+    fromNamespaceFactory: ImCacheNamespaceFactory;
+    /** 写入/回滚目标账号数据时唯一允许使用的 namespace factory。 */
+    toNamespaceFactory: ImCacheNamespaceFactory;
 }
 /**
- * 会话列表预览文案（formatLastMessageSummary 用；system 复用 formatSystemMessage 带名版）。
- *
- * 方括号只保留给**列表里不带类型图标**的那些：语音、文件、名片、小程序、转账、通话、红包、
- * 小游戏、加密、不支持。它们没有图标，方括号是唯一能和「对方真的发了『语音』两个字」区分开的标记。
+ * 宿主/介质实现的显式前缀迁移器。
  *
- * 照片、视频、GIF、贴图和媒体合集在 PC/H5 会话列表里都带 16px 类型图标（设计稿 13328:305728），
- * 图标已经表明类型，所以文案不带方括号、与回复摘要 `media.*` 用同一份词（决策 D26）。
+ * @remarks SDK 不猜 IndexedDB、SQLite 或文件系统的复制方式；实现方必须保留源数据，并能撤销目标侧的部分写入。
  */
-interface ImLastMessageCatalog {
-    /** 单张照片，与 `media.image` 同词；列表里前面带照片图标，不加方括号。 */
-    image: string;
-    /** GIF 会话摘要，例如 `GIF`；列表里前面带 GIF 图标。 */
-    gif: string;
-    /** 静态贴图会话摘要，例如 `贴图`；列表里前面带贴图图标。 */
-    sticker: string;
-    /** 单个视频，与 `media.video` 同词；列表里前面带视频图标。 */
-    video: string;
-    voice: string;
-    file: string;
-    contact: string;
-    /** 小程序卡片会话摘要，对齐 iOS `[%@]` + `min_program_name`。 */
-    miniProgram: string;
-    /** 转账会话摘要，对齐 iOS `[chat_tranfer]`。 */
-    transfer: string;
-    /** 语音通话记录会话摘要。 */
-    callAudio: string;
-    /** 视频通话记录会话摘要。 */
-    callVideo: string;
-    /** 红包会话摘要，对齐 iOS `[%@]` + `red_envelope` / Android `txt_asset_detail_tab_red_envelope`。 */
-    redPacket: string;
-    /** 小游戏消息的统一会话列表摘要；不在列表中暴露骰子/RPS 的具体类型。 */
-    game: string;
-    /**
-     * 媒体合集：多张照片，参数 `{count}`（≥2；恰好 1 项时复用 `image`，避免各语言再写一套单数模板）。
-     * 有配文的合集直接显示配文，不用这些 key。合集在列表里带类型图标，所以同样不加方括号。
-     */
-    mediaAlbumPhotos: string;
-    /** 媒体合集：多个视频，参数 `{count}`（≥2；恰好 1 项时复用 `video`）。 */
-    mediaAlbumVideos: string;
-    /** 媒体合集：图片与视频混合，参数 `{photoCount}` `{videoCount}`（各语言自行决定量词与连接符）。 */
-    mediaAlbumMixed: string;
-    encrypted: string;
-    /** 未注册或无法解析的正文。 */
-    unknown: string;
-    /** 自己撤回。 */
-    recalledBySelf: string;
-    /** 他人撤回，参数 {name}。 */
-    recalledByOther: string;
-    /** CHANNEL 管理员全员删除。 */
-    channelModerationDeleted: string;
-}
-/**
- * 命令/生命周期「操作提示」文案 key（formatServiceText 用；供 kit services / runtime 产语义码、宿主按 locale 渲染）。
- * 二期收敛：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.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';
-/** 命令/生命周期操作提示 catalog（key 齐全，模板含 {reason}/{label}/{size} 占位）。 */
-type ImServiceCatalog = Record<ImServiceTextKey, string>;
-/** 星期文案键按 JavaScript `Date#getDay()` 的 Sunday-first 顺序命名。 */
-type ImWeekdayKey = 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday';
-/** 会话时间与聊天日期条共享的本地化语义文案。 */
-interface ImTimeCatalog {
-    today: string;
-    yesterday: string;
-    weekdays: Readonly<Record<ImWeekdayKey, string>>;
+interface ImCachePrefixMigrator {
+    /** 将单账号数据复制/转换到目标前缀；失败时必须 reject，不能吞错或删除源数据。 */
+    migrate: (context: ImCachePrefixMigrationContext) => Promise<void>;
+    /** 清理本次迁移在目标侧留下的部分结果；`cause` 是原始迁移错误。 */
+    rollback: (context: ImCachePrefixMigrationContext, cause: unknown) => Promise<void>;
 }
-/** IM 领域文案 catalog 契约（zh-CN 须齐全）。 */
-interface ImCatalog {
-    system: ImSystemCatalog;
-    mention: ImMentionCatalog;
-    media: ImMediaCatalog;
-    failure: ImFailureCatalog;
-    lastMessage: ImLastMessageCatalog;
-    time: ImTimeCatalog;
-    service: ImServiceCatalog;
+/** 显式迁移请求；不会由 `createImClient()` 在 cache miss 时自动触发。 */
+interface MigrateImCachePrefixInput {
+    accountId: string;
+    fromPrefix: string;
+    toPrefix: string;
+    migrator: ImCachePrefixMigrator;
 }
-/** 非默认 locale 的内置 catalog：允许增量提供，缺失键 fallback 回退 DEFAULT_LOCALE。 */
-type ImPartialCatalog = {
-    [K in keyof ImCatalog]?: Partial<ImCatalog[K]>;
-};
 /**
- * 宿主可覆盖的运行时展示文案。
+ * 在切换 `cache.prefix` 前执行一次显式、可回滚的单账号迁移。
  *
- * `mention` 被明确排除：`mention.all` 不只是 UI 标签，Composer 还会把它写入消息正文，
- * 其它客户端必须用同一组协议词识别。允许单个宿主热改会造成发送词与接收词漂移。
+ * @throws 输入非法、源/目标相同、迁移失败时抛错；若 rollback 也失败，抛出同时包含两项原因的 AggregateError。
+ * @example
+ * ```ts
+ * await migrateImCachePrefix({
+ *   accountId,
+ *   fromPrefix: 'legacy.im.web',
+ *   toPrefix: 'acme.im.web',
+ *   migrator,
+ * })
+ * const client = createImClient({ authProvider, endpointProvider, cache: { prefix: 'acme.im.web' } })
+ * ```
  */
-type ImCatalogOverrides = {
-    [K in Exclude<keyof ImCatalog, 'mention'>]?: Partial<ImCatalog[K]>;
-};
+declare function migrateImCachePrefix(input: MigrateImCachePrefixInput): Promise<void>;
 
 /**
- * IM 语义文案 catalog 的选择、宿主覆盖与默认语言回退。
- *
- * 输入是标准化 `ImLocale`，输出是完整只读 catalog；缺少的键按「宿主覆盖 → SDK 内置译文 → zh-CN 基线」
- * 逐层回退，不访问 Vue i18n、浏览器语言或宿主 Store，因此可在 SSR、Worker 和测试中复用。
+ * 后端协议的目标服务命名。
  *
- * 三层组合（优先级从高到低）：
- *   1) 宿主运行时覆盖（registerImCatalogOverrides 注入）——供内置语言热修普通展示文案，不必等 SDK 发版。
- *   2) SDK 内置分语言译文（PARTIAL_CATALOGS）——开箱即用主体。
- *   3) DEFAULT_LOCALE=zh-CN 基线——保证键恒全。
+ * `core`、`wallet`、`bi` 沿用当前 H5/BFF 已接入的服务分组；`im` 用于后续 IM
+ * HTTP 业务接口直连。调用方应优先通过 `target` 切换服务，而不是在业务代码里手动拼接
+ * baseURL 或 prefix，这样未来从 BFF 迁移到客户端直连时可以只调整运行时配置。
  */
-
+type ApiProtocolTarget = 'core' | 'wallet' | 'bi' | 'im';
 /**
- * 获取指定 locale 的时间语义文案；时间计算与格式化由 Chat Kit 公共工具负责。
+ * 上传进度事件的协议层抽象。
  *
- * @example
- * ```ts
- * getImTimeCatalog('zh-CN').yesterday; // "昨天"
- * ```
+ * 默认 axios transport 会从 AxiosProgressEvent 映射到该结构；如果未来接入原生容器网络层，
+ * 也只需要按相同字段回调业务层即可。
  */
-declare function getImTimeCatalog(locale: ImLocale): Readonly<ImTimeCatalog>;
+interface ApiProtocolUploadProgress {
+    /** 已上传字节数。 */
+    loaded: number;
+    /** 总字节数；部分运行时无法拿到时为空。 */
+    total?: number;
+    /** 0 到 1 之间的上传比例；无法计算时为空。 */
+    progress?: number;
+    /** 底层 transport 的原始进度事件，供调试或特殊场景读取。 */
+    event?: unknown;
+}
 /**
- * 为 SDK 已内置的 locale 注入普通展示文案覆盖（优先级高于内置译文）。
+ * 单次请求完成后的安全状态信息，供调用方识别 HTTP 与业务失败。
  *
- * 注册时会校验非空值、文案键和模板占位符，并复制输入以隔离调用方后续修改。
- * `mention.all` 不能覆盖，因为它会进入发送正文并参与跨端识别；新增 locale 也必须随 SDK
- * catalog 与 @全体识别合同一起发布，不能复用现有 locale 槽位伪装。
- * 同一 locale 多次调用会累积合并；注入后清对应 locale 缓存，下次 catalogFor 生效。
- * @example registerImCatalogOverrides('en-US', { failure: { network: 'Network error, retry.' } })
+ * 不包含请求头、URL、凭据或响应正文；HTTP 状态与后端业务码分别保留，避免把网络
+ * 失败合成的 502 或纯 HTTP 403 当成服务端业务码。原始响应仍通过请求返回值交付。
  */
-declare function registerImCatalogOverrides(locale: ImLocale, partial: ImCatalogOverrides): void;
+interface ApiProtocolResponseObservation {
+    /** 请求结果所属层；成功收到业务错误信封仍属于 `success`。 */
+    transportStatus: 'success' | 'http_error' | 'network_error' | 'invalid_response';
+    /** 服务端真实 HTTP 状态；未收到响应时不存在。 */
+    httpStatus?: number;
+    /** 仅在真实响应正文是协议信封时提供其 code；不包含客户端合成的错误码。 */
+    businessCode?: number;
+}
 /**
- * 清空当前进程的全部宿主覆盖并失效缓存。
+ * 单次协议请求的可覆盖项。
  *
- * 该状态属于应用级文案配置，不属于账号会话；不要在单个用户登出时调用。
- * 仅用于测试隔离，或应用在无并发渲染时整体重载文案管线。
+ * 默认请求会按当前 H5/BFF 协议自动补公共参数、签名、AES 加密、token、语言和设备头。
+ * 只有上传、特殊回调或兼容接口这类非标准请求，才需要显式传 `body`、关闭 `encrypt/sign`
+ * 或使用 `customUrl`。
  */
-declare function resetImCatalogOverrides(): void;
-
+interface ApiProtocolRequestOptions {
+    /** HTTP method，默认 `POST`；`GET` 请求会把协议参数拼到 query。 */
+    method?: string;
+    /** 目标后端服务，默认 `core`。IM 业务请求应传 `im`。 */
+    target?: ApiProtocolTarget;
+    /** 业务参数。数字会按现有协议转换为字符串，避免大整数在 JSON 中丢精度。 */
+    data?: Record<string, unknown>;
+    /** 自定义请求体。传入后默认不做协议加密/签名，适合 FormData 或已编码内容。 */
+    body?: BodyInit | null;
+    /** 追加或覆盖请求头；需要特殊端类型等场景可覆盖公共协议头。 */
+    headers?: HeadersInit;
+    /** 覆盖目标服务默认 prefix。 */
+    prefix?: string;
+    /** 覆盖目标服务默认 baseURL，常用于灰度环境或临时调试。 */
+    baseUrl?: string;
+    /** 覆盖默认渠道 ID。 */
+    channelId?: string;
+    /** 是否对普通请求体执行 AES 加密；默认在无自定义 body 时开启。 */
+    encrypt?: boolean;
+    /** 是否生成协议签名；默认在无自定义 body 时开启。 */
+    sign?: boolean;
+    /** 客户端超时时间，默认 60 秒。 */
+    timeoutMs?: number;
+    /** 覆盖依赖注入中的 token 读取结果；传空字符串可主动发起未登录请求。 */
+    token?: string | null;
+    /** 覆盖依赖注入中的 locale 读取结果。 */
+    locale?: string | null;
+    /** 覆盖浏览器 userAgent 派生逻辑，主要用于测试或容器环境。 */
+    userAgent?: string | null;
+    /** `true` 时 `path` 被视为完整 URL，不再拼接 target baseURL/prefix。 */
+    customUrl?: boolean;
+    /** 外部取消信号，会和内部 timeout 信号合并。 */
+    signal?: AbortSignal;
+    /** 上传进度回调；默认浏览器客户端的 axios transport 支持该能力。 */
+    onUploadProgress?: (progress: ApiProtocolUploadProgress) => void;
+    /**
+     * 请求完成后调用一次，只提供安全状态字段。回调异常会使请求显式失败，不会转换成网络错误。
+     * 调用方如需检查当前账号是否仍有效，可先保存这些字段，在请求返回后决定是否处理。
+     */
+    onResponse?: (observation: ApiProtocolResponseObservation) => void | Promise<void>;
+    /** 跳过客户端注入的全局业务处理器，默认 false；由调用方接管当前请求的业务副作用。 */
+    skipBusinessResponseHandler?: boolean;
+    /**
+     * 响应解析模式。
+     * - `'json'`（默认）：按 content-type 走 JSON / 文本 / AES-JSON 解析，返回业务响应对象。
+     * - `'raw'`：原样返回响应字节（`data` 为 `Uint8Array`），不做 JSON / 文本解析；用于
+     *   protobuf 等二进制接口（如 IM CM 离线消息）。通常与二进制 `body` 搭配使用。
+     */
+    responseMode?: 'json' | 'raw';
+}
 /**
- * 创建绑定固定 locale 的框架无关 IM 语义 formatter。
+ * 后端业务响应体。
  *
- * 该实例只把 Core 的消息、失败和媒体语义转换成文案，不管理响应式 locale，也不包含按钮、Dialog
- * 等宿主 UI 文案。动态语言场景应在调用时传当前 locale，避免旧实例缓存宿主状态。
+ * @template T 业务数据 `data` 的类型；当接口无数据或失败时，`data` 可能为空。
  */
-
-/** 绑定某 locale 的 IM 文案实例（供固定 locale 场景，如 SSR 预渲染 / 测试）。响应式场景用独立 formatXxx（每次传当前 locale）。 */
-interface ImI18n {
-    readonly locale: ImLocale;
-    formatSystemMessage: (body: ImSystemMessageBody, ctx: {
-        resolveName: (uid: string) => string;
-        selfId: string;
-    }) => string;
-    formatLastMessageSummary: (summary: LastMessageSummary, ctx: {
-        resolveName: (uid: string) => string;
-        selfId: string;
-    }) => string;
-    formatMediaPlaceholder: (contentType: MessageContentType, opts?: {
-        durationMs?: number;
-        stickerImageType?: number;
-        gameType?: ImGameType;
-        callKind?: 'audio' | 'video';
-        mediaAlbum?: {
-            imageCount: number;
-            videoCount: number;
-        };
-    }) => string;
-    formatMentionAll: () => string;
-    formatFailure: (displayCode: ImFailureDisplayCode, opts?: {
-        mediaKind?: MediaKind;
-        params?: Record<string, string | number>;
-    }) => string;
+interface ApiProtocolResponse<T = unknown> {
+    code: number;
+    data?: T | null;
+    msg?: string;
+    time?: number;
+    [key: string]: unknown;
 }
 /**
- * 创建 IM 文案工厂：`createImI18n({ defaultLocale })(locale?)` 得到绑定该 locale 的实例（未传 locale 用 defaultLocale）。
- * defaultLocale 对齐宿主默认显示语言（NUXT_PUBLIC_DEFAULT_LOCALE），缺省 DEFAULT_LOCALE=zh-CN；
- * 缺译回退基准恒为 DEFAULT_LOCALE（保证有全量译文），见 catalogFor。
- */
-declare function createImI18n(opts?: {
-    defaultLocale?: ImLocale;
-}): (locale?: ImLocale) => ImI18n;
-
-/**
- * 把 Core/SDK 稳定失败分类格式化为用户可读文案。
- * 不展示 raw cause、协议错误体或凭据，未知分类使用明确通用失败文案而不是空字符串。
- */
-
-/** formatFailure 上下文：locale + 媒体类型（media.* 的 label）+ 模板参数（如 conversationUnsupported 的 type）。 */
-interface FormatFailureContext {
-    locale: ImLocale;
-    mediaKind?: MediaKind;
-    params?: Record<string, string | number>;
-}
-/**
- * 失败展示码 → 气泡文案。media.* 用 mediaKind → label 插值；ACK / 通用码直出；conversationUnsupported 插 params.type。
- * 逐字对齐 core 现有 ImMessageFailure.message（阶段 4b 零回归）。switch 穷尽 ImFailureDisplayCode（编译期兜底）。
- */
-declare function formatFailure(displayCode: ImFailureDisplayCode, ctx: FormatFailureContext): string;
-
-/**
- * 格式化会话列表最新消息摘要。
- * 输入只使用 Core 稳定语义，不解析 raw message body；系统、撤回、媒体等分支由 catalog 统一表达。
+ * 协议客户端函数。
+ *
+ * @template T 业务响应 `data` 类型。
+ * @example
+ * ```ts
+ * const response = await client<{ nickname: string }>('/v1/user/profile', {
+ *   target: 'im',
+ *   data: { userId: '10001' },
+ * });
+ * ```
  */
+type ApiProtocolClient = <T = unknown>(path: string, options?: ApiProtocolRequestOptions) => Promise<ApiProtocolResponse<T>>;
 
-/** formatLastMessageSummary 上下文（同 formatSystemMessage：locale + 名称解析 + selfId）。 */
-interface FormatLastMessageContext {
-    locale: ImLocale;
-    resolveName: (uid: string) => string;
-    selfId: string;
+/** 单个群成员（仅取展示需要字段）。 */
+interface GroupMemberItem {
+    userId: string;
+    /** 群内昵称（展示名优先级第 2 级，仅次于好友备注；可能为空 → 回退全局昵称/userId，见 memberDisplayName）。 */
+    nickName: string;
+    /**
+     * 成员加入方式（后端 join_type，**真机实证**：`0`=主动/初始、`2`=被邀请）。**不标识群主**——后端此接口不返回 role_id，
+     * 群主以 `GroupProfile.ownerId`（`/user_group/info` 的 user_id）为准；安卓本地 DB 的 `joinType`(3=群主) 是客户端二次覆盖、非本接口语义。
+     * 保留解析供未来「入群方式」展示。缺省=后端未返回。
+     */
+    joinType?: number;
 }
-/**
- * 会话列表「最后一条」摘要 → 展示文案。text 直出正文；media 用会话列表占位（[图片]…[加密消息]，区别于回复摘要 formatMediaPlaceholder 的「照片…」）；
- * system 复用 formatSystemMessage（统一带成员名版，消除会话列表/气泡两套模板，见阶段 4a 决策）；recalled 按 by 是否 self 渲染。
- */
-declare function formatLastMessageSummary(summary: LastMessageSummary, ctx: FormatLastMessageContext): string;
-
-/** 把图片、视频、语音、文件等正文类型映射为 locale 对应的稳定媒体占位文案。 */
 
-/** formatMediaPlaceholder 上下文：locale + 媒体正文中影响占位文案的稳定子类型。 */
-interface FormatMediaPlaceholderContext {
-    locale: ImLocale;
-    durationMs?: number;
-    /** EXPRESSION 的协议 imageType；1=GIF，其余/缺省按静态贴图展示。 */
-    stickerImageType?: number;
-    /** 小游戏类型；缺失或非法时不把损坏正文伪装成任一种游戏。 */
-    gameType?: ImGameType;
-    /** 通话记录媒体类型；缺失时不把损坏正文伪装成语音或视频通话。 */
-    callKind?: 'audio' | 'video';
+interface ProfileHttpAdapterDeps {
+    /** 宿主注入的协议客户端（如 Nuxt `$clientApi`）；本适配作为调用方走 core JSON 链路拉资料。 */
+    client: ApiProtocolClient;
+    /** 端类型 clientType（Web/H5=2）：透传给群资料/成员接口写 `Client-type` header，对齐后端全链路一致建议（Review F5）。缺省不带。 */
+    clientType?: number;
     /**
-     * 媒体合集的项数构成；缺失或两个计数都是 0 时返回空串，不假装有内容。
-     *
-     * **不含配文**：与单视频消息的 `describe` 一样，本函数只负责类型占位，正文文本由调用方决定
-     * 要不要优先显示（引用摘要通常会把配文走自己的表情/@ 分段管线，不该从这里绕过去）。
+     * 本地持久化端口（O3）：注入后 `getUserProfile`/`getGroupMemberNames` 走三级缓存（内存→持久化→HTTP），跨刷新消除群历史发送者「占位→回填」闪动。
+     * 只用 profile/member 四方法；**缺省 = 纯内存**（向后兼容）。storage 未 open / 读写异常时自动**降级 HTTP-only**（不阻塞不报错，符合 storage=downstream 原则）。
+     * open 时序：与 SDK 共享同一 storage 实例，SDK `connect()` 统一 `open(namespace=userId)`；本适配读写前 open 未完成即降级。
      */
-    mediaAlbum?: {
-        imageCount: number;
-        videoCount: number;
-    };
+    storage?: Pick<ImStoragePort, 'getUserProfile' | 'saveUserProfile' | 'getGroupMembers' | 'saveGroupMembers' | 'getGroupProfile' | 'saveGroupProfile'>;
 }
-/**
- * 媒体消息 → 单行占位文案（回复摘要 / 会话预览降级用）。对齐 use-message-preview：
- * image→照片、sticker→GIF/贴图、game→骰子/石头剪刀布、video→视频、file→文件、contact→名片、
- * miniProgram→小程序、voice→「语音」（durationMs>0 时「语音 m:ss」）。text / system 以及缺少合法 gameType 的损坏正文返回空串。
- */
-declare function formatMediaPlaceholder(contentType: MessageContentType, ctx: FormatMediaPlaceholderContext): string;
-
-/**
- * 生成 @所有人 的接收端展示文案。
- * 展示按接收端当前语言（本函数按 locale 取词），与「识别发送端多语言正文」的匹配词表分离；
- * `@` 前缀在此统一拼接，catalog 只存可翻译的词（如「所有人」/「All」），避免各宿主各存一份。
- */
-
-/**
- * @所有人 展示文案 → `@` + 当前 locale 的本地化词。供宿主注入 resolveTextSegments 的 `atAllDisplay`，
- * 使收到的 @所有人 段按接收端语言展示（不随发送端原文）。
- * @example formatMentionAll('en-US') // '@All'
- */
-declare function formatMentionAll(locale: ImLocale): string;
-
-/**
- * 格式化 Chat Kit service 返回的稳定文本键与参数。
- * Service 不依赖 locale 或宿主 i18n；只有 Web/H5 最终反馈边界调用本函数生成文案。
- */
-
-/** formatServiceText 上下文：locale + 模板参数（如 {reason}=原始报错、{label}=媒体类型名、{size}=字节数）。 */
-interface FormatServiceTextContext {
-    locale: ImLocale;
-    params?: Record<string, string | number>;
+/** 群成员昵称提供者（createProfileHttpAdapter 在 ImProfilePort 之外附加，切片13/P1）：供宿主解析群消息发送者展示名（群内昵称优先级由宿主决定；Android 为好友备注 > 群内昵称 > 全局昵称）。 */
+interface GroupMemberNameProvider {
+    /** 取群内成员昵称映射（userId → 群内昵称，空昵称成员不含）；空/失败 → null（调用方回退用户资料名）。缓存 + 同 id 去抖 + forceRefresh。 */
+    getGroupMemberNames: (groupId: string, opts?: {
+        forceRefresh?: boolean;
+    }) => Promise<Record<string, string> | null>;
+    /** 群成员有序列表（群设置面板用）：`{ userId, nickName }` 按后端返回序；空/失败 null。缓存 + forceRefresh。头像/全局昵称由宿主按 userId 走 getUserProfile（复用 O3 缓存）。 */
+    listGroupMembers: (groupId: string, opts?: {
+        forceRefresh?: boolean;
+    }) => Promise<GroupMemberItem[] | null>;
+    /** O3 prewarm（Review F1/三轮）：仅从内存+持久化读用户资料（**不回源 HTTP**），命中返回 `{ value, stale }`、未命中 null；`stale`=持久化过期。供进会话前首屏预热+据 stale 后台刷新。 */
+    peekUserProfile: (userId: string) => Promise<{
+        value: UserProfile;
+        stale: boolean;
+    } | null>;
+    /** O3 prewarm（Review F1/三轮）：仅从内存+持久化读群成员昵称（不回源 HTTP），命中 `{ value, stale }`、未命中 null。 */
+    peekGroupMemberNames: (groupId: string) => Promise<{
+        value: Record<string, string>;
+        stale: boolean;
+    } | null>;
+    /** O3 prewarm：仅从内存+持久化读**有序成员列表**（不回源 HTTP），命中 `{ value, stale }`、未命中 null。供群设置面板打开时先本地秒显。 */
+    peekGroupMembers: (groupId: string) => Promise<{
+        value: GroupMemberItem[];
+        stale: boolean;
+    } | null>;
+    /** O3 prewarm：仅从内存+持久化读群资料（不回源 HTTP），命中 `{ value, stale }`、未命中 null。供受限群本地标群主（ownerId）。 */
+    peekGroupProfile: (groupId: string) => Promise<{
+        value: GroupProfile;
+        stale: boolean;
+    } | null>;
 }
-/**
- * 命令/生命周期「操作提示」码 → 文案（供 kit services / runtime 产码、宿主按 locale 渲染）。
- * 平铺 key + 通用 `{...}` 插值（不做穷尽 switch，key 联合由 ImServiceTextKey 编译期保证齐全）。
- * 动态原始报错经 params.reason 拼接，不入 catalog（诊断，不翻译）。
- */
-declare function formatServiceText(key: ImServiceTextKey, ctx: FormatServiceTextContext): string;
-
-/**
- * 把已归一化系统消息语义格式化为当前 locale 文案。
- * 不读取协议 notify/raw payload；缺字段使用 catalog 的稳定降级文案，不猜测操作者或目标身份。
- */
+/** 创建用户 / 群资料 HTTP 适配（实现 ImProfilePort + 群成员昵称）：编排 requests/ 原子请求 + 回退 + 缓存 + 归一。 */
+declare function createProfileHttpAdapter(deps: ProfileHttpAdapterDeps): ImProfilePort & GroupMemberNameProvider;
 
-/** formatSystemMessage 上下文：locale + 名称解析（宿主提供，已按备注>群昵称>昵称解析）+ selfId（判「你」）。 */
-interface FormatSystemMessageContext {
-    locale: ImLocale;
-    resolveName: (uid: string) => string;
-    selfId: string;
+/** 服务端对入群请求的最终裁决：已入群，或已提交并等待管理员审核。 */
+type MembershipJoinOutcome = 'joined' | 'waiting';
+/** Browser adapter 暴露给 SDK 的稳定入群结果，不携带具体 HTTP 响应结构。 */
+interface MembershipJoinResult {
+    /** 调用成功后当前用户所处的成员状态。 */
+    outcome: MembershipJoinOutcome;
 }
-/**
- * 系统消息（群通知）→ 展示文案：按 eventType 取 catalog 模板 + 插值成员名。对齐宿主 MessageThread 气泡口径
- *（带成员名、operator/target===selfId → 「你」、target 缺失用缺省占位「新成员/成员/新群主」）。
- * 已知 eventType 一律走 catalog；仅 unknown 用 fallbackText（后端原文）兜底、无则 catalog.system.unknown（§C.3 fallback 矩阵）。
- */
-declare function formatSystemMessage(body: ImSystemMessageBody, ctx: FormatSystemMessageContext): string;
-
-/**
- * 在宿主显式授权时迁移旧 `cache.prefix` 下的当前账号本地数据。
- * 迁移使用新旧 namespace factory 精确定位，不扫描未知库，也不自动删除源数据；失败必须由调用方处理。
- */
 
-/** 单账号缓存前缀迁移上下文；账号只用于定位数据，不得拼入宿主 prefix。 */
-interface ImCachePrefixMigrationContext {
-    /** 待迁移账号的稳定 id，仅用于选择该账号的数据分区。 */
-    accountId: string;
-    /** 仍保留源数据的旧产品/环境前缀。 */
-    fromPrefix: string;
-    /** 迁移成功后由宿主传给 `createImClient()` 的新前缀。 */
-    toPrefix: string;
-    /** 读取源账号数据时唯一允许使用的 namespace factory。 */
-    fromNamespaceFactory: ImCacheNamespaceFactory;
-    /** 写入/回滚目标账号数据时唯一允许使用的 namespace factory。 */
-    toNamespaceFactory: ImCacheNamespaceFactory;
+/** 服务端按逻辑桶签发的 S3 临时上传凭证（已归一为 SDK 合同字段）。 */
+interface MediaUploadCredentials {
+    /** STS access key id（服务端字段 `access_key_id`）。 */
+    accessKeyId: string;
+    /** STS secret access key（服务端字段 `secret_key`）。 */
+    secretAccessKey: string;
+    /** STS session token（服务端字段 `session_token`）。 */
+    sessionToken: string;
+    /** 服务端声明的过期时间（Unix 秒）；缺省时该凭证只受 SDK 本地 TTL 约束。 */
+    expiresAtSeconds?: number;
+    /** 服务端解析出的**物理桶**名，可能与申请用的逻辑桶名不同；PutObject 必须用它。 */
+    bucket: string;
+    /** 物理桶所在区域，决定上传端点；不再从身份池 id 前缀推断。 */
+    region: string;
+    /** 对象 key 前缀；STS 策略只允许写该前缀下的对象，SDK 生成的 key 必须以它开头。 */
+    keyPrefix?: string;
+    /** 公开访问域名（已归一为带 scheme、无尾斜杠）；写进消息体的媒体 URL 以它为准。 */
+    dnsPoint: string;
+    /** 服务端身份标识；SDK 不使用，仅原样透出供宿主排查。 */
+    identityId?: string;
+}
+/** SDK 向宿主申请凭证时给出的上下文。 */
+interface MediaUploadCredentialsRequest {
+    /** 宿主 env 配置的**逻辑桶名**；宿主原样提交给自己的 BFF。 */
+    bucket: string;
+    /** true 表示 SDK 判定旧凭证不可用（上传被拒或已过期），宿主必须真的重新请求，不得返回自己的缓存。 */
+    forceRefresh: boolean;
 }
 /**
- * 宿主/介质实现的显式前缀迁移器。
+ * 宿主注入的取凭证函数：按逻辑桶名向宿主自己的 BFF 申请一次 STS 临时凭证。
  *
- * @remarks SDK 不猜 IndexedDB、SQLite 或文件系统的复制方式；实现方必须保留源数据，并能撤销目标侧的部分写入。
+ * @remarks 这里刻意不带 `AbortSignal`：同一逻辑桶的并发上传会共用同一次在途请求，
+ * 单个上传被取消不应连带中止其它上传正在等待的凭证。宿主实现应当是「打一次接口」的纯函数，
+ * 缓存、TTL、单飞与失败重签由 SDK 负责。
  */
-interface ImCachePrefixMigrator {
-    /** 将单账号数据复制/转换到目标前缀；失败时必须 reject，不能吞错或删除源数据。 */
-    migrate: (context: ImCachePrefixMigrationContext) => Promise<void>;
-    /** 清理本次迁移在目标侧留下的部分结果；`cause` 是原始迁移错误。 */
-    rollback: (context: ImCachePrefixMigrationContext, cause: unknown) => Promise<void>;
-}
-/** 显式迁移请求；不会由 `createImClient()` 在 cache miss 时自动触发。 */
-interface MigrateImCachePrefixInput {
-    accountId: string;
-    fromPrefix: string;
-    toPrefix: string;
-    migrator: ImCachePrefixMigrator;
-}
+type MediaUploadCredentialsProvider = (request: MediaUploadCredentialsRequest) => Promise<MediaUploadCredentials>;
 /**
- * 在切换 `cache.prefix` 前执行一次显式、可回滚的单账号迁移。
+ * 把服务端原始回包归一为 `MediaUploadCredentials`，同时兼容 snake_case 与 camelCase。
  *
- * @throws 输入非法、源/目标相同、迁移失败时抛错；若 rollback 也失败，抛出同时包含两项原因的 AggregateError。
- * @example
- * ```ts
- * await migrateImCachePrefix({
- *   accountId,
- *   fromPrefix: 'legacy.im.web',
- *   toPrefix: 'acme.im.web',
- *   migrator,
- * })
- * const client = createImClient({ authProvider, endpointProvider, cache: { prefix: 'acme.im.web' } })
- * ```
+ * 宿主可直接用它解析自己 BFF 的返回值，避免 PC 与 H5 各写一份宽松解析；SDK 在收到 provider
+ * 结果后也会再跑一次本函数，因此绕过它自行构造的对象同样会被校验。
+ *
+ * @param raw 凭证对象本身（不含 code/msg 外层包装，由宿主先拆包）。
+ * @returns 归一后的凭证；关键字段缺失或非法时抛 `MediaTransferError('credentials-invalid')`，不返回半份凭证。
  */
-declare function migrateImCachePrefix(input: MigrateImCachePrefixInput): Promise<void>;
-
-/**
- * 后端协议的目标服务命名。
- *
- * `core`、`wallet`、`bi` 沿用当前 H5/BFF 已接入的服务分组；`im` 用于后续 IM
- * HTTP 业务接口直连。调用方应优先通过 `target` 切换服务，而不是在业务代码里手动拼接
- * baseURL 或 prefix，这样未来从 BFF 迁移到客户端直连时可以只调整运行时配置。
- */
-type ApiProtocolTarget = 'core' | 'wallet' | 'bi' | 'im';
-/**
- * 上传进度事件的协议层抽象。
- *
- * 默认 axios transport 会从 AxiosProgressEvent 映射到该结构；如果未来接入原生容器网络层，
- * 也只需要按相同字段回调业务层即可。
- */
-interface ApiProtocolUploadProgress {
-    /** 已上传字节数。 */
-    loaded: number;
-    /** 总字节数；部分运行时无法拿到时为空。 */
-    total?: number;
-    /** 0 到 1 之间的上传比例；无法计算时为空。 */
-    progress?: number;
-    /** 底层 transport 的原始进度事件，供调试或特殊场景读取。 */
-    event?: unknown;
-}
-/**
- * 单次请求完成后的安全状态信息，供调用方识别 HTTP 与业务失败。
- *
- * 不包含请求头、URL、凭据或响应正文；HTTP 状态与后端业务码分别保留，避免把网络
- * 失败合成的 502 或纯 HTTP 403 当成服务端业务码。原始响应仍通过请求返回值交付。
- */
-interface ApiProtocolResponseObservation {
-    /** 请求结果所属层；成功收到业务错误信封仍属于 `success`。 */
-    transportStatus: 'success' | 'http_error' | 'network_error' | 'invalid_response';
-    /** 服务端真实 HTTP 状态；未收到响应时不存在。 */
-    httpStatus?: number;
-    /** 仅在真实响应正文是协议信封时提供其 code；不包含客户端合成的错误码。 */
-    businessCode?: number;
-}
-/**
- * 单次协议请求的可覆盖项。
- *
- * 默认请求会按当前 H5/BFF 协议自动补公共参数、签名、AES 加密、token、语言和设备头。
- * 只有上传、特殊回调或兼容接口这类非标准请求，才需要显式传 `body`、关闭 `encrypt/sign`
- * 或使用 `customUrl`。
- */
-interface ApiProtocolRequestOptions {
-    /** HTTP method，默认 `POST`；`GET` 请求会把协议参数拼到 query。 */
-    method?: string;
-    /** 目标后端服务，默认 `core`。IM 业务请求应传 `im`。 */
-    target?: ApiProtocolTarget;
-    /** 业务参数。数字会按现有协议转换为字符串，避免大整数在 JSON 中丢精度。 */
-    data?: Record<string, unknown>;
-    /** 自定义请求体。传入后默认不做协议加密/签名，适合 FormData 或已编码内容。 */
-    body?: BodyInit | null;
-    /** 追加或覆盖请求头；需要特殊端类型等场景可覆盖公共协议头。 */
-    headers?: HeadersInit;
-    /** 覆盖目标服务默认 prefix。 */
-    prefix?: string;
-    /** 覆盖目标服务默认 baseURL，常用于灰度环境或临时调试。 */
-    baseUrl?: string;
-    /** 覆盖默认渠道 ID。 */
-    channelId?: string;
-    /** 是否对普通请求体执行 AES 加密；默认在无自定义 body 时开启。 */
-    encrypt?: boolean;
-    /** 是否生成协议签名；默认在无自定义 body 时开启。 */
-    sign?: boolean;
-    /** 客户端超时时间，默认 60 秒。 */
-    timeoutMs?: number;
-    /** 覆盖依赖注入中的 token 读取结果；传空字符串可主动发起未登录请求。 */
-    token?: string | null;
-    /** 覆盖依赖注入中的 locale 读取结果。 */
-    locale?: string | null;
-    /** 覆盖浏览器 userAgent 派生逻辑，主要用于测试或容器环境。 */
-    userAgent?: string | null;
-    /** `true` 时 `path` 被视为完整 URL，不再拼接 target baseURL/prefix。 */
-    customUrl?: boolean;
-    /** 外部取消信号，会和内部 timeout 信号合并。 */
-    signal?: AbortSignal;
-    /** 上传进度回调；默认浏览器客户端的 axios transport 支持该能力。 */
-    onUploadProgress?: (progress: ApiProtocolUploadProgress) => void;
-    /**
-     * 请求完成后调用一次，只提供安全状态字段。回调异常会使请求显式失败，不会转换成网络错误。
-     * 调用方如需检查当前账号是否仍有效，可先保存这些字段，在请求返回后决定是否处理。
-     */
-    onResponse?: (observation: ApiProtocolResponseObservation) => void | Promise<void>;
-    /** 跳过客户端注入的全局业务处理器，默认 false；由调用方接管当前请求的业务副作用。 */
-    skipBusinessResponseHandler?: boolean;
-    /**
-     * 响应解析模式。
-     * - `'json'`（默认）：按 content-type 走 JSON / 文本 / AES-JSON 解析，返回业务响应对象。
-     * - `'raw'`：原样返回响应字节（`data` 为 `Uint8Array`），不做 JSON / 文本解析；用于
-     *   protobuf 等二进制接口（如 IM CM 离线消息）。通常与二进制 `body` 搭配使用。
-     */
-    responseMode?: 'json' | 'raw';
-}
-/**
- * 后端业务响应体。
- *
- * @template T 业务数据 `data` 的类型；当接口无数据或失败时，`data` 可能为空。
- */
-interface ApiProtocolResponse<T = unknown> {
-    code: number;
-    data?: T | null;
-    msg?: string;
-    time?: number;
-    [key: string]: unknown;
-}
-/**
- * 协议客户端函数。
- *
- * @template T 业务响应 `data` 类型。
- * @example
- * ```ts
- * const response = await client<{ nickname: string }>('/v1/user/profile', {
- *   target: 'im',
- *   data: { userId: '10001' },
- * });
- * ```
- */
-type ApiProtocolClient = <T = unknown>(path: string, options?: ApiProtocolRequestOptions) => Promise<ApiProtocolResponse<T>>;
-
-/** 单个群成员（仅取展示需要字段）。 */
-interface GroupMemberItem {
-    userId: string;
-    /** 群内昵称（展示名优先级第 2 级，仅次于好友备注；可能为空 → 回退全局昵称/userId，见 memberDisplayName）。 */
-    nickName: string;
-    /**
-     * 成员加入方式（后端 join_type，**真机实证**：`0`=主动/初始、`2`=被邀请）。**不标识群主**——后端此接口不返回 role_id，
-     * 群主以 `GroupProfile.ownerId`（`/user_group/info` 的 user_id）为准；安卓本地 DB 的 `joinType`(3=群主) 是客户端二次覆盖、非本接口语义。
-     * 保留解析供未来「入群方式」展示。缺省=后端未返回。
-     */
-    joinType?: number;
-}
-
-interface ProfileHttpAdapterDeps {
-    /** 宿主注入的协议客户端（如 Nuxt `$clientApi`）；本适配作为调用方走 core JSON 链路拉资料。 */
-    client: ApiProtocolClient;
-    /** 端类型 clientType（Web/H5=2）：透传给群资料/成员接口写 `Client-type` header，对齐后端全链路一致建议（Review F5）。缺省不带。 */
-    clientType?: number;
-    /**
-     * 本地持久化端口（O3）：注入后 `getUserProfile`/`getGroupMemberNames` 走三级缓存（内存→持久化→HTTP），跨刷新消除群历史发送者「占位→回填」闪动。
-     * 只用 profile/member 四方法；**缺省 = 纯内存**（向后兼容）。storage 未 open / 读写异常时自动**降级 HTTP-only**（不阻塞不报错，符合 storage=downstream 原则）。
-     * open 时序：与 SDK 共享同一 storage 实例，SDK `connect()` 统一 `open(namespace=userId)`；本适配读写前 open 未完成即降级。
-     */
-    storage?: Pick<ImStoragePort, 'getUserProfile' | 'saveUserProfile' | 'getGroupMembers' | 'saveGroupMembers' | 'getGroupProfile' | 'saveGroupProfile'>;
-}
-/** 群成员昵称提供者（createProfileHttpAdapter 在 ImProfilePort 之外附加，切片13/P1）：供宿主解析群消息发送者展示名（群内昵称优先级由宿主决定；Android 为好友备注 > 群内昵称 > 全局昵称）。 */
-interface GroupMemberNameProvider {
-    /** 取群内成员昵称映射（userId → 群内昵称，空昵称成员不含）；空/失败 → null（调用方回退用户资料名）。缓存 + 同 id 去抖 + forceRefresh。 */
-    getGroupMemberNames: (groupId: string, opts?: {
-        forceRefresh?: boolean;
-    }) => Promise<Record<string, string> | null>;
-    /** 群成员有序列表（群设置面板用）：`{ userId, nickName }` 按后端返回序；空/失败 null。缓存 + forceRefresh。头像/全局昵称由宿主按 userId 走 getUserProfile（复用 O3 缓存）。 */
-    listGroupMembers: (groupId: string, opts?: {
-        forceRefresh?: boolean;
-    }) => Promise<GroupMemberItem[] | null>;
-    /** O3 prewarm（Review F1/三轮）：仅从内存+持久化读用户资料（**不回源 HTTP**），命中返回 `{ value, stale }`、未命中 null；`stale`=持久化过期。供进会话前首屏预热+据 stale 后台刷新。 */
-    peekUserProfile: (userId: string) => Promise<{
-        value: UserProfile;
-        stale: boolean;
-    } | null>;
-    /** O3 prewarm（Review F1/三轮）：仅从内存+持久化读群成员昵称（不回源 HTTP），命中 `{ value, stale }`、未命中 null。 */
-    peekGroupMemberNames: (groupId: string) => Promise<{
-        value: Record<string, string>;
-        stale: boolean;
-    } | null>;
-    /** O3 prewarm：仅从内存+持久化读**有序成员列表**（不回源 HTTP），命中 `{ value, stale }`、未命中 null。供群设置面板打开时先本地秒显。 */
-    peekGroupMembers: (groupId: string) => Promise<{
-        value: GroupMemberItem[];
-        stale: boolean;
-    } | null>;
-    /** O3 prewarm：仅从内存+持久化读群资料（不回源 HTTP），命中 `{ value, stale }`、未命中 null。供受限群本地标群主（ownerId）。 */
-    peekGroupProfile: (groupId: string) => Promise<{
-        value: GroupProfile;
-        stale: boolean;
-    } | null>;
-}
-/** 创建用户 / 群资料 HTTP 适配（实现 ImProfilePort + 群成员昵称）：编排 requests/ 原子请求 + 回退 + 缓存 + 归一。 */
-declare function createProfileHttpAdapter(deps: ProfileHttpAdapterDeps): ImProfilePort & GroupMemberNameProvider;
-
-/** 服务端对入群请求的最终裁决：已入群，或已提交并等待管理员审核。 */
-type MembershipJoinOutcome = 'joined' | 'waiting';
-/** Browser adapter 暴露给 SDK 的稳定入群结果，不携带具体 HTTP 响应结构。 */
-interface MembershipJoinResult {
-    /** 调用成功后当前用户所处的成员状态。 */
-    outcome: MembershipJoinOutcome;
-}
-
-/** 服务端按逻辑桶签发的 S3 临时上传凭证（已归一为 SDK 合同字段）。 */
-interface MediaUploadCredentials {
-    /** STS access key id（服务端字段 `access_key_id`）。 */
-    accessKeyId: string;
-    /** STS secret access key（服务端字段 `secret_key`）。 */
-    secretAccessKey: string;
-    /** STS session token（服务端字段 `session_token`）。 */
-    sessionToken: string;
-    /** 服务端声明的过期时间（Unix 秒）；缺省时该凭证只受 SDK 本地 TTL 约束。 */
-    expiresAtSeconds?: number;
-    /** 服务端解析出的**物理桶**名，可能与申请用的逻辑桶名不同；PutObject 必须用它。 */
-    bucket: string;
-    /** 物理桶所在区域，决定上传端点；不再从身份池 id 前缀推断。 */
-    region: string;
-    /** 对象 key 前缀；STS 策略只允许写该前缀下的对象，SDK 生成的 key 必须以它开头。 */
-    keyPrefix?: string;
-    /** 公开访问域名（已归一为带 scheme、无尾斜杠）；写进消息体的媒体 URL 以它为准。 */
-    dnsPoint: string;
-    /** 服务端身份标识；SDK 不使用，仅原样透出供宿主排查。 */
-    identityId?: string;
-}
-/** SDK 向宿主申请凭证时给出的上下文。 */
-interface MediaUploadCredentialsRequest {
-    /** 宿主 env 配置的**逻辑桶名**；宿主原样提交给自己的 BFF。 */
-    bucket: string;
-    /** true 表示 SDK 判定旧凭证不可用（上传被拒或已过期），宿主必须真的重新请求，不得返回自己的缓存。 */
-    forceRefresh: boolean;
-}
-/**
- * 宿主注入的取凭证函数：按逻辑桶名向宿主自己的 BFF 申请一次 STS 临时凭证。
- *
- * @remarks 这里刻意不带 `AbortSignal`：同一逻辑桶的并发上传会共用同一次在途请求，
- * 单个上传被取消不应连带中止其它上传正在等待的凭证。宿主实现应当是「打一次接口」的纯函数，
- * 缓存、TTL、单飞与失败重签由 SDK 负责。
- */
-type MediaUploadCredentialsProvider = (request: MediaUploadCredentialsRequest) => Promise<MediaUploadCredentials>;
-/**
- * 把服务端原始回包归一为 `MediaUploadCredentials`，同时兼容 snake_case 与 camelCase。
- *
- * 宿主可直接用它解析自己 BFF 的返回值，避免 PC 与 H5 各写一份宽松解析；SDK 在收到 provider
- * 结果后也会再跑一次本函数，因此绕过它自行构造的对象同样会被校验。
- *
- * @param raw 凭证对象本身（不含 code/msg 外层包装，由宿主先拆包）。
- * @returns 归一后的凭证；关键字段缺失或非法时抛 `MediaTransferError('credentials-invalid')`，不返回半份凭证。
- */
-declare function normalizeMediaUploadCredentials(raw: unknown): MediaUploadCredentials;
+declare function normalizeMediaUploadCredentials(raw: unknown): MediaUploadCredentials;
 
 interface MediaTransferAdapterConfig {
     /**
@@ -7168,187 +6646,798 @@ interface AdvancedConversationsApi extends ImConversationsApi, ImConversationBac
     ensureOpenableConversation: (ref: ConversationRef) => Promise<ConversationRef<'direct' | 'group' | 'channel'>>;
 }
 /**
- * 普通宿主的真实 default client。
- *
- * @remarks 该对象只包含稳定产品域；internal/testing 工厂返回的完整 client 仍复用同一 SessionRuntime，
- * 不会为 profile cache、diagnostics 或 compatibility 创建第二套状态源。
- * @example
- * ```ts
- * const client = createImClient({ authProvider, endpointProvider, cache: { prefix: 'acme.im.production' } })
- * await client.session.start()
- * const direct = await client.openConversation({ conversationType: 'direct', conversationId: '42' })
- * direct.close()
- * await client.dispose()
- * ```
+ * 普通宿主的真实 default client。
+ *
+ * @remarks 该对象只包含稳定产品域；internal/testing 工厂返回的完整 client 仍复用同一 SessionRuntime，
+ * 不会为 profile cache、diagnostics 或 compatibility 创建第二套状态源。
+ * @example
+ * ```ts
+ * const client = createImClient({ authProvider, endpointProvider, cache: { prefix: 'acme.im.production' } })
+ * await client.session.start()
+ * const direct = await client.openConversation({ conversationType: 'direct', conversationId: '42' })
+ * direct.close()
+ * await client.dispose()
+ * ```
+ */
+interface ImProductClient {
+    /** 当前设备推送订阅的服务端绑定与同步状态。 */
+    readonly push: ImPushApi;
+    readonly session: ImSessionApi;
+    readonly capabilities: ImConversationCapabilitiesApi;
+    readonly conversations: ImConversationListApi;
+    /** 当前账号完整联系人、群组和社群目录的统一搜索。 */
+    readonly directory: ImDirectorySearchApi;
+    readonly contacts: ImContactsApi;
+    readonly groups: ImGroupsApi;
+    readonly channels: ImChannelsApi;
+    readonly applications: ImApplicationsApi;
+    readonly expressions: ImExpressionsApi;
+    readonly sessionFavorites: ImSessionFavoritesApi;
+    readonly outbox: ImOutboxApi;
+    readonly drafts: ImDraftsApi;
+    readonly search: ImSearchApi;
+    readonly media: ImMediaTasksApi;
+    /** 当前账号本机 IM 偏好；不隐含服务端或多端设置同步。 */
+    readonly settings: ImSettingsApi;
+    readonly localData: ImLocalDataApi;
+    readonly events: ImEventsApi;
+    /**
+     * 打开或发起一个精确类型的产品会话。
+     *
+     * @remarks 已有会话直接复用；会话缺失时，SDK 会先校验当前账号目录对象或权威资料/成员状态，
+     * 再把空摘要提交到唯一 DomainState。失败不会创建假会话，宿主也不需要先修改会话列表 Store。
+     */
+    openConversation: ImClient['openConversation'];
+    dispose: () => Promise<void>;
+}
+/**
+ * internal/testing 完整门面：保留 `connection` 与 singular profile/member/cache 域。
+ * 普通宿主只使用 `ImProductClient`；官方 Chat Kit 和受控诊断从 internal 子入口取得 `ImAdvancedClient`。
+ */
+interface ImClient extends Omit<ImProductClient, 'capabilities' | 'channels' | 'contacts' | 'conversations' | 'groups'> {
+    /** internal/testing 与高级宿主使用的单聊音视频信令；稳定 default 产品门面不暴露此能力。 */
+    readonly calls: ImDirectCallsApi;
+    /** internal/testing 群通话门面。 */
+    readonly groupCalls: ImGroupCallsApi;
+    /**
+     * 打开一个拥有独立连续窗口与生命周期的 direct、GROUP 或 CHANNEL 会话句柄。
+     *
+     * @remarks 三类会话按精确类型进入各自 sibling；`supergroup` 继续拒绝。
+     * @example
+     * ```ts
+     * const handle = await client.openConversation({ conversationType: 'direct', conversationId: '42' })
+     * try { await handle.history.loadLatest() } finally { handle.close() }
+     * const group = await client.openConversation({ conversationType: 'group', conversationId: '9001' })
+     * await group.messages.sendText('hello [2002]', { mentions: [{ userId: '2002', displayName: 'Alice' }] })
+     * group.close()
+     * ```
+     */
+    openConversation: {
+        (ref: ConversationRef<'direct'>, options?: ConversationOpenOptions): Promise<ConversationHandle<'direct'>>;
+        (ref: ConversationRef<'group'>, options?: ConversationOpenOptions): Promise<ConversationHandle<'group'>>;
+        (ref: ConversationRef<'channel'>, options?: ConversationOpenOptions): Promise<ConversationHandle<'channel'>>;
+    };
+    /** 当前账号草稿产品面；按复合身份持久化，handle.draft 委托同一状态源。 */
+    drafts: ImDraftsApi;
+    /** 连接域：连接生命周期 + 事件订阅 + 快照。 */
+    connection: ImConnectionApi;
+    /** 会话域：会话列表 + 离线拉取。 */
+    conversations: AdvancedConversationsApi;
+    /** advanced 联系人复数门面保留 core DTO；default 外壳另做稳定投影。 */
+    contacts: AdvancedContactsApi;
+    /** advanced GROUP 复数门面保留 core DTO；default 外壳另做稳定投影。 */
+    groups: AdvancedGroupsApi;
+    /** advanced CHANNEL 复数门面保留 core DTO；default 外壳另做稳定投影。 */
+    channels: AdvancedChannelsApi;
+    /** 好友域：好友资料读取 + 设置备注。 */
+    contact: ImContactApi;
+    /** 群域：群资料读取 + 修改群名/群头像/群内昵称。 */
+    group: ImGroupApi;
+    /** CHANNEL 域：资料、成员治理与独立置顶能力；仍未闭合的动作不进入此门面。 */
+    channel: ImChannelApi;
+    /** 可观察媒体任务与按精确消息引用下载。 */
+    media: ImMediaTasksApi;
+    /** 可靠发送账本的稳定查询、订阅、重试和本地 queued 取消控制面。 */
+    outbox: ImOutboxApi;
+    /** 当前 prefix/account 的分类查询、rebuildable 清理与精确账号 purge。 */
+    localData: ImLocalDataApi;
+    /** 已同步会话和本地消息的分场景搜索；底层 cursor 只存在于不透明 page token。 */
+    search: ImSearchApi;
+    /** 联系人、GROUP、CHANNEL pending 申请的 typed 聚合；动作按 ref.domain 回到对应 sibling。 */
+    applications: ImApplicationsApi;
+    /**
+     * 登出当前账号（§4.4/§8）：先把在途 Outbox 移出自动复发（默认 `pendingMessages:'fail'`），再断连 + 停计时器 + 清领域内存 + 关本地库句柄；
+     * `localData:'purge'` 仅在句柄成功关闭后额外删除 teardown 起点捕获的本账号库（默认 `preserve` 保留）；关闭或删除失败通过 storage error 暴露，
+     * 不回退猜测其它 adapter/前缀。随后可继续 prepare/connect 下一账号（同实例复用）。
+     * 不反向调用宿主鉴权登出——由宿主编排。dispose 后调用 reject。
+     */
+    logout: (options?: ImLogoutOptions) => Promise<void>;
+    /** 终态销毁（§4.5）：先 teardown 当前账号，再清空事件订阅；幂等；此后实例不可复用。用于应用卸载 / HMR / 微前端子应用销毁。 */
+    dispose: () => Promise<void>;
+}
+/**
+ * 官方 UI Kit、调试工具和高级宿主持有的完整 client。
+ *
+ * @remarks 该类型包含 singular profile/member/cache 域；普通宿主只使用 `ImProductClient`。
+ */
+type ImAdvancedClient = ImClient;
+/**
+ * 创建账号无关的 IM client 外壳；实际账号资源在 `prepare/connect` 时按登录上下文打开。
+ *
+ * @throws `cache.prefix` 缺失或不满足稳定命名合同时同步抛错，且不会访问任何存储或网络资源。
+ * @example
+ * ```ts
+ * const client = createImClient({
+ *   authProvider,
+ *   endpointProvider,
+ *   cache: { prefix: 'acme.im.production' },
+ * })
+ * await client.session.start()
+ * ```
+ */
+declare function createImClient(options: ImClientOptions): ImProductClient;
+
+/** 创建有界诊断缓冲时的容量合同。 */
+interface ImDiagnosticMemoryBufferOptions {
+    /** 最多保留的记录数；缺省为 200。 */
+    maxRecords?: number;
+    /** 按 JSON UTF-8 估算的总字节预算；缺省为 4 MiB。 */
+    maxEstimatedBytes?: number;
+}
+/** 查询诊断缓冲时可组合的精确过滤条件。 */
+interface ImDiagnosticMemoryBufferFilter {
+    accountId?: string;
+    generation?: number;
+    conversation?: ConversationRef;
+    messageId?: string;
+    category?: ImDiagnosticCategory;
+    traceId?: string;
+    operationId?: string;
+    /** 包含边界。 */
+    fromTimestamp?: number;
+    /** 包含边界。 */
+    toTimestamp?: number;
+}
+/** 诊断缓冲的只读快照；records 及其嵌套值均被冻结。 */
+interface ImDiagnosticMemoryBufferSnapshot {
+    readonly records: readonly ImDiagnosticRecord[];
+    readonly droppedCount: number;
+    readonly estimatedBytes: number;
+    readonly disposed: boolean;
+}
+/**
+ * 同时实现 `ImDiagnosticSink` 与只读查询面的有界内存诊断缓冲。
+ *
+ * @remarks buffer 只接收中央 writer 已过滤的 record，不持久化、不上传，也不得被业务逻辑读取为备用状态源。
+ */
+interface ImDiagnosticMemoryBuffer extends ImDiagnosticSink {
+    getSnapshot: (filter?: ImDiagnosticMemoryBufferFilter) => ImDiagnosticMemoryBufferSnapshot;
+    subscribe: (listener: (snapshot: ImDiagnosticMemoryBufferSnapshot) => void) => () => void;
+    clear: () => void;
+    dispose: () => void;
+}
+/**
+ * 创建按条数和估算字节双预算约束的 FIFO 诊断缓冲。
+ *
+ * @example
+ * ```ts
+ * const buffer = createImDiagnosticMemoryBuffer()
+ * const debug = { enabled: true, sink: buffer }
+ * const recentCrypto = buffer.getSnapshot({ category: 'crypto' })
+ * ```
+ */
+declare function createImDiagnosticMemoryBuffer(options?: ImDiagnosticMemoryBufferOptions): ImDiagnosticMemoryBuffer;
+
+/**
+ * 频道 rel 能否打开：跨宿主纯决策。打开器、Toast、分享快照仍归 Host。
+ * 置顶/悬浮游戏都要有 appId 和可拼地址；无 appId 的置顶游戏根本不会进入可见列表。
+ */
+
+interface ChannelMiniProgramOpenGame {
+    id: string;
+    name: string;
+    cover: string;
+    appId?: string;
+    developerId?: string;
+    domain?: string;
+    suffixAddress?: string;
+    h5Url?: string;
+    isDynamic?: boolean;
+    productId?: number;
+}
+type ChannelMiniProgramRelOpenDecision = {
+    kind: 'refuse';
+} | {
+    kind: 'open-link';
+    url: string;
+} | {
+    kind: 'open-game';
+    game: ChannelMiniProgramOpenGame;
+    currencyType: number | string;
+};
+declare function decideChannelMiniProgramRelOpen(rel: ImChannelMiniProgramRel, input: {
+    name: string;
+    currentCurrencyType: number | null;
+}): ChannelMiniProgramRelOpenDecision;
+
+/**
+ * 频道 `miniProgramRels` 的跨宿主可见性与展示纯规则。
+ * SDK mapper 原样保留 CSV 和空 appId；是否展示由这里按当前语言号与大厅币种决定。
+ */
+
+/** 与旧 H5 `languageGetNumber` / 频道 rel `lang_types` 一致：1 简中 2 繁中 3 英 4 越 5 泰。 */
+declare const MINI_PROGRAM_LANG_NUMBERS: {
+    readonly 'zh-CN': 1;
+    readonly 'zh-TW': 2;
+    readonly 'en-US': 3;
+    readonly 'vi-VN': 4;
+    readonly 'th-TH': 5;
+};
+type MiniProgramHostLocale = keyof typeof MINI_PROGRAM_LANG_NUMBERS;
+declare function csvIncludes(csv: string | undefined, value: string | number): boolean;
+/** 频道 rel 名称按当前 locale 取对应字段，再按 en → 简中 → 繁中 → 越 → 泰回退。 */
+declare function resolveChannelMiniProgramRelName(rel: ImChannelMiniProgramRel, locale: string): string;
+declare function resolveChannelMiniProgramRelIcon(rel: ImChannelMiniProgramRel): string;
+declare function resolveChannelMiniProgramRelUrl(rel: ImChannelMiniProgramRel): string;
+interface VisibleChannelMiniProgramRels {
+    pinnedGame: ImChannelMiniProgramRel | null;
+    floatingItems: readonly ImChannelMiniProgramRel[];
+}
+/** 置顶游戏与消息卡共用全屏；右下角最底部悬浮游戏走半屏。 */
+type ChannelMiniProgramRelOpenSurface = 'page' | 'half';
+/**
+ * 频道 rel 打开面：只有 `float-game` 半屏，其余与点击小程序消息一致走全屏。
+ * `float-link` 实际仍开外链，surface 不影响决策。
+ */
+declare function resolveChannelMiniProgramRelOpenSurface(rel: ImChannelMiniProgramRel): ChannelMiniProgramRelOpenSurface;
+/**
+ * 对齐 iOS `ChatSetTopMsgViewMiniProgramMsgContentView setChannelInfo`：
+ * 主标题取频道简介，胶囊取 rel 当前语言游戏名。
+ * `rel.introduction` 是产品/社交内容简介，不是频道简介，不能拿来当标题。
+ */
+declare function resolveChannelPinnedGameCopy(input: {
+    channelDescription?: string | null;
+    rel: ImChannelMiniProgramRel;
+    locale: string;
+}): {
+    title: string;
+    tag: string;
+    name: string;
+};
+/** 右下角浮窗：链接在上、游戏在最底部。 */
+declare function sortChannelMiniProgramFloatingItems(items: readonly ImChannelMiniProgramRel[]): ImChannelMiniProgramRel[];
+/**
+ * 按当前语言号与大厅币种过滤 `miniProgramRels`。
+ * `undefined` 表示 info 尚未回填，不展示；空数组表示 info 已确认没有配置。
+ * 置顶游戏还要有 appId 才展示，对齐 iOS `hasGamePromptWithChannelInfo`。
+ */
+declare function resolveVisibleChannelMiniProgramRels(rels: readonly ImChannelMiniProgramRel[] | undefined, input: {
+    locale: string;
+    currencyType: number | string | null | undefined;
+}): VisibleChannelMiniProgramRels;
+declare function channelMiniProgramRelKey(conversationId: string, rel: ImChannelMiniProgramRel): string;
+
+/** IM 领域支持的 5 个展示 locale（与宿主规范 locale 一致）。 */
+type ImLocale = 'en-US' | 'th-TH' | 'vi-VN' | 'zh-CN' | 'zh-TW';
+/** 默认展示语言；缺译 / 未知 locale 一律回退至此（对齐 NUXT_PUBLIC_DEFAULT_LOCALE 默认值）。 */
+declare const DEFAULT_LOCALE: ImLocale;
+/**
+ * 把宿主更宽的 locale 联合归一到 ImLocale：精确命中 5 个规范 locale 之一即原样返回，
+ * 非法 / 未知输入回退 `DEFAULT_LOCALE`。供宿主 `env.locale`（如 `useI18n().locale`）安全窄化。
+ * @example normalizeImLocale('zh-CN') // 'zh-CN'
+ * @example normalizeImLocale('fr-FR') // 'zh-CN'（DEFAULT_LOCALE）
+ */
+declare function normalizeImLocale(input: string): ImLocale;
+
+/**
+ * IM 语义文案 catalog 的键、参数和完整性合同。
+ * 键描述领域含义而非组件位置，使 Web/H5/SSR 可共享 formatter，宿主布局文案不进入此 schema。
+ */
+
+/** 系统消息文案（formatSystemMessage 用）。占位符 `{x}` 由 formatSystemMessage 按 body + resolveName 插值。 */
+interface ImSystemCatalog {
+    /** 成为联系人后的 direct 建立会话提示。参数：{target}。 */
+    directContactEstablished: string;
+    /** direct 非好友发送被拒后的提示；“申请添加”由 UI 作为 action 单独渲染。 */
+    directContactRequired: string;
+    /** direct 消息被对方黑名单策略拒收后的本地系统提示。 */
+    directMessageRefused: string;
+    /** 自己（operator/target === selfId 时的显示名）。 */
+    you: string;
+    /**
+     * 多个成员名之间的分隔符（如一次邀请多人时拼接名单）。
+     * 中文用顿号、拉丁与泰/越语用逗号加空格，对齐 iOS `SIMManager` 的同名拼接规则。
+     */
+    nameSeparator: string;
+    /** 成员名缺省占位（退群 / 被踢 / 改名 target 缺失时）。 */
+    member: string;
+    /** 新成员名缺省占位（加群 target 缺失时）。 */
+    newMember: string;
+    /** 新群主名缺省占位（群主变更 target 缺失时）。 */
+    newMaster: string;
+    /** 加入群聊。参数：{target}。 */
+    groupMemberJoined: string;
+    /** 当前账号已经加入普通群。 */
+    groupSelfJoined: string;
+    /** 当前账号邀请成员加入普通群。参数：{target}。 */
+    groupMemberInvitedBySelf: string;
+    /** 当前账号作为被邀请者已经加入普通群。 */
+    groupSelfInvited: string;
+    /**
+     * 他人同时邀请了当前账号和其他成员加入普通群。参数：{operator} {target}。
+     * 模板自带「你」，{target} 只填其余成员，避免名单里重复出现当前账号。
+     */
+    groupMemberInvitedYouAndOthers: string;
+    /** 其他成员邀请目标加入普通群。参数：{operator} {target}。 */
+    groupMemberInvitedByOperator: string;
+    /** 缺少邀请者时的第三人称加入文案。参数：{target}。 */
+    groupMemberInvited: string;
+    /** 退出群聊。参数：{target}。 */
+    groupMemberLeft: string;
+    /** 当前账号主动退出普通群。 */
+    groupSelfLeft: string;
+    /** 操作者移出成员。参数：{operator} {target}。 */
+    groupMemberRemovedByOperator: string;
+    /** 当前账号被移出普通群时的固定终态提示。 */
+    groupSelfRemoved: string;
+    /** 被移出群聊（无操作者）。参数：{target}。 */
+    groupMemberRemoved: string;
+    /** 修改群昵称。参数：{target}。 */
+    groupMemberRenamed: string;
+    /** 成为新群主。参数：{target}。 */
+    groupMasterChanged: string;
+    /** 当前账号成为普通群群主。 */
+    groupSelfMasterChanged: string;
+    /** 群名称变更。参数：{name}。 */
+    groupInfoRenamed: string;
+    /** 群资料变更（无新群名）。 */
+    groupInfoChanged: string;
+    /** 群解散。 */
+    groupDismissed: string;
+    /** 消息置顶。参数：{operator}。 */
+    groupMessagePinned: string;
+    /** 移除置顶。参数：{operator}。 */
+    groupMessageUnpinned: string;
+    /** 自己发起群通话。对齐 Android `you_started_a_group_call` / iOS `rea_yousendgroupmediasession`。 */
+    groupCallStartedBySelf: string;
+    /** 他人发起群通话。参数：{operator}。对齐 Android `somebody_started_a_group_call` / iOS `rea_othersendgroupmediasession`。 */
+    groupCallStarted: string;
+    /** 群通话已结束。对齐 Android `group_cal_ended` / iOS `rea_grouphaveend`。 */
+    groupCallEnded: string;
+    /** 群通话未接听。对齐 Android `group_call_missed` / iOS `rea_groupunconnect`。 */
+    groupCallMissed: string;
+    channelNameChanged: string;
+    channelAvatarChanged: string;
+    channelAnnouncementChanged: string;
+    channelMemberJoined: string;
+    channelSelfJoined: string;
+    channelMemberInvited: string;
+    channelMemberInvitedBySelf: string;
+    channelSelfInvited: string;
+    /** 他人同时邀请了当前账号和其他成员加入 CHANNEL；模板自带「你」，{target} 只填其余成员。参数：{operator} {target}。 */
+    channelMemberInvitedYouAndOthers: string;
+    channelMemberInvitedByOperator: string;
+    channelMemberLeft: string;
+    channelSelfLeft: string;
+    /** 当前账号被移出 CHANNEL 时的固定终态提示；独立于 GROUP 文案键维护。 */
+    channelSelfRemoved: string;
+    channelMemberRemoved: string;
+    channelOwnerTransferred: string;
+    channelSelfOwnerTransferred: string;
+    channelAdminAdded: string;
+    channelAdminRemoved: string;
+    channelDismissed: string;
+    channelAllMuted: string;
+    channelAllUnmuted: string;
+    channelCreated: string;
+    channelPrivateChatDisabled: string;
+    channelPrivateChatEnabled: string;
+    channelMemberRenamed: string;
+    channelMemberMuted: string;
+    channelMemberUnmuted: string;
+    /** CHANNEL 消息置顶。参数：{operator}。 */
+    channelMessagePinned: string;
+    /** CHANNEL 移除置顶。参数：{operator}。 */
+    channelMessageUnpinned: string;
+    channelUnknown: string;
+    /** 自己领取了自己发的红包。来源 iOS `redpacket_grabbed_self`。 */
+    redPacketClaimedSelf: string;
+    /** 他人领取了你的红包。参数：{name}。来源 iOS `redpacket_grabbed_yours`。 */
+    redPacketClaimedYours: string;
+    /** 你领取了他人的红包。参数：{name}。来源 iOS `redpacket_you_grabbed`。 */
+    redPacketYouClaimed: string;
+    /** 他人领取了你的红包并踩雷。参数：{name}。来源 iOS `redpacket_grabbed_yours_boom`。 */
+    redPacketClaimedYoursThunder: string;
+    /** 你领取了他人的红包并踩雷。参数：{recipient} {senderName}。来源 iOS `redpacket_you_grabbed_boom`。 */
+    redPacketYouClaimedThunder: string;
+    /** 未知事件兜底（仅当无 fallbackText 时用）。 */
+    unknown: string;
+}
+/** @提及展示文案（formatMentionAll 用；@所有人 的本地化词，展示按接收端语言、与识别词表分离）。 */
+interface ImMentionCatalog {
+    /** @所有人 的本地化词（不含 `@`，由 formatMentionAll 统一拼 `@`）。 */
+    all: string;
+}
+/** 媒体占位文案（formatMediaPlaceholder 用；对齐回复摘要 use-message-preview）。 */
+interface ImMediaCatalog {
+    image: string;
+    video: string;
+    voice: string;
+    /** 带时长语音。参数：{duration}（已格式化 m:ss / h:mm:ss）。 */
+    voiceWithDuration: string;
+    file: string;
+    /** EXPRESSION + imageType=1。 */
+    gif: string;
+    /** EXPRESSION 的静态贴图及未知 imageType。 */
+    sticker: string;
+    contact: string;
+    /** 小程序卡片回复摘要，对齐 iOS `min_program_name`。 */
+    miniProgram: string;
+    /** 转账卡片回复摘要，对齐 iOS `chat_tranfer`。 */
+    transfer: string;
+    /** 语音通话记录回复摘要。 */
+    callAudio: string;
+    /** 视频通话记录回复摘要。 */
+    callVideo: string;
+    /** 红包卡片回复摘要，对齐 iOS `red_envelope` / Android `txt_asset_detail_tab_red_envelope`。 */
+    redPacket: string;
+    /** 骰子消息的回复摘要。 */
+    gameDice: string;
+    /** 石头剪刀布消息的回复摘要。 */
+    gameRockPaperScissors: string;
+    /**
+     * 媒体合集：多张照片，参数 `{count}`（≥2；恰好 1 项时复用 `image`，避免每种语言再写一套单数模板）。
+     *
+     * 这一组与 `lastMessage.mediaAlbum*` 现在是**同一份词**（都不带方括号，决策 D26）。两边仍保留
+     * 各自的 key，是因为两个界面的其它类型并不一致：会话列表给没有图标的类型加方括号，回复摘要一律不加。
+     * 有配文的合集显示配文而不是这些文案，但那是调用方的取舍——与单视频消息的 `describe` 一样，
+     * `formatMediaPlaceholder` 只负责类型占位，不读正文文本。
+     */
+    mediaAlbumPhotos: string;
+    /** 媒体合集：多个视频，参数 `{count}`（≥2；恰好 1 项时复用 `video`）。 */
+    mediaAlbumVideos: string;
+    /** 媒体合集：图片与视频混合，参数 `{photoCount}` `{videoCount}`（各语言自行决定量词与连接符）。 */
+    mediaAlbumMixed: string;
+}
+/** 失败气泡文案（formatFailure 用；逐字对齐 core 现有 ImMessageFailure.message，阶段 4b 零回归）。 */
+interface ImFailureCatalog {
+    /** 媒体类型名（mediaKind → 文案，供 media.* 模板 {label}）。 */
+    mediaLabel: Record<MediaKind, string>;
+    /** media.empty，参数 {label}。 */
+    mediaEmpty: string;
+    /** media.noCrypto，参数 {label}。 */
+    mediaNoCrypto: string;
+    /** media.previewFailed，参数 {label}。 */
+    mediaPreviewFailed: string;
+    /** media.encryptFailed，参数 {label}。 */
+    mediaEncryptFailed: string;
+    /** media.uploadFailed，参数 {label}。 */
+    mediaUploadFailed: string;
+    /** media.cancelled，参数 {label}。 */
+    mediaCancelled: string;
+    /** media.invalidDuration，参数 {label}。 */
+    mediaInvalidDuration: string;
+    /** media.uploadInterrupted，参数 {label}。 */
+    mediaUploadInterrupted: string;
+    /**
+     * media.contentTooLarge：媒体合集的出站正文体积未通过发送前闸门。
+     *
+     * 与其它 media.* 不同，**不带 {label}**——一条合集里可能同时有照片和视频，没有单一媒体类型名。
+     */
+    mediaContentTooLarge: string;
+    /** direct 0x8201：双方已不是好友。 */
+    contactRequired: string;
+    /** direct 0x8212：消息因对方黑名单策略被拒收。 */
+    messageRefused: string;
+    /** forbiddenOrLeft（GROUP ACK ERR_CHAT_FORBIDDEN）。 */
+    forbiddenOrLeft: string;
+    /** contentRejected（ACK ERR_CHAT_UNHEALTHY）。 */
+    contentRejected: string;
+    /** groupDismissed（ACK ERR_GROUP_DISMISSED）。 */
+    groupDismissed: string;
+    /** groupUnavailable（ACK ERR_GROUP_NETWORKEXCEPTION）。 */
+    groupUnavailable: string;
+    /** CHANNEL RADIO ACK 0x8501–0x8504。 */
+    channelDismissed: string;
+    channelMuted: string;
+    channelNotMember: string;
+    channelAdminRequired: string;
+    /** conversationUnsupported（未接入会话类型），参数 {type}。 */
+    conversationUnsupported: string;
+    /** sessionLoggedOut（生命周期 logout：退账号时在途消息移出自动复发，可手动重试）。 */
+    sessionLoggedOut: string;
+    /** sendCanceled（仅本地取消从未进入 transport 的 Outbox queued 项，不表示远端撤回）。 */
+    sendCanceled: string;
+    /** timeout / network / unknown 通用兜底。 */
+    timeout: string;
+    network: string;
+    unknown: string;
+}
+/**
+ * 会话列表预览文案（formatLastMessageSummary 用；system 复用 formatSystemMessage 带名版）。
+ *
+ * 方括号只保留给**列表里不带类型图标**的那些：语音、文件、名片、小程序、转账、通话、红包、
+ * 小游戏、加密、不支持。它们没有图标，方括号是唯一能和「对方真的发了『语音』两个字」区分开的标记。
+ *
+ * 照片、视频、GIF、贴图和媒体合集在 PC/H5 会话列表里都带 16px 类型图标（设计稿 13328:305728），
+ * 图标已经表明类型，所以文案不带方括号、与回复摘要 `media.*` 用同一份词（决策 D26）。
+ */
+interface ImLastMessageCatalog {
+    /** 单张照片，与 `media.image` 同词；列表里前面带照片图标，不加方括号。 */
+    image: string;
+    /** GIF 会话摘要，例如 `GIF`；列表里前面带 GIF 图标。 */
+    gif: string;
+    /** 静态贴图会话摘要，例如 `贴图`；列表里前面带贴图图标。 */
+    sticker: string;
+    /** 单个视频，与 `media.video` 同词；列表里前面带视频图标。 */
+    video: string;
+    voice: string;
+    file: string;
+    contact: string;
+    /** 小程序卡片会话摘要，对齐 iOS `[%@]` + `min_program_name`。 */
+    miniProgram: string;
+    /** 转账会话摘要，对齐 iOS `[chat_tranfer]`。 */
+    transfer: string;
+    /** 语音通话记录会话摘要。 */
+    callAudio: string;
+    /** 视频通话记录会话摘要。 */
+    callVideo: string;
+    /** 红包会话摘要，对齐 iOS `[%@]` + `red_envelope` / Android `txt_asset_detail_tab_red_envelope`。 */
+    redPacket: string;
+    /** 小游戏消息的统一会话列表摘要；不在列表中暴露骰子/RPS 的具体类型。 */
+    game: string;
+    /**
+     * 媒体合集：多张照片，参数 `{count}`（≥2；恰好 1 项时复用 `image`，避免各语言再写一套单数模板）。
+     * 有配文的合集直接显示配文，不用这些 key。合集在列表里带类型图标，所以同样不加方括号。
+     */
+    mediaAlbumPhotos: string;
+    /** 媒体合集：多个视频，参数 `{count}`（≥2；恰好 1 项时复用 `video`）。 */
+    mediaAlbumVideos: string;
+    /** 媒体合集：图片与视频混合，参数 `{photoCount}` `{videoCount}`（各语言自行决定量词与连接符）。 */
+    mediaAlbumMixed: string;
+    encrypted: string;
+    /** 未注册或无法解析的正文。 */
+    unknown: string;
+    /** 自己撤回。 */
+    recalledBySelf: string;
+    /** 他人撤回，参数 {name}。 */
+    recalledByOther: string;
+    /** CHANNEL 管理员全员删除。 */
+    channelModerationDeleted: string;
+}
+/**
+ * 命令/生命周期「操作提示」文案 key（formatServiceText 用；供 kit services / runtime 产语义码、宿主按 locale 渲染）。
+ * 二期收敛：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.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';
+/** 命令/生命周期操作提示 catalog（key 齐全，模板含 {reason}/{label}/{size} 占位）。 */
+type ImServiceCatalog = Record<ImServiceTextKey, string>;
+/** 星期文案键按 JavaScript `Date#getDay()` 的 Sunday-first 顺序命名。 */
+type ImWeekdayKey = 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday';
+/** 会话时间与聊天日期条共享的本地化语义文案。 */
+interface ImTimeCatalog {
+    today: string;
+    yesterday: string;
+    weekdays: Readonly<Record<ImWeekdayKey, string>>;
+}
+/** IM 领域文案 catalog 契约（zh-CN 须齐全）。 */
+interface ImCatalog {
+    system: ImSystemCatalog;
+    mention: ImMentionCatalog;
+    media: ImMediaCatalog;
+    failure: ImFailureCatalog;
+    lastMessage: ImLastMessageCatalog;
+    time: ImTimeCatalog;
+    service: ImServiceCatalog;
+}
+/** 非默认 locale 的内置 catalog：允许增量提供，缺失键 fallback 回退 DEFAULT_LOCALE。 */
+type ImPartialCatalog = {
+    [K in keyof ImCatalog]?: Partial<ImCatalog[K]>;
+};
+/**
+ * 宿主可覆盖的运行时展示文案。
+ *
+ * `mention` 被明确排除：`mention.all` 不只是 UI 标签，Composer 还会把它写入消息正文，
+ * 其它客户端必须用同一组协议词识别。允许单个宿主热改会造成发送词与接收词漂移。
+ */
+type ImCatalogOverrides = {
+    [K in Exclude<keyof ImCatalog, 'mention'>]?: Partial<ImCatalog[K]>;
+};
+
+/**
+ * IM 语义文案 catalog 的选择、宿主覆盖与默认语言回退。
+ *
+ * 输入是标准化 `ImLocale`，输出是完整只读 catalog；缺少的键按「宿主覆盖 → SDK 内置译文 → zh-CN 基线」
+ * 逐层回退，不访问 Vue i18n、浏览器语言或宿主 Store，因此可在 SSR、Worker 和测试中复用。
+ *
+ * 三层组合（优先级从高到低）：
+ *   1) 宿主运行时覆盖（registerImCatalogOverrides 注入）——供内置语言热修普通展示文案，不必等 SDK 发版。
+ *   2) SDK 内置分语言译文（PARTIAL_CATALOGS）——开箱即用主体。
+ *   3) DEFAULT_LOCALE=zh-CN 基线——保证键恒全。
+ */
+
+/**
+ * 获取指定 locale 的时间语义文案；时间计算与格式化由 Chat Kit 公共工具负责。
+ *
+ * @example
+ * ```ts
+ * getImTimeCatalog('zh-CN').yesterday; // "昨天"
+ * ```
+ */
+declare function getImTimeCatalog(locale: ImLocale): Readonly<ImTimeCatalog>;
+/**
+ * 为 SDK 已内置的 locale 注入普通展示文案覆盖（优先级高于内置译文）。
+ *
+ * 注册时会校验非空值、文案键和模板占位符，并复制输入以隔离调用方后续修改。
+ * `mention.all` 不能覆盖，因为它会进入发送正文并参与跨端识别；新增 locale 也必须随 SDK
+ * catalog 与 @全体识别合同一起发布，不能复用现有 locale 槽位伪装。
+ * 同一 locale 多次调用会累积合并；注入后清对应 locale 缓存，下次 catalogFor 生效。
+ * @example registerImCatalogOverrides('en-US', { failure: { network: 'Network error, retry.' } })
+ */
+declare function registerImCatalogOverrides(locale: ImLocale, partial: ImCatalogOverrides): void;
+/**
+ * 清空当前进程的全部宿主覆盖并失效缓存。
+ *
+ * 该状态属于应用级文案配置，不属于账号会话；不要在单个用户登出时调用。
+ * 仅用于测试隔离，或应用在无并发渲染时整体重载文案管线。
+ */
+declare function resetImCatalogOverrides(): void;
+
+/**
+ * 创建绑定固定 locale 的框架无关 IM 语义 formatter。
+ *
+ * 该实例只把 Core 的消息、失败和媒体语义转换成文案，不管理响应式 locale，也不包含按钮、Dialog
+ * 等宿主 UI 文案。动态语言场景应在调用时传当前 locale，避免旧实例缓存宿主状态。
+ */
+
+/** 绑定某 locale 的 IM 文案实例（供固定 locale 场景，如 SSR 预渲染 / 测试）。响应式场景用独立 formatXxx（每次传当前 locale）。 */
+interface ImI18n {
+    readonly locale: ImLocale;
+    formatSystemMessage: (body: ImSystemMessageBody, ctx: {
+        resolveName: (uid: string) => string;
+        selfId: string;
+    }) => string;
+    formatLastMessageSummary: (summary: LastMessageSummary, ctx: {
+        resolveName: (uid: string) => string;
+        selfId: string;
+    }) => string;
+    formatMediaPlaceholder: (contentType: MessageContentType, opts?: {
+        durationMs?: number;
+        stickerImageType?: number;
+        gameType?: ImGameType;
+        callKind?: 'audio' | 'video';
+        mediaAlbum?: {
+            imageCount: number;
+            videoCount: number;
+        };
+    }) => string;
+    formatMentionAll: () => string;
+    formatFailure: (displayCode: ImFailureDisplayCode, opts?: {
+        mediaKind?: MediaKind;
+        params?: Record<string, string | number>;
+    }) => string;
+}
+/**
+ * 创建 IM 文案工厂：`createImI18n({ defaultLocale })(locale?)` 得到绑定该 locale 的实例（未传 locale 用 defaultLocale）。
+ * defaultLocale 对齐宿主默认显示语言（NUXT_PUBLIC_DEFAULT_LOCALE），缺省 DEFAULT_LOCALE=zh-CN；
+ * 缺译回退基准恒为 DEFAULT_LOCALE（保证有全量译文），见 catalogFor。
+ */
+declare function createImI18n(opts?: {
+    defaultLocale?: ImLocale;
+}): (locale?: ImLocale) => ImI18n;
+
+/**
+ * 把 Core/SDK 稳定失败分类格式化为用户可读文案。
+ * 不展示 raw cause、协议错误体或凭据，未知分类使用明确通用失败文案而不是空字符串。
+ */
+
+/** formatFailure 上下文：locale + 媒体类型（media.* 的 label）+ 模板参数（如 conversationUnsupported 的 type）。 */
+interface FormatFailureContext {
+    locale: ImLocale;
+    mediaKind?: MediaKind;
+    params?: Record<string, string | number>;
+}
+/**
+ * 失败展示码 → 气泡文案。media.* 用 mediaKind → label 插值；ACK / 通用码直出；conversationUnsupported 插 params.type。
+ * 逐字对齐 core 现有 ImMessageFailure.message（阶段 4b 零回归）。switch 穷尽 ImFailureDisplayCode（编译期兜底）。
  */
-interface ImProductClient {
-    /** 当前设备推送订阅的服务端绑定与同步状态。 */
-    readonly push: ImPushApi;
-    readonly session: ImSessionApi;
-    readonly capabilities: ImConversationCapabilitiesApi;
-    readonly conversations: ImConversationListApi;
-    /** 当前账号完整联系人、群组和社群目录的统一搜索。 */
-    readonly directory: ImDirectorySearchApi;
-    readonly contacts: ImContactsApi;
-    readonly groups: ImGroupsApi;
-    readonly channels: ImChannelsApi;
-    readonly applications: ImApplicationsApi;
-    readonly expressions: ImExpressionsApi;
-    readonly sessionFavorites: ImSessionFavoritesApi;
-    readonly outbox: ImOutboxApi;
-    readonly drafts: ImDraftsApi;
-    readonly search: ImSearchApi;
-    readonly media: ImMediaTasksApi;
-    /** 当前账号本机 IM 偏好；不隐含服务端或多端设置同步。 */
-    readonly settings: ImSettingsApi;
-    readonly localData: ImLocalDataApi;
-    readonly events: ImEventsApi;
-    /**
-     * 打开或发起一个精确类型的产品会话。
-     *
-     * @remarks 已有会话直接复用；会话缺失时，SDK 会先校验当前账号目录对象或权威资料/成员状态，
-     * 再把空摘要提交到唯一 DomainState。失败不会创建假会话，宿主也不需要先修改会话列表 Store。
-     */
-    openConversation: ImClient['openConversation'];
-    dispose: () => Promise<void>;
+declare function formatFailure(displayCode: ImFailureDisplayCode, ctx: FormatFailureContext): string;
+
+/**
+ * 格式化会话列表最新消息摘要。
+ * 输入只使用 Core 稳定语义，不解析 raw message body；系统、撤回、媒体等分支由 catalog 统一表达。
+ */
+
+/** formatLastMessageSummary 上下文（同 formatSystemMessage：locale + 名称解析 + selfId）。 */
+interface FormatLastMessageContext {
+    locale: ImLocale;
+    resolveName: (uid: string) => string;
+    selfId: string;
 }
 /**
- * internal/testing 完整门面：保留 `connection` 与 singular profile/member/cache 域。
- * 普通宿主只使用 `ImProductClient`；官方 Chat Kit 和受控诊断从 internal 子入口取得 `ImAdvancedClient`。
+ * 会话列表「最后一条」摘要 → 展示文案。text 直出正文；media 用会话列表占位（[图片]…[加密消息]，区别于回复摘要 formatMediaPlaceholder 的「照片…」）；
+ * system 复用 formatSystemMessage（统一带成员名版，消除会话列表/气泡两套模板，见阶段 4a 决策）；recalled 按 by 是否 self 渲染。
  */
-interface ImClient extends Omit<ImProductClient, 'capabilities' | 'channels' | 'contacts' | 'conversations' | 'groups'> {
-    /** internal/testing 与高级宿主使用的单聊音视频信令；稳定 default 产品门面不暴露此能力。 */
-    readonly calls: ImDirectCallsApi;
-    /** internal/testing 群通话门面。 */
-    readonly groupCalls: ImGroupCallsApi;
+declare function formatLastMessageSummary(summary: LastMessageSummary, ctx: FormatLastMessageContext): string;
+
+/** 把图片、视频、语音、文件等正文类型映射为 locale 对应的稳定媒体占位文案。 */
+
+/** formatMediaPlaceholder 上下文：locale + 媒体正文中影响占位文案的稳定子类型。 */
+interface FormatMediaPlaceholderContext {
+    locale: ImLocale;
+    durationMs?: number;
+    /** EXPRESSION 的协议 imageType；1=GIF，其余/缺省按静态贴图展示。 */
+    stickerImageType?: number;
+    /** 小游戏类型；缺失或非法时不把损坏正文伪装成任一种游戏。 */
+    gameType?: ImGameType;
+    /** 通话记录媒体类型；缺失时不把损坏正文伪装成语音或视频通话。 */
+    callKind?: 'audio' | 'video';
     /**
-     * 打开一个拥有独立连续窗口与生命周期的 direct、GROUP 或 CHANNEL 会话句柄。
+     * 媒体合集的项数构成；缺失或两个计数都是 0 时返回空串，不假装有内容。
      *
-     * @remarks 三类会话按精确类型进入各自 sibling；`supergroup` 继续拒绝。
-     * @example
-     * ```ts
-     * const handle = await client.openConversation({ conversationType: 'direct', conversationId: '42' })
-     * try { await handle.history.loadLatest() } finally { handle.close() }
-     * const group = await client.openConversation({ conversationType: 'group', conversationId: '9001' })
-     * await group.messages.sendText('hello [2002]', { mentions: [{ userId: '2002', displayName: 'Alice' }] })
-     * group.close()
-     * ```
+     * **不含配文**：与单视频消息的 `describe` 一样，本函数只负责类型占位，正文文本由调用方决定
+     * 要不要优先显示（引用摘要通常会把配文走自己的表情/@ 分段管线，不该从这里绕过去）。
      */
-    openConversation: {
-        (ref: ConversationRef<'direct'>, options?: ConversationOpenOptions): Promise<ConversationHandle<'direct'>>;
-        (ref: ConversationRef<'group'>, options?: ConversationOpenOptions): Promise<ConversationHandle<'group'>>;
-        (ref: ConversationRef<'channel'>, options?: ConversationOpenOptions): Promise<ConversationHandle<'channel'>>;
+    mediaAlbum?: {
+        imageCount: number;
+        videoCount: number;
     };
-    /** 当前账号草稿产品面；按复合身份持久化，handle.draft 委托同一状态源。 */
-    drafts: ImDraftsApi;
-    /** 连接域：连接生命周期 + 事件订阅 + 快照。 */
-    connection: ImConnectionApi;
-    /** 会话域：会话列表 + 离线拉取。 */
-    conversations: AdvancedConversationsApi;
-    /** advanced 联系人复数门面保留 core DTO；default 外壳另做稳定投影。 */
-    contacts: AdvancedContactsApi;
-    /** advanced GROUP 复数门面保留 core DTO；default 外壳另做稳定投影。 */
-    groups: AdvancedGroupsApi;
-    /** advanced CHANNEL 复数门面保留 core DTO；default 外壳另做稳定投影。 */
-    channels: AdvancedChannelsApi;
-    /** 好友域：好友资料读取 + 设置备注。 */
-    contact: ImContactApi;
-    /** 群域：群资料读取 + 修改群名/群头像/群内昵称。 */
-    group: ImGroupApi;
-    /** CHANNEL 域：资料、成员治理与独立置顶能力；仍未闭合的动作不进入此门面。 */
-    channel: ImChannelApi;
-    /** 可观察媒体任务与按精确消息引用下载。 */
-    media: ImMediaTasksApi;
-    /** 可靠发送账本的稳定查询、订阅、重试和本地 queued 取消控制面。 */
-    outbox: ImOutboxApi;
-    /** 当前 prefix/account 的分类查询、rebuildable 清理与精确账号 purge。 */
-    localData: ImLocalDataApi;
-    /** 已同步会话和本地消息的分场景搜索；底层 cursor 只存在于不透明 page token。 */
-    search: ImSearchApi;
-    /** 联系人、GROUP、CHANNEL pending 申请的 typed 聚合；动作按 ref.domain 回到对应 sibling。 */
-    applications: ImApplicationsApi;
-    /**
-     * 登出当前账号（§4.4/§8）：先把在途 Outbox 移出自动复发（默认 `pendingMessages:'fail'`），再断连 + 停计时器 + 清领域内存 + 关本地库句柄；
-     * `localData:'purge'` 仅在句柄成功关闭后额外删除 teardown 起点捕获的本账号库（默认 `preserve` 保留）；关闭或删除失败通过 storage error 暴露，
-     * 不回退猜测其它 adapter/前缀。随后可继续 prepare/connect 下一账号（同实例复用）。
-     * 不反向调用宿主鉴权登出——由宿主编排。dispose 后调用 reject。
-     */
-    logout: (options?: ImLogoutOptions) => Promise<void>;
-    /** 终态销毁（§4.5）：先 teardown 当前账号，再清空事件订阅；幂等；此后实例不可复用。用于应用卸载 / HMR / 微前端子应用销毁。 */
-    dispose: () => Promise<void>;
 }
 /**
- * 官方 UI Kit、调试工具和高级宿主持有的完整 client。
- *
- * @remarks 该类型包含 singular profile/member/cache 域；普通宿主只使用 `ImProductClient`。
+ * 媒体消息 → 单行占位文案（回复摘要 / 会话预览降级用）。对齐 use-message-preview：
+ * image→照片、sticker→GIF/贴图、game→骰子/石头剪刀布、video→视频、file→文件、contact→名片、
+ * miniProgram→小程序、voice→「语音」（durationMs>0 时「语音 m:ss」）。text / system 以及缺少合法 gameType 的损坏正文返回空串。
  */
-type ImAdvancedClient = ImClient;
+declare function formatMediaPlaceholder(contentType: MessageContentType, ctx: FormatMediaPlaceholderContext): string;
+
 /**
- * 创建账号无关的 IM client 外壳；实际账号资源在 `prepare/connect` 时按登录上下文打开。
- *
- * @throws `cache.prefix` 缺失或不满足稳定命名合同时同步抛错，且不会访问任何存储或网络资源。
- * @example
- * ```ts
- * const client = createImClient({
- *   authProvider,
- *   endpointProvider,
- *   cache: { prefix: 'acme.im.production' },
- * })
- * await client.session.start()
- * ```
+ * 生成 @所有人 的接收端展示文案。
+ * 展示按接收端当前语言（本函数按 locale 取词），与「识别发送端多语言正文」的匹配词表分离；
+ * `@` 前缀在此统一拼接，catalog 只存可翻译的词（如「所有人」/「All」），避免各宿主各存一份。
  */
-declare function createImClient(options: ImClientOptions): ImProductClient;
 
-/** 创建有界诊断缓冲时的容量合同。 */
-interface ImDiagnosticMemoryBufferOptions {
-    /** 最多保留的记录数；缺省为 200。 */
-    maxRecords?: number;
-    /** 按 JSON UTF-8 估算的总字节预算；缺省为 4 MiB。 */
-    maxEstimatedBytes?: number;
-}
-/** 查询诊断缓冲时可组合的精确过滤条件。 */
-interface ImDiagnosticMemoryBufferFilter {
-    accountId?: string;
-    generation?: number;
-    conversation?: ConversationRef;
-    messageId?: string;
-    category?: ImDiagnosticCategory;
-    traceId?: string;
-    operationId?: string;
-    /** 包含边界。 */
-    fromTimestamp?: number;
-    /** 包含边界。 */
-    toTimestamp?: number;
-}
-/** 诊断缓冲的只读快照；records 及其嵌套值均被冻结。 */
-interface ImDiagnosticMemoryBufferSnapshot {
-    readonly records: readonly ImDiagnosticRecord[];
-    readonly droppedCount: number;
-    readonly estimatedBytes: number;
-    readonly disposed: boolean;
+/**
+ * @所有人 展示文案 → `@` + 当前 locale 的本地化词。供宿主注入 resolveTextSegments 的 `atAllDisplay`，
+ * 使收到的 @所有人 段按接收端语言展示（不随发送端原文）。
+ * @example formatMentionAll('en-US') // '@All'
+ */
+declare function formatMentionAll(locale: ImLocale): string;
+
+/**
+ * 格式化 Chat Kit service 返回的稳定文本键与参数。
+ * Service 不依赖 locale 或宿主 i18n；只有 Web/H5 最终反馈边界调用本函数生成文案。
+ */
+
+/** formatServiceText 上下文：locale + 模板参数（如 {reason}=原始报错、{label}=媒体类型名、{size}=字节数）。 */
+interface FormatServiceTextContext {
+    locale: ImLocale;
+    params?: Record<string, string | number>;
 }
 /**
- * 同时实现 `ImDiagnosticSink` 与只读查询面的有界内存诊断缓冲。
- *
- * @remarks buffer 只接收中央 writer 已过滤的 record，不持久化、不上传，也不得被业务逻辑读取为备用状态源。
+ * 命令/生命周期「操作提示」码 → 文案（供 kit services / runtime 产码、宿主按 locale 渲染）。
+ * 平铺 key + 通用 `{...}` 插值（不做穷尽 switch，key 联合由 ImServiceTextKey 编译期保证齐全）。
+ * 动态原始报错经 params.reason 拼接，不入 catalog（诊断，不翻译）。
  */
-interface ImDiagnosticMemoryBuffer extends ImDiagnosticSink {
-    getSnapshot: (filter?: ImDiagnosticMemoryBufferFilter) => ImDiagnosticMemoryBufferSnapshot;
-    subscribe: (listener: (snapshot: ImDiagnosticMemoryBufferSnapshot) => void) => () => void;
-    clear: () => void;
-    dispose: () => void;
+declare function formatServiceText(key: ImServiceTextKey, ctx: FormatServiceTextContext): string;
+
+/**
+ * 把已归一化系统消息语义格式化为当前 locale 文案。
+ * 不读取协议 notify/raw payload；缺字段使用 catalog 的稳定降级文案，不猜测操作者或目标身份。
+ */
+
+/** formatSystemMessage 上下文：locale + 名称解析（宿主提供，已按备注>群昵称>昵称解析）+ selfId（判「你」）。 */
+interface FormatSystemMessageContext {
+    locale: ImLocale;
+    resolveName: (uid: string) => string;
+    selfId: string;
 }
 /**
- * 创建按条数和估算字节双预算约束的 FIFO 诊断缓冲。
- *
- * @example
- * ```ts
- * const buffer = createImDiagnosticMemoryBuffer()
- * const debug = { enabled: true, sink: buffer }
- * const recentCrypto = buffer.getSnapshot({ category: 'crypto' })
- * ```
+ * 系统消息（群通知）→ 展示文案：按 eventType 取 catalog 模板 + 插值成员名。对齐宿主 MessageThread 气泡口径
+ *（带成员名、operator/target===selfId → 「你」、target 缺失用缺省占位「新成员/成员/新群主」）。
+ * 已知 eventType 一律走 catalog；仅 unknown 用 fallbackText（后端原文）兜底、无则 catalog.system.unknown（§C.3 fallback 矩阵）。
  */
-declare function createImDiagnosticMemoryBuffer(options?: ImDiagnosticMemoryBufferOptions): ImDiagnosticMemoryBuffer;
+declare function formatSystemMessage(body: ImSystemMessageBody, ctx: FormatSystemMessageContext): string;
 
 /** 会话列表摘要的框架无关分段；宿主可自行决定表情使用图片、文本或其它组件呈现。 */
 type ConversationListPreviewSegment = {
@@ -7505,6 +7594,20 @@ type MessageNotificationDecision = {
 /** PC/H5 共用的实时消息提醒规则；离线历史回放不逐条弹通知。 */
 declare function resolveMessageNotificationDecision(input: MessageNotificationInput): MessageNotificationDecision;
 
+/**
+ * 拼装频道 rel / 消息 22 打开小程序用的地址。
+ * 有 host 时按大厅规则拼 suffix；只有 suffix 时只接受完整 URL 或带点的主机名，
+ * 不能把 `/path` 当成域名。
+ */
+interface MiniProgramOpenUrlInput {
+    domain?: string;
+    suffixAddress?: string;
+    h5Url?: string;
+}
+declare function resolveMiniProgramOpenUrl(input: MiniProgramOpenUrlInput): string;
+/** 悬浮外链：suffix 已是完整地址或主机名时直接用；只有路径时必须拼到 domain 上。 */
+declare function resolveMiniProgramFloatLinkUrl(input: MiniProgramOpenUrlInput): string;
+
 /**
  * 官方 Chat Kit 和受控诊断工具使用的 SDK internal 入口。
  * 它暴露完整 client、adapter 装配和领域原子，但仍不属于普通产品 API；生产宿主不得据此解析协议或持有密钥。
@@ -9736,5 +9839,5 @@ declare function resampleWaveform(data: readonly number[], targetCount: number):
  */
 declare function placeholderWaveform(seed: string, count: number): number[];
 
-export { DEFAULT_EMOJI_ASSET_BASE, DEFAULT_LOADING_MINIMUM_VISIBLE_MS, DEFAULT_LOADING_SHOW_DELAY_MS, DEFAULT_LOCALE, EDIT_WINDOW_MS, EMOJI_CATALOG, EMOJI_GAME_DICE_STABLE_KEY, EMOJI_GAME_RPS_STABLE_KEY, EMOJI_TOKEN_RE, IM_CHAT_FONT_SCALES, IM_DIAGNOSTIC_CATEGORIES, IM_EMOJI_CATALOG, ImPinnedMessageOperationError, MAX_BATCH_FILES, MAX_RECENT_EMOJI_COUNT, MEDIA_ALBUM_CAPTION_MAX_LENGTH, MEDIA_ALBUM_MAX_ITEMS, MediaTransferError, REACTION_SUPPORTED_CONTENT_TYPES, SPIKE_STEP, UNICODE_EMOJI_CATALOG, blockReasonForChannelSession, blockReasonForChannelState, blockReasonForGroupState, blockReasonForSession, buildSessionFavoritePlainBody, calculateMediaBox, canEditMessage, canPinChannelMessage, canPinGroupMessage, canPinMessage, canPromoteMediaPresentationSource, canReactToMessage, canRecallMessage, canTransmit, canTransmitByType, canTransmitContent, cancelMediaUpload, captureRuntimeClientOperation, captureRuntimeOperation, classifyGifFile, classifyStickerImageType, createChatRuntime, createDelayedLoadingIndicator, createEmojiMatcher, createFaceToFaceGroupQrPayload, createImClient, createImConsoleDiagnosticSink, createImDiagnosticMemoryBuffer, createImI18n, createImTextSearchMatcher, createLinkMatcher, createNewMessageBadgeController, createSdkDiagnosticWriter, createThreadItems, createVoicePlayer, createVoiceRecordingSession, decideConversationAction, decideMemberTargetAction, decideMessageAction, detectVoiceCapabilities, emojiAssetUrl, emojiUrlByCode, extractSearchText, fetchConversationFileBatch, fetchConversationImageBatch, fetchConversationMessageBatch, fetchConversationVideoBatch, fetchConversationVoiceBatch, fetchNextConversationSearchBatch, formatChatDateSeparator, formatConversationDisplayTime, formatFailure, formatFileSize, formatLastMessageSummary, formatMediaDuration, formatMediaPlaceholder, formatMentionAll, formatServiceText, formatSystemMessage, forward_service as forwardService, getFileExtension, getImTextSearchInitial, getImTimeCatalog, getLocalDayKey, hasEmojiCandidate, hasLinkCandidate, highlightSegments, isGifFile, isMessageLocateScrollProtected, isMessageTailChangeFromOlderWindowTrim, isMessageViewportMeasurable, isMessageVisibleForNewMessageBadge, isPinnedMessageProtected, isVoiceStorageConfigured, loadOlderUntilBoundary, mediaBatchBudgetBytes, media_service as mediaService, mediaTransferErrorCodeOf, message_service as messageService, migrateImCachePrefix, normalizeImLocale, normalizeLinkHref, normalizeMediaUploadCredentials, parseSessionFavoriteAlbumItems, parseUnicodeEmojiCode, pinnedMessage_service as pinnedMessageService, placeholderWaveform, prependRecentEmoji, profile_service as profileService, read_service as readService, refreshPrependMessageAnchorPosition, registerImCatalogOverrides, replaceInterruptedMediaFile, requiresConversationEncryption, requiresForwardTypeConfirmation, resampleWaveform, resetImCatalogOverrides, resolveBestMediaPresentationSource, resolveCenteredMessageScrollTop, resolveChannelAccess, resolveChannelMemberAvatarUrl, resolveChannelMemberDisplayName, resolveConversationListPresentation, resolveDisplayTimestamp, resolveEmojiToken, resolveFriendDisplayName, resolveImEmojiToken, resolveImProfileAccessDestination, resolveImThreadActiveDate, resolveMediaAlbumSendContentType, resolveMediaPresentation, resolveMemberDisplayName, resolveMessageBodyKind, resolveMessageNotificationDecision, resolveMessageTimelineTimestamp, resolvePrependMessageAnchor, resolvePrependMessageAnchorAdjustment, resolvePrependMessageAnchorPosition, resolvePublicNickname, resolveQuotedMessagePresentation, resolveSenderAvatarUrl, resolveSessionFavoriteAlbumCaption, resolveSessionFavoriteAlbumItemPreviewUrl, resolveSessionFavoriteKindFromMessage, resolveStandaloneEmojiMessage, resolveSurvivingMessageAnchorAdjustment, resolveTextSegments, resolveUnicodeEmoji, resolveVisibleMessageAnchorPositions, retryMessage, runMediaSendBatch, sendAsFilesBatch, sendBlockReasonForDecision, sendMediaAlbum, sendMediaFile, sendMediaFilesBatch, sendText, sendVoice, shouldCompleteInitialViewport, shouldFillInitialHistoryViewport, shouldFollowIncomingMessage, shouldLoadNewerHistoryPage, shouldPrefetchOlderHistory, shouldRestoreMessageViewportFocus, shouldShowChatDateSeparator, shouldTrackRemoteMessageForBadge, sortSessions, spikeCountForDuration, sumSessionsUnread, supportsConversationMention, unicodeEmojiTextFromCode, voiceErrorCodeOf };
-export type { ApplySessionResult, BrowseMessagesInput, CanPinMessageInput, CapabilityAvailability, CapabilityDecision, CapabilityReason, CenteredMessageScrollInput, ChannelAccessSnapshot, ChannelBaseSessionState, ChannelConversationCapabilities, ChannelConversationMessageApi, ChannelJoinApplication, ChannelJoinApplicationNotification, ChannelJoinApplicationPage, ChannelMember, ChannelMemberPage, ChannelMentionMember, ChannelMentionMemberPage, ChannelMiniProgramRel, ChannelMiniProgramRelConfigType, ChannelMuteReason, ChannelPermissionSet, ChannelProfile, ChannelRole, ChannelSessionState, ChatMediaMessageRef, ChatProfileAdapter, ChatRuntime, ChatRuntimeCredentials, ChatRuntimeFactories, ChatRuntimeHostDeps, ChatRuntimeOpResult, ContactCardInput, ContactMessageOptions, ConversationBackgroundPreset, ConversationBackgroundSelection, ConversationCapabilityAction, ConversationCapabilitySnapshot, ConversationDraft, ConversationDraftApi, ConversationEntryUnreadSnapshot, ConversationHandle, ConversationHandleSnapshot, ConversationInitialPosition, ConversationLastMessageSummary, ConversationListItem, ConversationListMention, ConversationListPresentation, ConversationListPresentationLabels, ConversationListPresentationOptions, ConversationListPreviewMediaKind, ConversationListPreviewSegment, ConversationMessageApi, ConversationOpenOptions, ConversationRef, ConversationSearchCategory, ConversationSearchPage, ConversationSearchResult, ConversationSystemSummary, ConversationType, CreateThreadItemsInput, DelayedLoadingIndicator, DelayedLoadingIndicatorOptions, DirectConversationCapabilities, DirectConversationMessageApi, DraftInput, EditTextOptions, EmojiEntry, EmojiRecentItem, EmojiSegment, ExpressionMessageOptions, FileMessageOptions, FormatFailureContext, FormatLastMessageContext, FormatMediaPlaceholderContext, FormatServiceTextContext, FormatSystemMessageContext, FormatTimeDisplayContext, ForwardCommandHooks, ForwardFailReason, ForwardItemStatus, ForwardMessageFailure, ForwardMessagesInput, ForwardMessagesResult, ForwardTarget, ForwardedMessageRef, GameMessageOptions, GifFileClassification, GifMessageOptions, GroupConversationCapabilities, GroupConversationMessageApi, GroupMemberItem, GroupProfile, HighlightSegment, ImAppearanceSettingsApi, ImApplicationItem, ImApplicationRef, ImApplicationsApi, ImAuthIssue, ImAuthProvider, ImCacheOptions, ImCachePrefixMigrationContext, ImCachePrefixMigrator, ImCallKind, ImCallOutcome, ImCallRecordBody, ImCatalog, ImCatalogOverrides, ImChannelConversationAccessSnapshot, ImChannelMemberPresentation, ImChannelMentionApi, ImChannelMentionPresentation, ImChannelMiniProgramRel, ImChannelPermissions, ImChannelPinnedMessage, ImChannelProfile, ImChannelProfilePresentation, ImChannelRole, ImChannelState, ImChannelsApi, ImChatFontScale, ImClientOptions, ImConnectionState, ImContactBody, ImContactKind, ImContactProfile, ImContactRelationship, ImContactRemarkPhone, ImContactSearchResult, ImContactsApi, ImConversationBackgroundApi, ImConversationCapabilitiesApi, ImConversationListApi, ImConversationListSnapshot, ImConversationListState, ImConversationSearchApi, ImCoreApiOptions, ImCreateChannelInput, ImCreateChannelResult, ImCreateFaceToFaceGroupResult, ImCreateGroupInput, ImCreateGroupResult, ImCreatedChannel, ImCreatedGroup, ImDebugOptions, ImDiagnosticCategory, ImDiagnosticError, ImDiagnosticLayer, ImDiagnosticLevel, ImDiagnosticMemoryBuffer, ImDiagnosticMemoryBufferFilter, ImDiagnosticMemoryBufferOptions, ImDiagnosticMemoryBufferSnapshot, ImDiagnosticMessage, ImDiagnosticRecord, ImDiagnosticSink, ImDiagnosticWriter, ImDirectCallAnswerResult, ImDirectCallFailReason, ImDirectCallHangupInput, ImDirectCallHangupReason, ImDirectCallInviteInput, ImDirectCallNotifyAudioInput, ImDirectCallTargetInput, ImDirectCallsApi, ImDirectReadReceiptSettings, ImDirectoryApi, ImDirectoryFieldMatch, ImDirectoryItem, ImDirectoryKind, ImDirectoryPage, ImDirectorySearchApi, ImDirectorySearchItem, ImDirectorySearchResult, ImDraftsApi, ImEmojiCatalogEntry, ImEndpointProvider, ImEventsApi, ImExpressionAsset, ImExpressionAssetInput, ImExpressionEmojiRecentInput, ImExpressionFavoriteKind, ImExpressionOptions, ImExpressionRecentInput, ImExpressionRecentItem, ImExpressionRecentItemKind, ImExpressionsApi, ImFaceToFaceGroup, ImFailureCatalog, ImFileBody, ImForwardOperationResult, ImFriendshipRequestResult, ImGameBody, ImGameType, ImGifAssetInput, ImGiphyAsset, ImGiphyPage, ImGiphyPageOptions, ImGroupCallAnswerInput, ImGroupCallBusyInput, ImGroupCallCreateInput, ImGroupCallJoinInput, ImGroupCallMeetingSnapshot, ImGroupCallMember, ImGroupCallMemberStatus, ImGroupCallStatusInput, ImGroupCallTargetInput, ImGroupCallsApi, ImGroupConversationState, ImGroupMemberPresentation, ImGroupMentionApi, ImGroupPinnedMessage, ImGroupProfile, ImGroupsApi, ImI18n, ImImageBody, ImLastMessageCatalog, ImLifecycleSnapshot, ImLocalDataApi, ImLocalDataInfo, ImLocale, ImLogoutOptions, ImMediaAlbumBody, ImMediaAlbumItem, ImMediaBatchSendResult, ImMediaCatalog, ImMediaConfig, ImMediaTask, ImMediaTasksApi, ImMembershipJoinResult, ImMentionCatalog, ImMessageActionResult, ImMessageBodyKind, ImMessageMention, ImMessageReactionAggregate, ImMessageReactions, ImMessageRef, ImMessageSearchApi, ImMessageView, ImMessageViewBody, ImMessagesByIdResult, ImMiniProgramBody, ImMiniProgramShowType, ImOutboxApi, ImOutboxItem, ImPageToken, ImPartialCatalog, ImPinnedMessageActionResult, ImPinnedMessageErrorKind, ImPinnedMessageOperation, ImPinnedMessageSnapshot, ImProductApplicationUpdate, ImProductAuthInvalidReason, ImProductClient, ImProductEvent, ImProductEventError, ImProductEventMap, ImProductMessage, ImProfileAccessDestination, ImPushApi, ImPushSnapshot, ImQuotedMessagePresentation, ImReactionChangeAction, ImReactionChangeResult, ImReadReceiptSettingsApi, ImRedPacketBody, ImRedPacketType, ImRequestError, ImRequestErrorHandler, ImSdkErrorCategory, ImSdkErrorShape, ImSearchApi, ImServiceCatalog, ImServiceTextKey, ImSessionApi, ImSessionFavoriteAlbumItem, ImSessionFavoriteItem, ImSessionFavoriteKind, ImSessionFavoritesApi, ImSessionLifecycleState, ImSettingsApi, ImStickerAssetInput, ImStickerBody, ImStickerPack, ImSupportedConversationRef, ImSystemCatalog, ImTextResolver, ImTextSearchMatch, ImTextSearchMatchOptions, ImTextSearchMatcher, ImTextSearchRange, ImThreadActiveDateSnapshot, ImThreadDateMarkerMetric, ImThreadDecoration, ImThreadEncryptionItem, ImThreadIntent, ImThreadItem, ImThreadPresentationAdapter, ImThreadReadActions, ImThreadReadTargetResolver, ImThreadViewportMetrics, ImTimeCatalog, ImTransferBody, ImTransferSessionType, ImTransferStatus, ImVideoBody, ImVoiceBody, ImWebPushSubscription, ImWeekdayKey, ImageMessageOptions, ImagePreviewMetadata, IncomingMessageFollowInput, InitialHistoryViewportFillInput, InitialViewportCompletionInput, LinkSegment, LocalConversationHistoryClearResult, LocalMessageDeletionResult, MediaAlbumItemInput, MediaAlbumMessageOptions, MediaBatchBudgetOptions, MediaBatchLimitInfo, MediaLimitItem, MediaObjectUrlLease, MediaPresentationFit, MediaPresentationPolicy, MediaPresentationRule, MediaPresentationSourceCandidate, MediaPresentationSourceQuality, MediaSendBatchResult, MediaTransferErrorCode, MediaUploadCredentials, MediaUploadCredentialsProvider, MediaUploadCredentialsRequest, MemberTargetCapabilityAction, MemberTargetCapabilityInput, MentionCandidate, MentionCandidatePage, MentionInput, MessageCapabilityAction, MessageCapabilityInput, MessageContentType, MessageLocateScrollProtectionInput, MessageNotificationDecision, MessageNotificationInput, MessageWindowInfo, MessageWindowPage, MessagesByIdFailure, MigrateImCachePrefixInput, MiniProgramMessageOptions, NewMessageBadgeController, NewMessageBadgeCountListener, NewMessageBadgeVisibilityInput, NewerHistoryPageTriggerInput, OlderHistoryPrefetchInput, PrependAnchorCandidate, PrependAnchorViewport, PrependMessageAnchorPosition, ProductConversationListType, ProductHandleConversationType, ProductMessageSearchPage, ProductMessageSearchResult, RemoteMessageBadgeTrackingInput, ResolveMediaPresentationInput, ResolveTextOptions, ResolvedConversationBackground, ResolvedMediaPresentation, RichExtraSegment, RuntimeClientOperation, RuntimeOperation, SearchBatchResult, SearchFilesInput, SearchMessagesInput, SearchTextMessagesInput, SegmentMatch, SegmentMatcher, SendCapabilityMode, SendCommandHooks, SendMessageResult, SendVoicePayload, SenderProfileEntry, ServiceNoteHooks, StandaloneEmojiMessage, StickerAssetKind, TextMessageOptions, TextSegment, TransferMessageOptions, UnicodeEmojiEntry, UnknownMessageBody, UserProfile, VideoMessageOptions, VideoPreviewMetadata, VoiceCapabilities, VoiceErrorCode, VoiceMessageMetadata, VoicePlayer, VoicePlayerOptions, VoicePlayerState, VoiceRecordingResult, VoiceRecordingSession, VoiceRecordingSessionOptions, VoiceRecordingState, VoiceToggleOptions };
+export { DEFAULT_EMOJI_ASSET_BASE, DEFAULT_LOADING_MINIMUM_VISIBLE_MS, DEFAULT_LOADING_SHOW_DELAY_MS, DEFAULT_LOCALE, EDIT_WINDOW_MS, EMOJI_CATALOG, EMOJI_GAME_DICE_STABLE_KEY, EMOJI_GAME_RPS_STABLE_KEY, EMOJI_TOKEN_RE, IM_CHAT_FONT_SCALES, IM_DIAGNOSTIC_CATEGORIES, IM_EMOJI_CATALOG, ImPinnedMessageOperationError, MAX_BATCH_FILES, MAX_RECENT_EMOJI_COUNT, MEDIA_ALBUM_CAPTION_MAX_LENGTH, MEDIA_ALBUM_MAX_ITEMS, MINI_PROGRAM_LANG_NUMBERS, MediaTransferError, REACTION_SUPPORTED_CONTENT_TYPES, SPIKE_STEP, UNICODE_EMOJI_CATALOG, blockReasonForChannelSession, blockReasonForChannelState, blockReasonForGroupState, blockReasonForSession, buildSessionFavoritePlainBody, calculateMediaBox, canEditMessage, canPinChannelMessage, canPinGroupMessage, canPinMessage, canPromoteMediaPresentationSource, canReactToMessage, canRecallMessage, canTransmit, canTransmitByType, canTransmitContent, cancelMediaUpload, captureRuntimeClientOperation, captureRuntimeOperation, channelMiniProgramRelKey, classifyGifFile, classifyStickerImageType, createChatRuntime, createDelayedLoadingIndicator, createEmojiMatcher, createFaceToFaceGroupQrPayload, createImClient, createImConsoleDiagnosticSink, createImDiagnosticMemoryBuffer, createImI18n, createImTextSearchMatcher, createLinkMatcher, createNewMessageBadgeController, createSdkDiagnosticWriter, createThreadItems, createVoicePlayer, createVoiceRecordingSession, csvIncludes, decideChannelMiniProgramRelOpen, decideConversationAction, decideMemberTargetAction, decideMessageAction, detectVoiceCapabilities, emojiAssetUrl, emojiUrlByCode, extractSearchText, fetchConversationFileBatch, fetchConversationImageBatch, fetchConversationMessageBatch, fetchConversationVideoBatch, fetchConversationVoiceBatch, fetchNextConversationSearchBatch, formatChatDateSeparator, formatConversationDisplayTime, formatFailure, formatFileSize, formatLastMessageSummary, formatMediaDuration, formatMediaPlaceholder, formatMentionAll, formatServiceText, formatSystemMessage, forward_service as forwardService, getFileExtension, getImTextSearchInitial, getImTimeCatalog, getLocalDayKey, hasEmojiCandidate, hasLinkCandidate, highlightSegments, isGifFile, isMessageLocateScrollProtected, isMessageTailChangeFromOlderWindowTrim, isMessageViewportMeasurable, isMessageVisibleForNewMessageBadge, isPinnedMessageProtected, isVoiceStorageConfigured, loadOlderUntilBoundary, mediaBatchBudgetBytes, media_service as mediaService, mediaTransferErrorCodeOf, message_service as messageService, migrateImCachePrefix, normalizeImLocale, normalizeLinkHref, normalizeMediaUploadCredentials, parseSessionFavoriteAlbumItems, parseUnicodeEmojiCode, pinnedMessage_service as pinnedMessageService, placeholderWaveform, prependRecentEmoji, profile_service as profileService, read_service as readService, refreshPrependMessageAnchorPosition, registerImCatalogOverrides, replaceInterruptedMediaFile, requiresConversationEncryption, requiresForwardTypeConfirmation, resampleWaveform, resetImCatalogOverrides, resolveBestMediaPresentationSource, resolveCenteredMessageScrollTop, resolveChannelAccess, resolveChannelMemberAvatarUrl, resolveChannelMemberDisplayName, resolveChannelMiniProgramRelIcon, resolveChannelMiniProgramRelName, resolveChannelMiniProgramRelOpenSurface, resolveChannelMiniProgramRelUrl, resolveChannelPinnedGameCopy, resolveConversationListPresentation, resolveDisplayTimestamp, resolveEmojiToken, resolveFriendDisplayName, resolveImEmojiToken, resolveImProfileAccessDestination, resolveImThreadActiveDate, resolveMediaAlbumSendContentType, resolveMediaPresentation, resolveMemberDisplayName, resolveMessageBodyKind, resolveMessageNotificationDecision, resolveMessageTimelineTimestamp, resolveMiniProgramFloatLinkUrl, resolveMiniProgramOpenUrl, resolvePrependMessageAnchor, resolvePrependMessageAnchorAdjustment, resolvePrependMessageAnchorPosition, resolvePublicNickname, resolveQuotedMessagePresentation, resolveSenderAvatarUrl, resolveSessionFavoriteAlbumCaption, resolveSessionFavoriteAlbumItemPreviewUrl, resolveSessionFavoriteKindFromMessage, resolveStandaloneEmojiMessage, resolveSurvivingMessageAnchorAdjustment, resolveTextSegments, resolveUnicodeEmoji, resolveVisibleChannelMiniProgramRels, resolveVisibleMessageAnchorPositions, retryMessage, runMediaSendBatch, sendAsFilesBatch, sendBlockReasonForDecision, sendMediaAlbum, sendMediaFile, sendMediaFilesBatch, sendText, sendVoice, shouldCompleteInitialViewport, shouldFillInitialHistoryViewport, shouldFollowIncomingMessage, shouldLoadNewerHistoryPage, shouldPrefetchOlderHistory, shouldRestoreMessageViewportFocus, shouldShowChatDateSeparator, shouldTrackRemoteMessageForBadge, sortChannelMiniProgramFloatingItems, sortSessions, spikeCountForDuration, sumSessionsUnread, supportsConversationMention, unicodeEmojiTextFromCode, voiceErrorCodeOf };
+export type { ApplySessionResult, BrowseMessagesInput, CanPinMessageInput, CapabilityAvailability, CapabilityDecision, CapabilityReason, CenteredMessageScrollInput, ChannelAccessSnapshot, ChannelBaseSessionState, ChannelConversationCapabilities, ChannelConversationMessageApi, ChannelJoinApplication, ChannelJoinApplicationNotification, ChannelJoinApplicationPage, ChannelMember, ChannelMemberPage, ChannelMentionMember, ChannelMentionMemberPage, ChannelMiniProgramOpenGame, ChannelMiniProgramRel, ChannelMiniProgramRelConfigType, ChannelMiniProgramRelOpenDecision, ChannelMiniProgramRelOpenSurface, ChannelMuteReason, ChannelPermissionSet, ChannelProfile, ChannelRole, ChannelSessionState, ChatMediaMessageRef, ChatProfileAdapter, ChatRuntime, ChatRuntimeCredentials, ChatRuntimeFactories, ChatRuntimeHostDeps, ChatRuntimeOpResult, ContactCardInput, ContactMessageOptions, ConversationBackgroundPreset, ConversationBackgroundSelection, ConversationCapabilityAction, ConversationCapabilitySnapshot, ConversationDraft, ConversationDraftApi, ConversationEntryUnreadSnapshot, ConversationHandle, ConversationHandleSnapshot, ConversationInitialPosition, ConversationLastMessageSummary, ConversationListItem, ConversationListMention, ConversationListPresentation, ConversationListPresentationLabels, ConversationListPresentationOptions, ConversationListPreviewMediaKind, ConversationListPreviewSegment, ConversationMessageApi, ConversationOpenOptions, ConversationRef, ConversationSearchCategory, ConversationSearchPage, ConversationSearchResult, ConversationSystemSummary, ConversationType, CreateThreadItemsInput, DelayedLoadingIndicator, DelayedLoadingIndicatorOptions, DirectConversationCapabilities, DirectConversationMessageApi, DraftInput, EditTextOptions, EmojiEntry, EmojiRecentItem, EmojiSegment, ExpressionMessageOptions, FileMessageOptions, FormatFailureContext, FormatLastMessageContext, FormatMediaPlaceholderContext, FormatServiceTextContext, FormatSystemMessageContext, FormatTimeDisplayContext, ForwardCommandHooks, ForwardFailReason, ForwardItemStatus, ForwardMessageFailure, ForwardMessagesInput, ForwardMessagesResult, ForwardTarget, ForwardedMessageRef, GameMessageOptions, GifFileClassification, GifMessageOptions, GroupConversationCapabilities, GroupConversationMessageApi, GroupMemberItem, GroupProfile, HighlightSegment, ImAppearanceSettingsApi, ImApplicationItem, ImApplicationRef, ImApplicationsApi, ImAuthIssue, ImAuthProvider, ImCacheOptions, ImCachePrefixMigrationContext, ImCachePrefixMigrator, ImCallKind, ImCallOutcome, ImCallRecordBody, ImCatalog, ImCatalogOverrides, ImChannelConversationAccessSnapshot, ImChannelMemberPresentation, ImChannelMentionApi, ImChannelMentionPresentation, ImChannelMiniProgramRel, ImChannelPermissions, ImChannelPinnedMessage, ImChannelProfile, ImChannelProfilePresentation, ImChannelRole, ImChannelState, ImChannelsApi, ImChatFontScale, ImClientOptions, ImConnectionState, ImContactBody, ImContactKind, ImContactProfile, ImContactRelationship, ImContactRemarkPhone, ImContactSearchResult, ImContactsApi, ImConversationBackgroundApi, ImConversationCapabilitiesApi, ImConversationListApi, ImConversationListSnapshot, ImConversationListState, ImConversationSearchApi, ImCoreApiOptions, ImCreateChannelInput, ImCreateChannelResult, ImCreateFaceToFaceGroupResult, ImCreateGroupInput, ImCreateGroupResult, ImCreatedChannel, ImCreatedGroup, ImDebugOptions, ImDiagnosticCategory, ImDiagnosticError, ImDiagnosticLayer, ImDiagnosticLevel, ImDiagnosticMemoryBuffer, ImDiagnosticMemoryBufferFilter, ImDiagnosticMemoryBufferOptions, ImDiagnosticMemoryBufferSnapshot, ImDiagnosticMessage, ImDiagnosticRecord, ImDiagnosticSink, ImDiagnosticWriter, ImDirectCallAnswerResult, ImDirectCallFailReason, ImDirectCallHangupInput, ImDirectCallHangupReason, ImDirectCallInviteInput, ImDirectCallNotifyAudioInput, ImDirectCallTargetInput, ImDirectCallsApi, ImDirectReadReceiptSettings, ImDirectoryApi, ImDirectoryFieldMatch, ImDirectoryItem, ImDirectoryKind, ImDirectoryPage, ImDirectorySearchApi, ImDirectorySearchItem, ImDirectorySearchResult, ImDraftsApi, ImEmojiCatalogEntry, ImEndpointProvider, ImEventsApi, ImExpressionAsset, ImExpressionAssetInput, ImExpressionEmojiRecentInput, ImExpressionFavoriteKind, ImExpressionOptions, ImExpressionRecentInput, ImExpressionRecentItem, ImExpressionRecentItemKind, ImExpressionsApi, ImFaceToFaceGroup, ImFailureCatalog, ImFileBody, ImForwardOperationResult, ImFriendshipRequestResult, ImGameBody, ImGameType, ImGifAssetInput, ImGiphyAsset, ImGiphyPage, ImGiphyPageOptions, ImGroupCallAnswerInput, ImGroupCallBusyInput, ImGroupCallCreateInput, ImGroupCallJoinInput, ImGroupCallMeetingSnapshot, ImGroupCallMember, ImGroupCallMemberStatus, ImGroupCallStatusInput, ImGroupCallTargetInput, ImGroupCallsApi, ImGroupConversationState, ImGroupMemberPresentation, ImGroupMentionApi, ImGroupPinnedMessage, ImGroupProfile, ImGroupsApi, ImI18n, ImImageBody, ImLastMessageCatalog, ImLifecycleSnapshot, ImLocalDataApi, ImLocalDataInfo, ImLocale, ImLogoutOptions, ImMediaAlbumBody, ImMediaAlbumItem, ImMediaBatchSendResult, ImMediaCatalog, ImMediaConfig, ImMediaTask, ImMediaTasksApi, ImMembershipJoinResult, ImMentionCatalog, ImMessageActionResult, ImMessageBodyKind, ImMessageMention, ImMessageReactionAggregate, ImMessageReactions, ImMessageRef, ImMessageSearchApi, ImMessageView, ImMessageViewBody, ImMessagesByIdResult, ImMiniProgramBody, ImMiniProgramShowType, ImOutboxApi, ImOutboxItem, ImPageToken, ImPartialCatalog, ImPinnedMessageActionResult, ImPinnedMessageErrorKind, ImPinnedMessageOperation, ImPinnedMessageSnapshot, ImProductApplicationUpdate, ImProductAuthInvalidReason, ImProductClient, ImProductEvent, ImProductEventError, ImProductEventMap, ImProductMessage, ImProfileAccessDestination, ImPushApi, ImPushSnapshot, ImQuotedMessagePresentation, ImReactionChangeAction, ImReactionChangeResult, ImReadReceiptSettingsApi, ImRedPacketBody, ImRedPacketType, ImRequestError, ImRequestErrorHandler, ImSdkErrorCategory, ImSdkErrorShape, ImSearchApi, ImServiceCatalog, ImServiceTextKey, ImSessionApi, ImSessionFavoriteAlbumItem, ImSessionFavoriteItem, ImSessionFavoriteKind, ImSessionFavoritesApi, ImSessionLifecycleState, ImSettingsApi, ImStickerAssetInput, ImStickerBody, ImStickerPack, ImSupportedConversationRef, ImSystemCatalog, ImTextResolver, ImTextSearchMatch, ImTextSearchMatchOptions, ImTextSearchMatcher, ImTextSearchRange, ImThreadActiveDateSnapshot, ImThreadDateMarkerMetric, ImThreadDecoration, ImThreadEncryptionItem, ImThreadIntent, ImThreadItem, ImThreadPresentationAdapter, ImThreadReadActions, ImThreadReadTargetResolver, ImThreadViewportMetrics, ImTimeCatalog, ImTransferBody, ImTransferSessionType, ImTransferStatus, ImVideoBody, ImVoiceBody, ImWebPushSubscription, ImWeekdayKey, ImageMessageOptions, ImagePreviewMetadata, IncomingMessageFollowInput, InitialHistoryViewportFillInput, InitialViewportCompletionInput, LinkSegment, LocalConversationHistoryClearResult, LocalMessageDeletionResult, MediaAlbumItemInput, MediaAlbumMessageOptions, MediaBatchBudgetOptions, MediaBatchLimitInfo, MediaLimitItem, MediaObjectUrlLease, MediaPresentationFit, MediaPresentationPolicy, MediaPresentationRule, MediaPresentationSourceCandidate, MediaPresentationSourceQuality, MediaSendBatchResult, MediaTransferErrorCode, MediaUploadCredentials, MediaUploadCredentialsProvider, MediaUploadCredentialsRequest, MemberTargetCapabilityAction, MemberTargetCapabilityInput, MentionCandidate, MentionCandidatePage, MentionInput, MessageCapabilityAction, MessageCapabilityInput, MessageContentType, MessageLocateScrollProtectionInput, MessageNotificationDecision, MessageNotificationInput, MessageWindowInfo, MessageWindowPage, MessagesByIdFailure, MigrateImCachePrefixInput, MiniProgramHostLocale, MiniProgramMessageOptions, MiniProgramOpenUrlInput, NewMessageBadgeController, NewMessageBadgeCountListener, NewMessageBadgeVisibilityInput, NewerHistoryPageTriggerInput, OlderHistoryPrefetchInput, PrependAnchorCandidate, PrependAnchorViewport, PrependMessageAnchorPosition, ProductConversationListType, ProductHandleConversationType, ProductMessageSearchPage, ProductMessageSearchResult, RemoteMessageBadgeTrackingInput, ResolveMediaPresentationInput, ResolveTextOptions, ResolvedConversationBackground, ResolvedMediaPresentation, RichExtraSegment, RuntimeClientOperation, RuntimeOperation, SearchBatchResult, SearchFilesInput, SearchMessagesInput, SearchTextMessagesInput, SegmentMatch, SegmentMatcher, SendCapabilityMode, SendCommandHooks, SendMessageResult, SendVoicePayload, SenderProfileEntry, ServiceNoteHooks, StandaloneEmojiMessage, StickerAssetKind, TextMessageOptions, TextSegment, TransferMessageOptions, UnicodeEmojiEntry, UnknownMessageBody, UserProfile, VideoMessageOptions, VideoPreviewMetadata, VisibleChannelMiniProgramRels, VoiceCapabilities, VoiceErrorCode, VoiceMessageMetadata, VoicePlayer, VoicePlayerOptions, VoicePlayerState, VoiceRecordingResult, VoiceRecordingSession, VoiceRecordingSessionOptions, VoiceRecordingState, VoiceToggleOptions };