k2-im 0.1.48 → 0.1.50

package/dist/index.d.ts

@@ -119,8 +119,11 @@ type LastMessageSummary = {
     kind: 'transfer';
 } | {
     kind: 'gift';
-} | {
+}
+/** 直播间分享。`title` 与卡片主标题一致：先主播昵称，没有再用房间标题。 */
+ | {
     kind: 'liveRoom';
+    title?: string;
 } | {
     kind: 'call';
     callKind: ImCallKind;
@@ -619,20 +622,21 @@ interface ImMediaAlbumBody {
     /** 媒体项，顺序即用户选择顺序（决定宫格 index 与首项朝向）。 */
     items: readonly ImMediaAlbumItem[];
 }
-/** 直播间分享的直播类型。wire `liveType`：1 视频、2 语音、3 双手机、4 单手机录屏、5 语聊房。 */
+/** 直播间分享的直播类型。wire `liveType`：1 视频、2 语音、3 双手机、4 单手机录屏、5 语聊房。空字符串对应 wire 0，表示调用方没有类型，不猜成某一种直播。 */
 type ImLiveRoomType = 'video' | 'voice' | 'dual-phone' | 'screen-record' | 'voice-chat';
 /** 直播间分享的房间状态。wire `liveRoomStatus`：1 预告、2 直播中、3 已结束。 */
 type ImLiveRoomStatus = 'preview' | 'live' | 'ended';
 /**
- * 直播间分享卡片正文（contentType==='liveRoom'，协议 BMessage.contentType=30，fields 98-112）。
+ * 直播间分享卡片正文（contentType==='liveRoom'，协议 BMessage.contentType=30，fields 98-113）。
  *
  * @remarks 调用方先拿到直播间快照再写入本结构。Core 不请求直播接口，也不把缺省枚举猜成某一种直播。
  * `uid` 是声网 SDK 初始化用的 UID，不是 IM 用户 id。
  */
 interface ImLiveRoomBody {
-    /** 直播间 ID（BMessage.liveRoomId）。 */
+    /** 直播间 ID（BMessage.liveRoomId）。没有房间号时为空字符串。 */
     liveRoomId: string;
-    liveType: ImLiveRoomType;
+    /** 没有直播类型时为空字符串。 */
+    liveType: ImLiveRoomType | '';
     liveRoomStatus: ImLiveRoomStatus;
     /** 当前账号是否已关注主播。协议 bool 无法区分未设置，false 也是有效状态。 */
     isFocus: boolean;
@@ -652,6 +656,8 @@ interface ImLiveRoomBody {
     livePreviewId?: string;
     /** 直播间人数字符串，保持协议原文，不在 Core 换算。 */
     liveRoomViewers?: string;
+    /** 点赞数十进制字符串，保持协议原文，不在 Core 换算。 */
+    liveRoomLikes?: string;
 }
 interface ImMessageBody {
     /** P0 文本内容（明文，解密后的结果）。 */
@@ -1987,10 +1993,10 @@ interface ImProfilePort {
  * 会话收藏可展示的内容类型；与 iOS `isSupportCollectionMsgType` 对齐。
  *
  * @remarks 这些值与收藏接口的 `content_type` 数值一一对应，而那个数值就是消息自己的 contentType
- * （1=文本 2=图片 3=视频 4=语音 5=位置 11=文件 28=媒体合集 29=文件合集），不是另一套收藏专用枚举。
+ * （1=文本 2=图片 3=视频 4=语音 5=位置 11=文件 28=媒体合集 29=文件合集 30=直播间分享），不是另一套收藏专用枚举。
  * Android `MessageCollectExecute` 直接写 `message.getContentType()`，iOS 写 `msg.msgType`，两端一致。
  */
-type ImSessionFavoriteKind = 'text' | 'image' | 'video' | 'voice' | 'location' | 'file' | 'mediaAlbum' | 'filesAlbum';
+type ImSessionFavoriteKind = 'text' | 'image' | 'video' | 'voice' | 'location' | 'file' | 'mediaAlbum' | 'filesAlbum' | 'liveRoom';
 /** 服务端一条会话收藏快照；列表以 HTTP 为准，不回写原消息。 */
 interface ImSessionFavoriteItem$1 {
     readonly collectId: string;
@@ -2978,8 +2984,10 @@ declare function canTransmit(message: ForwardCandidateMessage): boolean;
  */
 
 /**
- * 允许被表情回应的父消息正文类型，与 iOS `SZChatReactionService.supportsReactionForMessage:` 的协议白名单一致：
- * 文本、图片、视频、语音、文件、贴纸、名片、小程序、骰子/猜拳，以及转账、通话记录卡片和红包卡片本身。
+ * 允许被表情回应的父消息正文类型。
+ * 文本、图片、视频、语音、文件、贴纸、名片、小程序、骰子/猜拳，以及转账、通话记录卡片和红包卡片本身，
+ * 与 iOS `SZChatReactionService.supportsReactionForMessage:` 一致。
+ * 媒体合集和直播间分享是后续显式放行：回应挂在整条消息上。
  * 系统灰条（含红包领取通知、群提示、频道通知）与 unknown（未知/未来类型）不在白名单内。
  *
  * 这里刻意维持显式白名单而不是「排除 system 和 unknown」：新增 contentType 时默认拒绝，
@@ -5839,14 +5847,16 @@ interface ConversationHandle<TType extends ProductHandleConversationType = Produ
         /**
          * 按稳定消息 id 打开目标附近的连续历史窗口。
          *
-         * @remarks GROUP 完整置顶预览可按消息时间定位；CHANNEL 置顶未缓存时先按 ID 取回正式历史记录，
-         * 以服务端游标准备前后相邻页后一次替换窗口；准备失败保留原窗口。只含控制行的页每侧最多继续四页，
-         * 预算用完仍保留分页能力。短期搜索结果只作为只读锚点；partial 置顶和过期搜索结果明确拒绝定位。
-         * @throws 没有可用锚点、远端确认缺失或目标不属于当前复合会话时，抛出稳定 `IM_SDK_MESSAGE_NOT_FOUND`
-         * （`category: 'state'`、`retryable: false`、`details.messageId`）。这是常见产品结果而非链路异常，
-         * 调用方应据此与真正的存储/协议失败区分反馈，不要解析错误文案。
+         * @remarks 冷启动置顶和搜索结果只提供目标 id；目标不在当前窗口或本地原文时，须经精确会话
+         * `by_id` 确认真实原文及排序位置。预览或搜索位置不能充当历史游标。
+         * GROUP/CHANNEL 使用远端相邻页准备两侧上下文后一次替换窗口；失败保留原窗口。
+         * `signal` 取消本次定位，阻止提交准备中的窗口；不会撤销共享按 ID 查询已取得的合法缓存。
+         * @throws 仅 `by_id` 明确确认缺失时抛 `IM_SDK_MESSAGE_NOT_FOUND`；没有可信原文时抛
+         * `IM_SDK_MESSAGE_ANCHOR_UNAVAILABLE`。存储、权限与协议异常保留原错误身份。
          */
-        loadAround: (messageId: string) => Promise<void>;
+        loadAround: (messageId: string, options?: {
+            signal?: AbortSignal;
+        }) => Promise<void>;
         /**
          * 清空当前账号下此精确会话的本机历史。
          *
@@ -6718,11 +6728,11 @@ interface ImSessionFavoritesApi {
     delete: (collectIds: readonly string[]) => Promise<void>;
 }
 /**
- * 对齐 iOS Cell：文本 / 图 / 视频 / 语音 / 文件 / 媒体合集 / 文件合集可收藏；表情、名片、通话等不可。
+ * 对齐 iOS Cell：文本 / 图 / 视频 / 语音 / 文件 / 媒体合集 / 文件合集 / 直播间分享可收藏；表情、名片、通话等不可。
  *
  * 两端的收藏类型判定都是**黑名单**（iOS `isSupportCollectionMsgType` 排除名片/通话/表情/游戏/未知；
- * Android `isCanCollectByType` 排除通话/表情/名片/未知/解密失败），媒体合集不在黑名单里，
- * 收藏接口的 `content_type` 直接用消息自己的 28。
+ * Android `isCanCollectByType` 排除通话/表情/名片/未知/解密失败）。媒体合集与直播间分享不在黑名单里，
+ * 收藏接口的 `content_type` 直接用消息自己的 28 / 30。
  */
 declare function resolveSessionFavoriteKindFromMessage(message: ImMessageView): ImSessionFavoriteKind | null;
 /**

package/dist/index.js

@@ -1 +1 @@
-import'./chunk-IDECJJXC.js';import'./chunk-SXY56EVC.js';export{q as DEFAULT_LOADING_MINIMUM_VISIBLE_MS,p as DEFAULT_LOADING_SHOW_DELAY_MS,x as MINI_PROGRAM_GAME_PREVIEW_FALLBACK_HEIGHT,w as MINI_PROGRAM_GAME_PREVIEW_FALLBACK_WIDTH,e as MINI_PROGRAM_LANG_NUMBERS,S as SPIKE_STEP,N as calculateMediaBox,E as canCopyMessageImage,t as canPromoteMediaPresentationSource,B as captureRuntimeClientOperation,A as captureRuntimeOperation,n as channelMiniProgramRelKey,z as createConversationPrefetchController,r as createDelayedLoadingIndicator,L as createLinkMatcher,F as createMessageImageCopySource,f as csvIncludes,d as decideChannelMiniProgramRelOpen,P as formatFileSize,O as formatMediaDuration,Q as getFileExtension,D as getMessageCopyImageUrl,C as getMessageCopyText,K as hasLinkCandidate,u as highlightSegments,a as isMiniProgramShowTypeOpenable,G as mediaService,J as normalizeLinkHref,V as placeholderWaveform,H as readService,U as resampleWaveform,s as resolveBestMediaPresentationSource,h as resolveChannelMiniProgramRelIcon,g as resolveChannelMiniProgramRelName,j as resolveChannelMiniProgramRelOpenSurface,i as resolveChannelMiniProgramRelUrl,k as resolveChannelPinnedGameCopy,o as resolveConversationListPresentation,M as resolveMediaPresentation,R as resolveMediaTransferPresentation,v as resolveMessageSearchPreview,c as resolveMiniProgramFloatLinkUrl,y as resolveMiniProgramGamePreviewLayout,b as resolveMiniProgramOpenUrl,I as resolveQuotedMessagePresentation,m as resolveVisibleChannelMiniProgramRels,l as sortChannelMiniProgramFloatingItems,T as spikeCountForDuration}from'./chunk-ZAX3Q5WO.js';export{j as DEFAULT_EMOJI_ASSET_BASE,i as EMOJI_CATALOG,c as EMOJI_GAME_DICE_STABLE_KEY,b as EMOJI_GAME_RPS_STABLE_KEY,m as EMOJI_TOKEN_RE,P as MAX_BATCH_FILES,a as MAX_RECENT_EMOJI_COUNT,g as UNICODE_EMOJI_CATALOG,O as blockReasonForChannelSession,N as blockReasonForChannelState,V as blockReasonForGroupState,Y as blockReasonForSession,I as canEditMessage,w as canPinChannelMessage,v as canPinGroupMessage,x as canPinMessage,H as canRecallMessage,fa as cancelMediaUpload,T as classifyGifFile,S as classifyMediaFile,s as countUnreadConversations,u as createChatRuntime,p as createEmojiMatcher,K as decideConversationAction,M as decideMemberTargetAction,L as decideMessageAction,l as emojiAssetUrl,n as emojiUrlByCode,Fa as fetchConversationFileBatch,Ga as fetchConversationImageBatch,Da as fetchConversationMessageBatch,Ha as fetchConversationVideoBatch,Ia as fetchConversationVoiceBatch,Ja as fetchNextConversationSearchBatch,r as formatConversationUnreadBadge,ia as forwardService,o as hasEmojiCandidate,U as isGifFile,y as isPinnedMessageProtected,aa as isVoiceStorageConfigured,Q as mediaBatchBudgetBytes,na as messageService,e as parseUnicodeEmojiCode,sa as pinnedMessageService,d as prependRecentEmoji,Ca as profileService,$ as replaceInterruptedMediaFile,W as requiresConversationEncryption,D as resolveChannelMemberAvatarUrl,C as resolveChannelMemberDisplayName,k as resolveEmojiToken,G as resolveFriendDisplayName,ta as resolveImProfileAccessDestination,A as resolveMemberDisplayName,t as resolveMessageNotificationDecision,F as resolvePublicNickname,E as resolveSenderAvatarUrl,q as resolveStandaloneEmojiMessage,h as resolveUnicodeEmoji,ga as retryMessage,R as runMediaSendBatch,ea as sendAsFilesBatch,J as sendBlockReasonForDecision,ca as sendMediaAlbum,_ as sendMediaFile,da as sendMediaFilesBatch,Z as sendText,ba as sendVoice,X as supportsConversationMention,f as unicodeEmojiTextFromCode}from'./chunk-RDTT34ZF.js';export{C as createNewMessageBadgeController,i as createThreadItems,f as formatChatDateSeparator,e as formatConversationDisplayTime,c as getLocalDayKey,l as isMessageLocateScrollProtected,v as isMessageTailChangeFromOlderWindowTrim,k as isMessageViewportMeasurable,B as isMessageVisibleForNewMessageBadge,x as loadOlderUntilBoundary,p as refreshPrependMessageAnchorPosition,j as resolveCenteredMessageScrollTop,a as resolveDisplayTimestamp,g as resolveImThreadActiveDate,h as resolveMessageBodyKind,b as resolveMessageTimelineTimestamp,n as resolvePrependMessageAnchor,q as resolvePrependMessageAnchorAdjustment,o as resolvePrependMessageAnchorPosition,s as resolveSurvivingMessageAnchorAdjustment,r as resolveVisibleMessageAnchorPositions,t as shouldCompleteInitialViewport,y as shouldFillInitialHistoryViewport,u as shouldFollowIncomingMessage,z as shouldLoadNewerHistoryPage,m as shouldPrefetchOlderHistory,w as shouldRestoreMessageViewportFocus,d as shouldShowChatDateSeparator,A as shouldTrackRemoteMessageForBadge}from'./chunk-PAEBGHDI.js';export{a as DEFAULT_LOCALE,k as createImI18n,f as formatFailure,h as formatLastMessageSummary,i as formatMediaPlaceholder,j as formatMentionAll,l as formatServiceText,g as formatSystemMessage,c as getImTimeCatalog,b as normalizeImLocale,d as registerImCatalogOverrides,e as resetImCatalogOverrides}from'./chunk-ICG32ESA.js';export{e as IMAGE_MESSAGE_ACCEPT,n as IM_CHAT_FONT_SCALES,g as IM_DIAGNOSTIC_CATEGORIES,j as IM_EMOJI_CATALOG,c as ImPinnedMessageOperationError,m as buildSessionFavoritePlainBody,d as createFaceToFaceGroupQrPayload,o as createImClient,h as createImConsoleDiagnosticSink,r as createImDiagnosticMemoryBuffer,s as createImResourceUploader,i as createSdkDiagnosticWriter,f as isSupportedImageFile,a as migrateImCachePrefix,k as resolveImEmojiToken,l as resolveSessionFavoriteKindFromMessage}from'./chunk-HPS3TBSB.js';export{Ya as MediaTransferError,kb as createVoicePlayer,lb as createVoiceRecordingSession,ib as detectVoiceCapabilities,Za as mediaTransferErrorCodeOf,$a as normalizeMediaUploadCredentials,jb as voiceErrorCodeOf}from'./chunk-ELGE657I.js';export{Aa as EDIT_WINDOW_MS,p as MEDIA_ALBUM_CAPTION_MAX_LENGTH,q as MEDIA_ALBUM_MAX_ITEMS,Ia as REACTION_SUPPORTED_CONTENT_TYPES,Ja as canReactToMessage,Ea as canTransmit,Ca as canTransmitByType,Da as canTransmitContent,x as classifyStickerImageType,pa as createImTextSearchMatcher,na as extractSearchText,oa as getImTextSearchInitial,Cb as parseSessionFavoriteAlbumItems,Fb as parseSessionFavoriteFileItems,Ba as requiresForwardTypeConfirmation,La as resolveChannelAccess,r as resolveMediaAlbumSendContentType,Db as resolveSessionFavoriteAlbumCaption,Bb as resolveSessionFavoriteAlbumItemPreviewUrl,ua as resolveTextSegments,Qa as sortSessions,Ra as sumSessionsUnread}from'./chunk-FMEZINTJ.js';import'./chunk-WOT6VMZA.js';
+import'./chunk-IDECJJXC.js';import'./chunk-SXY56EVC.js';export{q as DEFAULT_LOADING_MINIMUM_VISIBLE_MS,p as DEFAULT_LOADING_SHOW_DELAY_MS,x as MINI_PROGRAM_GAME_PREVIEW_FALLBACK_HEIGHT,w as MINI_PROGRAM_GAME_PREVIEW_FALLBACK_WIDTH,e as MINI_PROGRAM_LANG_NUMBERS,S as SPIKE_STEP,N as calculateMediaBox,E as canCopyMessageImage,t as canPromoteMediaPresentationSource,B as captureRuntimeClientOperation,A as captureRuntimeOperation,n as channelMiniProgramRelKey,z as createConversationPrefetchController,r as createDelayedLoadingIndicator,L as createLinkMatcher,F as createMessageImageCopySource,f as csvIncludes,d as decideChannelMiniProgramRelOpen,P as formatFileSize,O as formatMediaDuration,Q as getFileExtension,D as getMessageCopyImageUrl,C as getMessageCopyText,K as hasLinkCandidate,u as highlightSegments,a as isMiniProgramShowTypeOpenable,G as mediaService,J as normalizeLinkHref,V as placeholderWaveform,H as readService,U as resampleWaveform,s as resolveBestMediaPresentationSource,h as resolveChannelMiniProgramRelIcon,g as resolveChannelMiniProgramRelName,j as resolveChannelMiniProgramRelOpenSurface,i as resolveChannelMiniProgramRelUrl,k as resolveChannelPinnedGameCopy,o as resolveConversationListPresentation,M as resolveMediaPresentation,R as resolveMediaTransferPresentation,v as resolveMessageSearchPreview,c as resolveMiniProgramFloatLinkUrl,y as resolveMiniProgramGamePreviewLayout,b as resolveMiniProgramOpenUrl,I as resolveQuotedMessagePresentation,m as resolveVisibleChannelMiniProgramRels,l as sortChannelMiniProgramFloatingItems,T as spikeCountForDuration}from'./chunk-KFVKMPCY.js';export{j as DEFAULT_EMOJI_ASSET_BASE,i as EMOJI_CATALOG,c as EMOJI_GAME_DICE_STABLE_KEY,b as EMOJI_GAME_RPS_STABLE_KEY,m as EMOJI_TOKEN_RE,P as MAX_BATCH_FILES,a as MAX_RECENT_EMOJI_COUNT,g as UNICODE_EMOJI_CATALOG,O as blockReasonForChannelSession,N as blockReasonForChannelState,V as blockReasonForGroupState,Y as blockReasonForSession,I as canEditMessage,w as canPinChannelMessage,v as canPinGroupMessage,x as canPinMessage,H as canRecallMessage,fa as cancelMediaUpload,T as classifyGifFile,S as classifyMediaFile,s as countUnreadConversations,u as createChatRuntime,p as createEmojiMatcher,K as decideConversationAction,M as decideMemberTargetAction,L as decideMessageAction,l as emojiAssetUrl,n as emojiUrlByCode,Fa as fetchConversationFileBatch,Ga as fetchConversationImageBatch,Da as fetchConversationMessageBatch,Ha as fetchConversationVideoBatch,Ia as fetchConversationVoiceBatch,Ja as fetchNextConversationSearchBatch,r as formatConversationUnreadBadge,ia as forwardService,o as hasEmojiCandidate,U as isGifFile,y as isPinnedMessageProtected,aa as isVoiceStorageConfigured,Q as mediaBatchBudgetBytes,na as messageService,e as parseUnicodeEmojiCode,sa as pinnedMessageService,d as prependRecentEmoji,Ca as profileService,$ as replaceInterruptedMediaFile,W as requiresConversationEncryption,D as resolveChannelMemberAvatarUrl,C as resolveChannelMemberDisplayName,k as resolveEmojiToken,G as resolveFriendDisplayName,ta as resolveImProfileAccessDestination,A as resolveMemberDisplayName,t as resolveMessageNotificationDecision,F as resolvePublicNickname,E as resolveSenderAvatarUrl,q as resolveStandaloneEmojiMessage,h as resolveUnicodeEmoji,ga as retryMessage,R as runMediaSendBatch,ea as sendAsFilesBatch,J as sendBlockReasonForDecision,ca as sendMediaAlbum,_ as sendMediaFile,da as sendMediaFilesBatch,Z as sendText,ba as sendVoice,X as supportsConversationMention,f as unicodeEmojiTextFromCode}from'./chunk-DLZBFAYO.js';export{C as createNewMessageBadgeController,i as createThreadItems,f as formatChatDateSeparator,e as formatConversationDisplayTime,c as getLocalDayKey,l as isMessageLocateScrollProtected,v as isMessageTailChangeFromOlderWindowTrim,k as isMessageViewportMeasurable,B as isMessageVisibleForNewMessageBadge,x as loadOlderUntilBoundary,p as refreshPrependMessageAnchorPosition,j as resolveCenteredMessageScrollTop,a as resolveDisplayTimestamp,g as resolveImThreadActiveDate,h as resolveMessageBodyKind,b as resolveMessageTimelineTimestamp,n as resolvePrependMessageAnchor,q as resolvePrependMessageAnchorAdjustment,o as resolvePrependMessageAnchorPosition,s as resolveSurvivingMessageAnchorAdjustment,r as resolveVisibleMessageAnchorPositions,t as shouldCompleteInitialViewport,y as shouldFillInitialHistoryViewport,u as shouldFollowIncomingMessage,z as shouldLoadNewerHistoryPage,m as shouldPrefetchOlderHistory,w as shouldRestoreMessageViewportFocus,d as shouldShowChatDateSeparator,A as shouldTrackRemoteMessageForBadge}from'./chunk-2LUSPYH5.js';export{a as DEFAULT_LOCALE,k as createImI18n,f as formatFailure,h as formatLastMessageSummary,i as formatMediaPlaceholder,j as formatMentionAll,l as formatServiceText,g as formatSystemMessage,c as getImTimeCatalog,b as normalizeImLocale,d as registerImCatalogOverrides,e as resetImCatalogOverrides}from'./chunk-JOD67FT3.js';export{e as IMAGE_MESSAGE_ACCEPT,n as IM_CHAT_FONT_SCALES,g as IM_DIAGNOSTIC_CATEGORIES,j as IM_EMOJI_CATALOG,c as ImPinnedMessageOperationError,m as buildSessionFavoritePlainBody,d as createFaceToFaceGroupQrPayload,o as createImClient,h as createImConsoleDiagnosticSink,r as createImDiagnosticMemoryBuffer,s as createImResourceUploader,i as createSdkDiagnosticWriter,f as isSupportedImageFile,a as migrateImCachePrefix,k as resolveImEmojiToken,l as resolveSessionFavoriteKindFromMessage}from'./chunk-6EPXLFLD.js';export{Ya as MediaTransferError,kb as createVoicePlayer,lb as createVoiceRecordingSession,ib as detectVoiceCapabilities,Za as mediaTransferErrorCodeOf,$a as normalizeMediaUploadCredentials,jb as voiceErrorCodeOf}from'./chunk-ZFYM6YHK.js';export{Aa as EDIT_WINDOW_MS,p as MEDIA_ALBUM_CAPTION_MAX_LENGTH,q as MEDIA_ALBUM_MAX_ITEMS,Ia as REACTION_SUPPORTED_CONTENT_TYPES,Ja as canReactToMessage,Ea as canTransmit,Ca as canTransmitByType,Da as canTransmitContent,x as classifyStickerImageType,pa as createImTextSearchMatcher,na as extractSearchText,oa as getImTextSearchInitial,Cb as parseSessionFavoriteAlbumItems,Fb as parseSessionFavoriteFileItems,Ba as requiresForwardTypeConfirmation,La as resolveChannelAccess,r as resolveMediaAlbumSendContentType,Db as resolveSessionFavoriteAlbumCaption,Bb as resolveSessionFavoriteAlbumItemPreviewUrl,ua as resolveTextSegments,Qa as sortSessions,Ra as sumSessionsUnread}from'./chunk-JHGB6KYI.js';import'./chunk-WOT6VMZA.js';

package/dist/sdk.d.ts

@@ -119,8 +119,11 @@ type LastMessageSummary = {
     kind: 'transfer';
 } | {
     kind: 'gift';
-} | {
+}
+/** 直播间分享。`title` 与卡片主标题一致：先主播昵称，没有再用房间标题。 */
+ | {
     kind: 'liveRoom';
+    title?: string;
 } | {
     kind: 'call';
     callKind: ImCallKind;
@@ -619,20 +622,21 @@ interface ImMediaAlbumBody {
     /** 媒体项，顺序即用户选择顺序（决定宫格 index 与首项朝向）。 */
     items: readonly ImMediaAlbumItem[];
 }
-/** 直播间分享的直播类型。wire `liveType`：1 视频、2 语音、3 双手机、4 单手机录屏、5 语聊房。 */
+/** 直播间分享的直播类型。wire `liveType`：1 视频、2 语音、3 双手机、4 单手机录屏、5 语聊房。空字符串对应 wire 0，表示调用方没有类型，不猜成某一种直播。 */
 type ImLiveRoomType = 'video' | 'voice' | 'dual-phone' | 'screen-record' | 'voice-chat';
 /** 直播间分享的房间状态。wire `liveRoomStatus`：1 预告、2 直播中、3 已结束。 */
 type ImLiveRoomStatus = 'preview' | 'live' | 'ended';
 /**
- * 直播间分享卡片正文（contentType==='liveRoom'，协议 BMessage.contentType=30，fields 98-112）。
+ * 直播间分享卡片正文（contentType==='liveRoom'，协议 BMessage.contentType=30，fields 98-113）。
  *
  * @remarks 调用方先拿到直播间快照再写入本结构。Core 不请求直播接口，也不把缺省枚举猜成某一种直播。
  * `uid` 是声网 SDK 初始化用的 UID，不是 IM 用户 id。
  */
 interface ImLiveRoomBody {
-    /** 直播间 ID（BMessage.liveRoomId）。 */
+    /** 直播间 ID（BMessage.liveRoomId）。没有房间号时为空字符串。 */
     liveRoomId: string;
-    liveType: ImLiveRoomType;
+    /** 没有直播类型时为空字符串。 */
+    liveType: ImLiveRoomType | '';
     liveRoomStatus: ImLiveRoomStatus;
     /** 当前账号是否已关注主播。协议 bool 无法区分未设置，false 也是有效状态。 */
     isFocus: boolean;
@@ -652,6 +656,8 @@ interface ImLiveRoomBody {
     livePreviewId?: string;
     /** 直播间人数字符串，保持协议原文，不在 Core 换算。 */
     liveRoomViewers?: string;
+    /** 点赞数十进制字符串，保持协议原文，不在 Core 换算。 */
+    liveRoomLikes?: string;
 }
 interface ImMessageBody {
     /** P0 文本内容（明文，解密后的结果）。 */
@@ -1606,10 +1612,10 @@ type ImExpressionRecentItem$1 = ImExpressionAsset$1 | ImExpressionEmojiRecent;
  * 会话收藏可展示的内容类型；与 iOS `isSupportCollectionMsgType` 对齐。
  *
  * @remarks 这些值与收藏接口的 `content_type` 数值一一对应，而那个数值就是消息自己的 contentType
- * （1=文本 2=图片 3=视频 4=语音 5=位置 11=文件 28=媒体合集 29=文件合集），不是另一套收藏专用枚举。
+ * （1=文本 2=图片 3=视频 4=语音 5=位置 11=文件 28=媒体合集 29=文件合集 30=直播间分享），不是另一套收藏专用枚举。
  * Android `MessageCollectExecute` 直接写 `message.getContentType()`，iOS 写 `msg.msgType`，两端一致。
  */
-type ImSessionFavoriteKind = 'text' | 'image' | 'video' | 'voice' | 'location' | 'file' | 'mediaAlbum' | 'filesAlbum';
+type ImSessionFavoriteKind = 'text' | 'image' | 'video' | 'voice' | 'location' | 'file' | 'mediaAlbum' | 'filesAlbum' | 'liveRoom';
 /** 服务端一条会话收藏快照；列表以 HTTP 为准，不回写原消息。 */
 interface ImSessionFavoriteItem$1 {
     readonly collectId: string;
@@ -2222,8 +2228,10 @@ declare function canTransmit(message: ForwardCandidateMessage): boolean;
  */
 
 /**
- * 允许被表情回应的父消息正文类型，与 iOS `SZChatReactionService.supportsReactionForMessage:` 的协议白名单一致：
- * 文本、图片、视频、语音、文件、贴纸、名片、小程序、骰子/猜拳，以及转账、通话记录卡片和红包卡片本身。
+ * 允许被表情回应的父消息正文类型。
+ * 文本、图片、视频、语音、文件、贴纸、名片、小程序、骰子/猜拳，以及转账、通话记录卡片和红包卡片本身，
+ * 与 iOS `SZChatReactionService.supportsReactionForMessage:` 一致。
+ * 媒体合集和直播间分享是后续显式放行：回应挂在整条消息上。
  * 系统灰条（含红包领取通知、群提示、频道通知）与 unknown（未知/未来类型）不在白名单内。
  *
  * 这里刻意维持显式白名单而不是「排除 system 和 unknown」：新增 contentType 时默认拒绝，
@@ -4863,14 +4871,16 @@ interface ConversationHandle<TType extends ProductHandleConversationType = Produ
         /**
          * 按稳定消息 id 打开目标附近的连续历史窗口。
          *
-         * @remarks GROUP 完整置顶预览可按消息时间定位；CHANNEL 置顶未缓存时先按 ID 取回正式历史记录，
-         * 以服务端游标准备前后相邻页后一次替换窗口；准备失败保留原窗口。只含控制行的页每侧最多继续四页，
-         * 预算用完仍保留分页能力。短期搜索结果只作为只读锚点；partial 置顶和过期搜索结果明确拒绝定位。
-         * @throws 没有可用锚点、远端确认缺失或目标不属于当前复合会话时，抛出稳定 `IM_SDK_MESSAGE_NOT_FOUND`
-         * （`category: 'state'`、`retryable: false`、`details.messageId`）。这是常见产品结果而非链路异常，
-         * 调用方应据此与真正的存储/协议失败区分反馈，不要解析错误文案。
+         * @remarks 冷启动置顶和搜索结果只提供目标 id；目标不在当前窗口或本地原文时，须经精确会话
+         * `by_id` 确认真实原文及排序位置。预览或搜索位置不能充当历史游标。
+         * GROUP/CHANNEL 使用远端相邻页准备两侧上下文后一次替换窗口；失败保留原窗口。
+         * `signal` 取消本次定位，阻止提交准备中的窗口；不会撤销共享按 ID 查询已取得的合法缓存。
+         * @throws 仅 `by_id` 明确确认缺失时抛 `IM_SDK_MESSAGE_NOT_FOUND`；没有可信原文时抛
+         * `IM_SDK_MESSAGE_ANCHOR_UNAVAILABLE`。存储、权限与协议异常保留原错误身份。
          */
-        loadAround: (messageId: string) => Promise<void>;
+        loadAround: (messageId: string, options?: {
+            signal?: AbortSignal;
+        }) => Promise<void>;
         /**
          * 清空当前账号下此精确会话的本机历史。
          *
@@ -5742,11 +5752,11 @@ interface ImSessionFavoritesApi {
     delete: (collectIds: readonly string[]) => Promise<void>;
 }
 /**
- * 对齐 iOS Cell：文本 / 图 / 视频 / 语音 / 文件 / 媒体合集 / 文件合集可收藏；表情、名片、通话等不可。
+ * 对齐 iOS Cell：文本 / 图 / 视频 / 语音 / 文件 / 媒体合集 / 文件合集 / 直播间分享可收藏；表情、名片、通话等不可。
  *
  * 两端的收藏类型判定都是**黑名单**（iOS `isSupportCollectionMsgType` 排除名片/通话/表情/游戏/未知；
- * Android `isCanCollectByType` 排除通话/表情/名片/未知/解密失败），媒体合集不在黑名单里，
- * 收藏接口的 `content_type` 直接用消息自己的 28。
+ * Android `isCanCollectByType` 排除通话/表情/名片/未知/解密失败）。媒体合集与直播间分享不在黑名单里，
+ * 收藏接口的 `content_type` 直接用消息自己的 28 / 30。
  */
 declare function resolveSessionFavoriteKindFromMessage(message: ImMessageView): ImSessionFavoriteKind | null;
 /**

package/dist/sdk.js

@@ -1 +1 @@
-import'./chunk-IDECJJXC.js';export{e as IMAGE_MESSAGE_ACCEPT,n as IM_CHAT_FONT_SCALES,g as IM_DIAGNOSTIC_CATEGORIES,j as IM_EMOJI_CATALOG,c as ImPinnedMessageOperationError,m as buildSessionFavoritePlainBody,d as createFaceToFaceGroupQrPayload,o as createImClient,h as createImConsoleDiagnosticSink,r as createImDiagnosticMemoryBuffer,s as createImResourceUploader,i as createSdkDiagnosticWriter,f as isSupportedImageFile,a as migrateImCachePrefix,k as resolveImEmojiToken,l as resolveSessionFavoriteKindFromMessage}from'./chunk-HPS3TBSB.js';export{Ya as MediaTransferError,kb as createVoicePlayer,lb as createVoiceRecordingSession,ib as detectVoiceCapabilities,Za as mediaTransferErrorCodeOf,$a as normalizeMediaUploadCredentials,jb as voiceErrorCodeOf}from'./chunk-ELGE657I.js';export{Aa as EDIT_WINDOW_MS,p as MEDIA_ALBUM_CAPTION_MAX_LENGTH,q as MEDIA_ALBUM_MAX_ITEMS,Ia as REACTION_SUPPORTED_CONTENT_TYPES,Ja as canReactToMessage,Ea as canTransmit,Ca as canTransmitByType,Da as canTransmitContent,x as classifyStickerImageType,pa as createImTextSearchMatcher,na as extractSearchText,oa as getImTextSearchInitial,Cb as parseSessionFavoriteAlbumItems,Fb as parseSessionFavoriteFileItems,Ba as requiresForwardTypeConfirmation,La as resolveChannelAccess,r as resolveMediaAlbumSendContentType,Db as resolveSessionFavoriteAlbumCaption,Bb as resolveSessionFavoriteAlbumItemPreviewUrl,ua as resolveTextSegments,Qa as sortSessions,Ra as sumSessionsUnread}from'./chunk-FMEZINTJ.js';import'./chunk-WOT6VMZA.js';
+import'./chunk-IDECJJXC.js';export{e as IMAGE_MESSAGE_ACCEPT,n as IM_CHAT_FONT_SCALES,g as IM_DIAGNOSTIC_CATEGORIES,j as IM_EMOJI_CATALOG,c as ImPinnedMessageOperationError,m as buildSessionFavoritePlainBody,d as createFaceToFaceGroupQrPayload,o as createImClient,h as createImConsoleDiagnosticSink,r as createImDiagnosticMemoryBuffer,s as createImResourceUploader,i as createSdkDiagnosticWriter,f as isSupportedImageFile,a as migrateImCachePrefix,k as resolveImEmojiToken,l as resolveSessionFavoriteKindFromMessage}from'./chunk-6EPXLFLD.js';export{Ya as MediaTransferError,kb as createVoicePlayer,lb as createVoiceRecordingSession,ib as detectVoiceCapabilities,Za as mediaTransferErrorCodeOf,$a as normalizeMediaUploadCredentials,jb as voiceErrorCodeOf}from'./chunk-ZFYM6YHK.js';export{Aa as EDIT_WINDOW_MS,p as MEDIA_ALBUM_CAPTION_MAX_LENGTH,q as MEDIA_ALBUM_MAX_ITEMS,Ia as REACTION_SUPPORTED_CONTENT_TYPES,Ja as canReactToMessage,Ea as canTransmit,Ca as canTransmitByType,Da as canTransmitContent,x as classifyStickerImageType,pa as createImTextSearchMatcher,na as extractSearchText,oa as getImTextSearchInitial,Cb as parseSessionFavoriteAlbumItems,Fb as parseSessionFavoriteFileItems,Ba as requiresForwardTypeConfirmation,La as resolveChannelAccess,r as resolveMediaAlbumSendContentType,Db as resolveSessionFavoriteAlbumCaption,Bb as resolveSessionFavoriteAlbumItemPreviewUrl,ua as resolveTextSegments,Qa as sortSessions,Ra as sumSessionsUnread}from'./chunk-JHGB6KYI.js';import'./chunk-WOT6VMZA.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "k2-im",
   "type": "module",
-  "version": "0.1.48",
+  "version": "0.1.50",
   "private": false,
   "license": "MIT",
   "publishConfig": {