k2-im 0.1.20 → 0.1.21

package/dist/browser.js

@@ -1 +1 @@
-export{A as createLazyBrowserApiProtocolClient}from'./chunk-4RG5NHIL.js';import'./chunk-ZDD7A2BS.js';import'./chunk-WOT6VMZA.js';
+export{A as createLazyBrowserApiProtocolClient}from'./chunk-YAM4YHKF.js';import'./chunk-A2BLOVZ5.js';import'./chunk-WOT6VMZA.js';

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

@@ -126,12 +126,17 @@ type LastMessageSummary = {
  *
  * 只给结构化计数与配文，**不在这里拼「2 张照片, 1 个视频」这种文案**——中英文的量词、复数与
  * 连接符各不相同，必须由 im-i18n 按 locale 组装。`caption` 非空时宿主优先显示配文（对齐三端）。
+ *
+ * `firstItemKind` 是第一项是照片还是视频。有配文时列表显示的是配文，光看计数无法决定该配
+ * 照片图标还是视频图标，三端统一按第一项取（对齐 iOS `IMMediaAlbumMessageBody`）。
+ * 入站解析后所有项都被丢弃时缺省，宿主据此不显示类型图标。
  */
  | {
     kind: 'mediaAlbum';
     imageCount: number;
     videoCount: number;
     caption?: string;
+    firstItemKind?: 'image' | 'video';
 } | {
     kind: 'encrypted';
 } | {
@@ -4036,12 +4041,16 @@ type ConversationLastMessageSummary = {
  *
  * 只给计数与配文，数量文案由宿主经 im-i18n 按 locale 组装；有配文时优先显示配文。
  * 两个计数都为 0 表示入站正文残缺（所有项都无法解析），宿主应按未知正文处理。
+ *
+ * `firstItemKind` 是第一项是照片还是视频。有配文时列表显示的是配文，光看计数决定不了该配
+ * 照片图标还是视频图标，三端统一按第一项取；正文残缺时缺省，宿主据此不显示类型图标。
  */
  | {
     kind: 'mediaAlbum';
     imageCount: number;
     videoCount: number;
     caption?: string;
+    firstItemKind?: 'image' | 'video';
 } | {
     kind: 'encrypted';
 } | {
@@ -4928,6 +4937,31 @@ interface ImMediaTasksApi {
      * @throws 持久缓存读取失败时抛 `IM_SDK_MEDIA_CACHE_READ_FAILED`，不能把存储故障伪装成 cache miss。
      */
     getCached: (message: ImMessageRef) => Promise<Blob | null>;
+    /**
+     * 为宿主手里的**本地**图片/视频文件预读展示元信息：尺寸、视频时长、视频首帧封面的 JPEG 字节。
+     *
+     * 给「发送前预览」这类场景用：宿主要在用户还没点发送时就把缩略图画出来，而浏览器读不出视频的
+     * 首帧——`<video preload="metadata">` 在 iOS Safari 上只加载元信息、**不解码任何一帧**，
+     * 拿它当缩略图会得到一个空白格子（还会白占一路解码）。
+     *
+     * 返回的对象可以**原样**作为 `localPreviewMetadata` 交给 `sendImage` / `sendVideo` /
+     * `sendMediaAlbum`：发送链路会跳过重复解码，上传中的气泡也从第一帧就有封面。
+     * 视频封面用的就是发送链路那套规格（长边 320、JPEG），所以弹层里看到的与最终发出去的是同一张。
+     *
+     * @param input.kind 按文件类型选解码路径；`'video'` 才会抽首帧与读时长。
+     * @param input.file 本地文件；不会被上传，也不会进任何缓存。
+     * @param input.signal 宿主放弃时中止解码（例如预览弹层被关掉）。
+     * @returns 解码成功返回元信息；**浏览器确实读不出这个文件**（格式不支持、解码超时）时返回 `null`，
+     * 调用方应当显式呈现「这个文件读不出来」，不要拿空白格子糊过去。失败原因会记入 SDK 结构化诊断。
+     * @throws 宿主通过 `signal` 中止时抛 `AbortError`——那是调用方自己的取消，不能和「读不出来」混为一谈。
+     * @throws runtime 已 logout/dispose 时抛 `IM_SDK_MEDIA_RUNTIME_INACTIVE`；
+     * 未装配预览端口时抛 `IM_SDK_MEDIA_PREVIEW_UNAVAILABLE`，不静默返回 `null`。
+     */
+    prepareLocalPreview: <TKind extends 'image' | 'video'>(input: {
+        kind: TKind;
+        file: Blob;
+        signal?: AbortSignal;
+    }) => Promise<(TKind extends 'video' ? VideoPreviewMetadata : ImagePreviewMetadata) | null>;
 }
 
 /**
@@ -5376,14 +5410,8 @@ interface ImSearchApi {
     readonly messages: ImMessageSearchApi;
 }
 
-/**
- * 会话收藏稳定产品门面。
- *
- * 本模块不缓存服务端列表；每次 list/add/delete 都以当前账号 provider 为准。
- * 收藏快照与原聊天消息解耦：原消息删除、撤回或编辑不会回写收藏。
- */
-
 type ImSessionFavoriteItem = Readonly<ImSessionFavoriteItem$1>;
+
 /** 产品层会话收藏 API。 */
 interface ImSessionFavoritesApi {
     list: () => Promise<readonly ImSessionFavoriteItem[]>;
@@ -7076,6 +7104,9 @@ declare function useImHistoryReturnAfterSendCoordinator(pinia?: Pinia): ImHistor
  * - `start` / `reset`：开始监听当前 SDK Client，或切账号时退订并清空旧任务。
  * - `cancel` / `retry`：按 SDK 给出的任务 ID 取消或重试。
  * - `cancelUpload`：根据当前会话类型、会话 ID 和消息 ID 找到唯一上传任务后取消。
+ * - `cancelDownload`：按消息身份取消在途下载；合集要带项下标，因为一条合集的每一项是独立任务。
+ *   与 `cancelUpload` 不同，它定位任务时不看当前会话——切会话正是关闭预览的路径之一。
+ *   取消是任务级的，同一下载的所有等待方都会一起收到取消，只有唯一消费者才该调它。
  * - `requestReplacement` / `takeReplacementRequest`：视频或文件刷新后失去本地源时，生成一次重新选择请求；
  *   宿主取走意图后自行打开平台文件选择器，File 本身不会写入 Store。
  *