k2-im 0.1.33 → 0.1.34

package/dist/browser.js

@@ -1 +1 @@
-export{Ta as canCopyImageToClipboard,Ua as copyImageToClipboard,B as createLazyBrowserApiProtocolClient}from'./chunk-OFXCH5DZ.js';import'./chunk-F6DQBWJW.js';import'./chunk-WOT6VMZA.js';
+export{Ta as canCopyImageToClipboard,Ua as copyImageToClipboard,B as createLazyBrowserApiProtocolClient}from'./chunk-IEFK5A7T.js';import'./chunk-PJ2PW42T.js';import'./chunk-WOT6VMZA.js';

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

@@ -679,7 +679,7 @@ type ImMessageFailureReason = 'timeout' | 'rejected' | 'encrypt_failed' | 'netwo
  * 失败**展示语义**码（强类型枚举，非裸串）：供 im-i18n 按 locale 渲染失败气泡文案。
  * 由 `reason` / `SendMediaFailReason` / ACK errcode 穷尽映射而来，与 im-i18n failure catalog 键一一对应（media.* 带 mediaKind 参数）。
  */
-type ImFailureDisplayCode = 'media.empty' | 'media.noCrypto' | 'media.previewFailed' | 'media.encryptFailed' | 'media.resumeUnavailable' | 'media.cleanupUnconfirmed' | 'media.uploadFailed' | 'media.cancelled' | 'media.invalidDuration' | 'media.uploadInterrupted' | 'media.contentTooLarge' | 'contactRequired' | 'messageRefused' | 'forbiddenOrLeft' | 'contentRejected' | 'groupDismissed' | 'groupUnavailable' | 'channelDismissed' | 'channelMuted' | 'channelNotMember' | 'channelAdminRequired' | 'conversationUnsupported' | 'sendCanceled' | 'sessionLoggedOut' | 'timeout' | 'network' | 'unknown';
+type ImFailureDisplayCode = 'media.empty' | 'media.noCrypto' | 'media.previewFailed' | 'media.encryptFailed' | 'media.resumeUnavailable' | 'media.cleanupUnconfirmed' | 'media.uploadFailed' | 'media.uploadTimeout' | 'media.cancelled' | 'media.invalidDuration' | 'media.uploadInterrupted' | 'media.contentTooLarge' | 'contactRequired' | 'messageRefused' | 'forbiddenOrLeft' | 'contentRejected' | 'groupDismissed' | 'groupUnavailable' | 'channelDismissed' | 'channelMuted' | 'channelNotMember' | 'channelAdminRequired' | 'conversationUnsupported' | 'sendCanceled' | 'sessionLoggedOut' | 'timeout' | 'network' | 'unknown';
 interface ImMessageFailure {
     /** 归一后的错误码（来自 MESChatAck.errcode 或本地失败码，本地码用负值）。 */
     code: number;
@@ -705,7 +705,7 @@ interface MediaTaskUpdate {
     messageId: string;
     ref: ConversationRef;
     direction: 'upload' | 'download';
-    state: 'queued' | 'running' | 'completed' | 'failed' | 'canceled';
+    state: 'queued' | 'running' | 'paused' | 'completed' | 'failed' | 'canceled';
     percent: number;
     /**
      * upload 任务子阶段。
@@ -713,7 +713,16 @@ interface MediaTaskUpdate {
      * `waiting-upload-slot` 与 `state: 'queued'` 同时出现，表示还没开始传字节（在生成缩略图或在等上传槽位），
      * 此时 percent 恒为 0；`transferring` 正在传字节；`finalizing` 是等待远端 URL 最终确认。
      */
-    phase?: 'waiting-upload-slot' | 'transferring' | 'finalizing';
+    phase?: 'waiting-upload-slot' | 'waiting-retry' | 'transferring' | 'finalizing';
+    /** 当前发送意图的尝试序号与总上限。 */
+    attempt?: number;
+    maxAttempts?: number;
+    /** 已传与总字节数，供共享展示层估算速度。 */
+    bytesTransferred?: number;
+    bytesTotal?: number;
+    /** 跨刷新恢复可用性；缺省尚未建立恢复记录。 */
+    recovery?: 'available' | 'session-only';
+    recoveryReason?: string;
     failure?: ImMessageFailure;
 }
 interface ImMessageEncryption {
@@ -4819,9 +4828,9 @@ interface ConversationMessageApi {
     /** 显式添加/替换或移除，供参与者详情等不能用 toggle 猜动作的产品交互。 */
     setReaction: (messageId: string, emoji: string, action: ImReactionChangeAction) => Promise<ImReactionChangeResult>;
     /**
-     * 为刷新后上传中断的视频重新选择源文件，并原地替换同一条消息。
+     * 为源文件已释放的视频重新选择源文件，并原地替换同一条消息。
      *
-     * @remarks 只接受当前 handle 中 `media.uploadInterrupted` 的失败视频。SDK 复用原消息 id 与排序时间，
+     * @remarks 只接受上传中断、已取消或超时耗尽后的失败视频；必须重新选择文件。SDK 复用原消息 id 与排序时间，
      * 不清理当前 Composer 草稿；重新上传失败仍更新同一条消息。
      * @example
      * ```ts
@@ -4830,9 +4839,9 @@ interface ConversationMessageApi {
      */
     replaceInterruptedVideo: (messageId: string, file: File | Blob, options?: VideoMessageOptions) => Promise<SendMessageResult>;
     /**
-     * 为刷新后上传中断的文件重新选择源文件，并原地替换同一条消息。
+     * 为源文件已释放的文件重新选择源文件，并原地替换同一条消息。
      *
-     * @remarks 只接受当前 handle 中 `media.uploadInterrupted` 的失败文件。SDK 复用原消息 id 与排序时间，
+     * @remarks 只接受上传中断、已取消或超时耗尽后的失败文件或单项 filesAlbum；保留原配文。SDK 复用原消息 id 与排序时间，
      * 不清理当前 Composer 草稿；Blob 没有 name 时仍必须传 `fileName`。
      * @example
      * ```ts
@@ -5160,7 +5169,7 @@ interface ImMediaTask {
     /** upload 来自发送链路，download 来自本产品 API。 */
     direction: 'upload' | 'download';
     /** 终态 completed/failed/canceled 不会被同一尝试的迟到 progress 回退。 */
-    state: 'queued' | 'running' | 'completed' | 'failed' | 'canceled';
+    state: 'queued' | 'running' | 'paused' | 'completed' | 'failed' | 'canceled';
     /** 0-100 的归一化整数。 */
     percent: number;
     /**
@@ -5170,7 +5179,16 @@ interface ImMediaTask {
      * 等上传槽位），此时 `percent` 恒为 0——宿主应显示「等待中」而不是把 0 当成停住的进度。
      * `transferring` 是正在传字节，`finalizing` 是字节已传完、在等对象存储确认。
      */
-    phase?: 'waiting-upload-slot' | 'transferring' | 'finalizing';
+    phase?: 'waiting-upload-slot' | 'waiting-retry' | 'transferring' | 'finalizing';
+    /** 当前发送意图的尝试序号与总上限。 */
+    attempt?: number;
+    maxAttempts?: number;
+    /** 已传与总字节数，供共享展示层估算速度。 */
+    bytesTransferred?: number;
+    bytesTotal?: number;
+    /** 跨刷新恢复可用性；缺省尚未建立恢复记录。 */
+    recovery?: 'available' | 'session-only';
+    recoveryReason?: string;
     /** 可供产品按 code/category 决策的稳定错误；不含底层 URL、密钥或响应正文。 */
     error?: ImSdkErrorShape;
 }
@@ -5208,6 +5226,20 @@ interface ImMediaTasksApi {
      * @throws 未知任务、非法状态或底层未受理时以稳定 `IM_SDK_MEDIA_TASK_*` 错误拒绝。
      */
     cancel: (taskId: string) => Promise<void>;
+    /** 暂停上传，等待请求收尾后返回；下载不支持暂停。 */
+    pause: (taskId: string) => Promise<void>;
+    /** 恢复已暂停上传，复用同一原文件与消息。 */
+    resume: (taskId: string) => Promise<void>;
+    /** 只暴露恢复可用性，不返回文件密钥或远端分片凭据。 */
+    getUploadRecovery: (message: ImMessageRef) => Promise<{
+        available: boolean;
+        reason?: string;
+        expiresAt?: number;
+    }>;
+    /** 用户重选原文件并通过完整内容校验后恢复原消息。 */
+    resumeUpload: (message: ImMessageRef, input: {
+        file: Blob;
+    }) => Promise<void>;
     /**
      * 重试 failed/canceled 任务；上传复用保留原文件，下载重新解析同一精确消息引用。
      * 续传不可用或清理未确认时，必须先征得用户同意重新上传，再传 restartUpload:true。
@@ -6011,6 +6043,10 @@ interface ImClientOptions {
      * 缺省则**不装配媒体传输端口** → `sendImage`/`sendVideo`/`loadImage`/`loadVideo` 显式不可用（connection 层 reject，非静默）；预览（Canvas 缩略图/封面）不依赖此配置、恒可用。
      */
     media?: ImMediaConfig;
+    /** 显式开启视频/文件跨刷新续传。最多 3 条、24 小时，保存加密密钥但不保存文件副本；注销清除。 */
+    uploadRecovery?: {
+        enabled: boolean;
+    };
 }
 /**
  * 官方 UI Kit、调试工具与高级宿主的装配参数。
@@ -6623,6 +6659,10 @@ interface ChatRuntimeHostDeps {
     clientType: number;
     /** 获取当前环境的媒体上传下载配置；未启用媒体能力时返回 `undefined`。 */
     getMediaConfig: () => ImMediaConfig | undefined;
+    /** 显式启用账号隔离的跨刷新恢复记录；保存密钥、不保存原文件，注销清除。 */
+    uploadRecovery?: {
+        enabled: boolean;
+    };
     /** 获取 GIF provider 配置；API key 只留在宿主闭包与 SDK adapter，不进入共享 Store。 */
     getExpressionOptions?: () => ImExpressionOptions | undefined;
 }
@@ -7517,10 +7557,16 @@ interface ImHistoryReturnAfterSendCoordinator {
  */
 declare function useImHistoryReturnAfterSendCoordinator(pinia?: Pinia): ImHistoryReturnAfterSendCoordinator;
 
+/** 展示层估算，不表示服务端确认进度或最终处理耗时。 */
+interface MediaTransferEstimate {
+    readonly bytesPerSecond: number;
+    readonly estimatedRemainingMs: number;
+}
+
 /** 页面可保存和判断的媒体错误；底层响应、异常对象和详情只进入统一诊断，不进入 Pinia。 */
 type ImMediaStoreError = Readonly<Omit<ImSdkErrorShape, 'cause' | 'details'>>;
 /** 页面可展示的只读媒体任务；不含文件字节、本地地址、密钥、中止控制器或传输对象。 */
-type ImMediaTaskPresentation = Readonly<Omit<ImMediaTask, 'error'> & {
+type ImMediaTaskPresentation = Readonly<Omit<ImMediaTask, 'error'> & Partial<MediaTransferEstimate> & {
     error?: ImMediaStoreError;
 }>;
 /** 刷新页面导致上传源丢失后，通知宿主重新打开文件选择器所需的信息；File 本身不进入 Store。 */
@@ -7530,14 +7576,14 @@ interface ImMediaReplacementRequest {
     conversationType: ProductHandleConversationType;
     kind: 'video' | 'file';
 }
-/** 取消/重试结果；`stale` 表示期间已切账号，宿主不应显示旧任务反馈。 */
+/** 媒体控制结果；`stale` 表示期间已切账号，宿主不应显示旧任务反馈。 */
 type ImMediaOperationResult = Readonly<{
     ok: true;
-    operation: 'cancel' | 'retry';
+    operation: 'cancel' | 'retry' | 'pause' | 'resume' | 'resumeUpload';
 } | {
     ok: false;
-    operation: 'cancel' | 'retry';
-    reason: 'not-ready' | 'not-found' | 'failed' | 'stale';
+    operation: 'cancel' | 'retry' | 'pause' | 'resume' | 'resumeUpload';
+    reason: 'not-ready' | 'not-found' | 'ambiguous' | 'failed' | 'stale';
     error?: ImMediaStoreError;
 }>;
 /**
@@ -7552,6 +7598,7 @@ declare function defineImMediaStore(pinia: Pinia): pinia.StoreDefinition<"k2-im-
     tasks: any;
     error: any;
     uploadProgress: any;
+    uploadTasks: any;
     downloadTasks: any;
     downloadProgress: any;
     uploadWaiting: any;
@@ -7563,8 +7610,18 @@ declare function defineImMediaStore(pinia: Pinia): pinia.StoreDefinition<"k2-im-
     retry: (taskId: string, options?: {
         restartUpload?: boolean;
     }) => Promise<ImMediaOperationResult>;
+    pause: (taskId: string) => Promise<ImMediaOperationResult>;
+    resume: (taskId: string) => Promise<ImMediaOperationResult>;
+    getUploadRecovery: (message: ImMessageRef) => Promise<{
+        available: boolean;
+        reason?: string;
+        expiresAt?: number;
+    }>;
+    resumeUpload: (message: ImMessageRef, input: {
+        file: Blob;
+    }) => Promise<ImMediaOperationResult>;
     cancelUpload: (messageId: string) => Promise<ImMediaOperationResult>;
-    cancelDownload: (messageId: string, itemIndex?: number) => Promise<ImMediaOperationResult>;
+    cancelDownload: (message: string | ImMessageRef, itemIndex?: number) => Promise<ImMediaOperationResult>;
     requestReplacement: (message: ImMessageView) => boolean;
     takeReplacementRequest: () => ImMediaReplacementRequest | null;
     clearReplacementRequest: () => void;
@@ -7573,6 +7630,7 @@ declare function defineImMediaStore(pinia: Pinia): pinia.StoreDefinition<"k2-im-
     tasks: any;
     error: any;
     uploadProgress: any;
+    uploadTasks: any;
     downloadTasks: any;
     downloadProgress: any;
     uploadWaiting: any;
@@ -7584,8 +7642,18 @@ declare function defineImMediaStore(pinia: Pinia): pinia.StoreDefinition<"k2-im-
     retry: (taskId: string, options?: {
         restartUpload?: boolean;
     }) => Promise<ImMediaOperationResult>;
+    pause: (taskId: string) => Promise<ImMediaOperationResult>;
+    resume: (taskId: string) => Promise<ImMediaOperationResult>;
+    getUploadRecovery: (message: ImMessageRef) => Promise<{
+        available: boolean;
+        reason?: string;
+        expiresAt?: number;
+    }>;
+    resumeUpload: (message: ImMessageRef, input: {
+        file: Blob;
+    }) => Promise<ImMediaOperationResult>;
     cancelUpload: (messageId: string) => Promise<ImMediaOperationResult>;
-    cancelDownload: (messageId: string, itemIndex?: number) => Promise<ImMediaOperationResult>;
+    cancelDownload: (message: string | ImMessageRef, itemIndex?: number) => Promise<ImMediaOperationResult>;
     requestReplacement: (message: ImMessageView) => boolean;
     takeReplacementRequest: () => ImMediaReplacementRequest | null;
     clearReplacementRequest: () => void;
@@ -7594,6 +7662,7 @@ declare function defineImMediaStore(pinia: Pinia): pinia.StoreDefinition<"k2-im-
     tasks: any;
     error: any;
     uploadProgress: any;
+    uploadTasks: any;
     downloadTasks: any;
     downloadProgress: any;
     uploadWaiting: any;
@@ -7605,8 +7674,18 @@ declare function defineImMediaStore(pinia: Pinia): pinia.StoreDefinition<"k2-im-
     retry: (taskId: string, options?: {
         restartUpload?: boolean;
     }) => Promise<ImMediaOperationResult>;
+    pause: (taskId: string) => Promise<ImMediaOperationResult>;
+    resume: (taskId: string) => Promise<ImMediaOperationResult>;
+    getUploadRecovery: (message: ImMessageRef) => Promise<{
+        available: boolean;
+        reason?: string;
+        expiresAt?: number;
+    }>;
+    resumeUpload: (message: ImMessageRef, input: {
+        file: Blob;
+    }) => Promise<ImMediaOperationResult>;
     cancelUpload: (messageId: string) => Promise<ImMediaOperationResult>;
-    cancelDownload: (messageId: string, itemIndex?: number) => Promise<ImMediaOperationResult>;
+    cancelDownload: (message: string | ImMessageRef, itemIndex?: number) => Promise<ImMediaOperationResult>;
     requestReplacement: (message: ImMessageView) => boolean;
     takeReplacementRequest: () => ImMediaReplacementRequest | null;
     clearReplacementRequest: () => void;