k2-im 0.1.35 → 0.1.37

package/dist/browser.js

@@ -1 +1 @@
-export{Ta as canCopyImageToClipboard,Ua as copyImageToClipboard,B as createLazyBrowserApiProtocolClient}from'./chunk-EBZORU2A.js';import'./chunk-6OC4FEH7.js';import'./chunk-WOT6VMZA.js';
+export{Ta as canCopyImageToClipboard,Ua as copyImageToClipboard,B as createLazyBrowserApiProtocolClient}from'./chunk-HUSCO5JM.js';import'./chunk-75GNCLQQ.js';import'./chunk-WOT6VMZA.js';

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

@@ -202,6 +202,8 @@ interface ImVideoBody {
     width: number;
     /** 视频像素高（BMessage.height）。 */
     height: number;
+    /** 发送方显式选择了 HD 原视频（BMessage.hd）；不按分辨率猜测。 */
+    hd?: boolean;
     /** 时长（秒，可含小数）；移动端旧消息的毫秒值由 SDK 转换，宿主不得猜单位。 */
     duration?: number;
     /** SDK 已确认时长为秒的标记；兼容旧缓存时防止重复转换。缺省仍按公开 API 的秒约定传入。 */
@@ -755,6 +757,8 @@ interface ImMessage {
     serverTime?: number;
     /** P0 默认 'unread'。 */
     receipt: MessageReceipt;
+    /** 离线单聊服务端标记当前账号已在其它端读过；仅用于本地未读投影，不改变对端回执 receipt。 */
+    readBySelf?: boolean;
     encryption: ImMessageEncryption;
     /** 群消息 @ 提及（仅群 @ 消息有；解析自 MESGrpChat 明文字段 + extend）。展示走 resolveMentionSegments。 */
     mention?: ImMessageMention;
@@ -772,7 +776,7 @@ interface ImMessage {
     };
     /**
      * CHANNEL 管理员/社群主全员删除终态。它与发送者本人撤回、`deleteLocal` 完全不同：服务端通过
-     * `RADIO_ADMIN_CANCEL_*` 同步给全员，正文不可逆清空，产品统一展示“管理员删除了一条消息”。
+     * `RADIO_ADMIN_CANCEL_*` 同步给全员，正文不可逆清空；线程与会话摘要仅向群主、管理员展示删除提示，普通成员及未知角色隐藏。
      */
     deletedForEveryone?: {
         by: string;
@@ -954,6 +958,15 @@ interface ImSession {
      * 派生展示字段（随最新消息变化，会话列表据此显示发送中 loading / 失败图标）；运行期真相，不持久化（persistSession 落盘时剔除）。
      */
     lastMessageSendState?: 'sending' | 'failed';
+    /**
+     * 最新一条己方已发送消息的回执态。
+     *
+     * 只在自己发出且 `status='sent'` 时投影；发送中/失败、对端消息、撤回、全员删除和系统提示都不给。
+     * `delivered` 与尚未回执一样投影为 `unread`；当前协议没有送达通知，不能把 `sent` 当作对端已收到。
+     * 该字段随最新消息变化，并随会话落盘，避免冷启动后
+     * 因「盘中缺字段 / 内存有字段」反复广播；对端已读变化必须刷新会话行。
+     */
+    lastMessageReceipt?: 'unread' | 'read';
     /** P0 我方已读游标（见 §4.3）。 */
     readCursor?: string;
     /** 群受限状态（仅 group；来自 0x2204 群通知 side-effect）。缺省视为 'active'（可正常发送）。 */
@@ -1055,8 +1068,8 @@ interface UserProfile {
     /** 用户自设昵称（后端 `nick_name`）。 */
     nickname: string;
     /**
-     * 好友备注名（后端 `/user/info/friend` 的 `remark_name`，仅好友关系有）。
-     * 与 `nickname` 并存：展示名优先级 = 备注名 > 昵称（安卓 SessionUtils.getShowUserName 实证）。
+     * 好友展示备注（后端 `/user/info/friend` 的 `remark_name`，无备注时回退 `contact_name`，仅好友关系有）。
+     * 与 `nickname` 并存：展示名优先级 = 备注名/通讯录名 > 昵称（安卓 SessionUtils.getShowUserName 实证）。
      */
     remark?: string;
     avatar?: string;
@@ -2107,6 +2120,11 @@ type StoredConversationBackground = {
  * 失败经 `error` 事件（scope:'storage'）暴露、不静默吞、不阻塞内存主流程。
  */
 interface ImStoragePort {
+    /**
+     * 显式支持 CHANNEL 持久同步位置。声明 true 的 adapter 必须在删除会话正文/清历史事务中
+     * 同时删除 channelSyncCheckpointKey 对应 meta；旧 adapter 缺省不启用跨运行续传。
+     */
+    readonly supportsChannelSyncCheckpoint?: true;
     /** 可选的最近页持久缓存；缺少该能力时 SDK 必须明确跳过持久预取。 */
     recentHistoryCache?: ImRecentHistoryCachePort;
     /** 打开/创建账号库并跑迁移（幂等）。open 前的读写应视为未就绪并抛错（不静默兜底）。 */
@@ -2172,12 +2190,13 @@ interface ImStoragePort {
     deleteSession: (conversation: ImStorageConversation) => Promise<void>;
     /** 删除单会话已读态（删除会话用）。 */
     deleteReadState: (conversation: ImStorageConversation) => Promise<void>;
-    /** 删除某会话全部本地消息（删除会话用）。 */
+    /** 删除某会话全部本地消息及对应 CHANNEL 同步位置，二者须在同一事务内清理。 */
     deleteConversationMessages: (conversation: ImStorageConversation) => Promise<void>;
     /**
      * 原子清空精确会话的本机历史，并同步写入清空后的会话摘要与本机读态。
      *
      * @remarks 这是可选 capability，供产品 `history.clearLocal()` 使用；自定义 adapter 未实现时必须显式拒绝，不能退化为多次写入制造半清理状态。
+     * 同一事务还须删除 channelSyncCheckpointKey(conversation) 对应同步位置，避免正文已清而继续跳过旧页。
      * 不删除会话行、草稿、Outbox、置顶消息或任何远端数据。
      */
     clearConversationHistory?: (conversation: ConversationRef, nextSession?: ImSession, nextReadState?: ReadState) => Promise<void>;
@@ -3089,7 +3108,7 @@ interface ImMessageViewBody extends Omit<ImMessageBody, 'image' | 'video' | 'voi
  * `sortKey`、原始协议 `raw`、包含 history cursor 的 `extensions` 以及媒体 key。定位和下载必须继续
  * 通过绑定精确 `ConversationRef` 的 SDK handle/capability 完成，UI 不得从 DTO 恢复内部字段。
  */
-type ImMessageView = Readonly<Omit<ImMessage, 'sortKey' | 'raw' | 'extensions' | 'body' | 'reactions'> & {
+type ImMessageView = Readonly<Omit<ImMessage, 'sortKey' | 'raw' | 'extensions' | 'body' | 'reactions' | 'readBySelf'> & {
     body: ImMessageViewBody;
     reactions?: ImMessageReactions;
 }>;
@@ -4348,6 +4367,13 @@ interface ConversationListItem {
         by: string;
     }>;
     lastMessageSendState?: 'sending' | 'failed';
+    /**
+     * 最新一条己方已发送消息的对端已读态。
+     *
+     * 只在自己发出且已发送成功时出现；发送中/失败、对端消息、撤回和系统提示都不给。
+     * 单聊会话列表用它在摘要前画灰色单勾/绿色双勾；群组与社群即使有该字段也不展示。
+     */
+    lastMessageReceipt?: 'unread' | 'read';
     timestamp: number;
     unreadCount: number;
     /** 是否为用户手工添加的本地未读提醒；此时 `unreadCount` 至少投影为 1。 */
@@ -4536,6 +4562,21 @@ type ConversationEntryUnreadSnapshot = Readonly<{
 }> | Readonly<{
     state: 'unavailable';
 }>;
+/** 进入时冻结的导航提示；数量独立于会话已读，不暴露内部历史排序边界。 */
+type ConversationEntryUnreadNavigation = Readonly<{
+    state: 'none';
+}> | Readonly<{
+    state: 'pending' | 'unavailable';
+    count: number;
+}> | Readonly<{
+    state: 'located';
+    count: number;
+    firstMessageId: string;
+}> | Readonly<{
+    state: 'failed';
+    count: number;
+    error: ImSdkErrorShape;
+}>;
 
 /**
  * Emoji、GIF 与贴图稳定产品门面。
@@ -4699,6 +4740,8 @@ interface ConversationOpenOptions {
      * 后续 read 事件或新消息不会移动分隔线。
      */
     initialPosition?: ConversationInitialPosition;
+    /** 冻结进入时未读导航，独立于初始位置；清会话未读后仍可定位原边界。 */
+    captureEntryUnread?: boolean;
     /**
      * 初始历史加载方式，默认 `blocking`。
      *
@@ -4726,6 +4769,8 @@ interface ConversationHandleSnapshot<TType extends ProductHandleConversationType
     messages: readonly ImMessageView[];
     /** 本次打开时冻结的未读入口；只用于产品 UI 分隔线，不作为 SDK 已读真相。 */
     entryUnread: ConversationEntryUnreadSnapshot;
+    /** 显式请求的进入导航快照；旧消费者不请求时省略。 */
+    entryUnreadNavigation?: ConversationEntryUnreadNavigation;
     /** 当前账号本机草稿；不承诺跨端同步。 */
     draft: ConversationDraft | null;
     loading: boolean;
@@ -5026,6 +5071,8 @@ interface ConversationHandle<TType extends ProductHandleConversationType = Produ
     resolveMessage: (messageId: string) => Promise<ImMessageView | null>;
     history: {
         loadLatest: () => Promise<void>;
+        /** 有限加载进入时冻结边界；成功才替换窗口，不可定位返回 false，网络失败抛错并保留数量。 */
+        loadEntryUnread: () => Promise<boolean>;
         loadOlder: () => Promise<void>;
         /** 历史定位窗口向更新方向连续翻页；接回最新端后 `hasNewer` 变为 false。 */
         loadNewer: () => Promise<void>;
@@ -5056,6 +5103,10 @@ interface ConversationHandle<TType extends ProductHandleConversationType = Produ
     draft: ConversationDraftApi;
     /** 标记窗口最新消息或显式可见消息为已读；SDK 按精确 sibling 解析真实 read cursor。 */
     markRead: (messageId?: string) => Promise<void>;
+    /** 结算最新可信边界的会话未读；不会将整个范围登记为对端可见回执。 */
+    markConversationRead: () => Promise<void>;
+    /** 只登记实际可见的消息 ID；历史消息也可补报，媒体消费继续使用独立动作。 */
+    markVisibleMessages: (messageIds: readonly string[]) => Promise<void>;
     setMuted: (muted: boolean) => Promise<void>;
     close: () => void;
 }
@@ -9207,6 +9258,8 @@ interface ImThreadStoreState {
     display: ConversationHandleSnapshot['display'] | null;
     messages: readonly ImMessageView[];
     entryUnread: ConversationEntryUnreadSnapshot;
+    /** 本次进入前的数量与定位状态；列表清零后仍保留。 */
+    entryUnreadNavigation: ConversationHandleSnapshot['entryUnreadNavigation'];
     draft: ConversationDraft | null;
     loading: boolean;
     ready: boolean;
@@ -9222,6 +9275,14 @@ interface ImThreadStoreActions {
     open: (ref: ConversationRef<ProductHandleConversationType>) => Promise<ProductConversationHandle | undefined>;
     invalidatePendingOpen: () => void;
     loadLatest: () => Promise<boolean>;
+    /** 读取本次进入时冻结的首未读窗口。 */
+    loadEntryUnread: () => Promise<boolean>;
+    /** 页面确认可阅读后结算整会话；不会自动扩大可见消息回执。 */
+    markConversationRead: () => Promise<void>;
+    /** 只上报当前线程实际显示的消息集合。 */
+    markVisibleMessages: (messageIds: readonly string[]) => Promise<void>;
+    /** 明确业务离开；账号销毁和页面卸载仍使用无副作用的 close/reset。 */
+    leave: () => void;
     loadOlder: () => Promise<boolean>;
     loadNewer: () => Promise<boolean>;
     loadAround: (messageId: string) => Promise<boolean>;