@onyx-p/imlib-web 3.0.4 → 3.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onyx-p/imlib-web",
-  "version": "3.0.4",
+  "version": "3.0.6",
   "main": "index.umd.js",
   "module": "index.esm.js",
   "types": "types/index.d.ts",

package/types/constants/messageTypes.d.ts

@@ -6,6 +6,7 @@ export declare const MessageTypes: {
     AUDIO: number;
     VIDEO: number;
     RECALL: number;
+    STORED_RECALL: number;
     LOCATION: number;
     CHAT_RECORD: number;
     CONTACT: number;
@@ -14,6 +15,8 @@ export declare const MessageTypes: {
     TRANSFER: number;
     LINK: number;
 };
+export declare const WIRE_PRIVATE_RECALL = 1610678290;
+export declare const WIRE_GROUP_RECALL = 1610743841;
 export declare const NotiMessageTypes: {
     GROUP_ARRIVAL_RECEIPT: number;
     GROUP_READ_RECEIPT: number;
@@ -28,4 +31,7 @@ export declare const NotiMessageTypes: {
     CHANGE_GROUP_AVATAR: number;
     PRIVATE_MESSAGE_PINNED: number;
     GROUP_MESSAGE_PINNED: number;
+    CHAT_COMMENT: number;
 };
+export declare function isRecallMessageType(messageType: number): boolean;
+export declare function remapIncomingRecallConstructor(mediaConstructor: number): number;

package/types/database/contracts.d.ts

@@ -1,7 +1,7 @@
 export declare const DATABASE_GLOBAL: "acimDatabase";
 export declare const DATABASE_CHANNEL: "acim-database:request";
-export declare const READ_METHOD_NAMES: readonly ["getMessages", "getLatestMessage", "getLatestMessages", "getDialogLoadedState", "getMessageById", "getMessageByUId", "getMessageIdRange", "getMessagesByType", "getPinnedMessages", "searchMessages", "searchTextMessages", "getLegacyMigrationState"];
-export declare const WRITE_METHOD_NAMES: readonly ["addMessages", "clearConversationCache", "clearAllCache", "removeMessagesByUId", "updateMessageReceiptStatus", "setMessagePinned", "unpinAllMessages", "clearBurnAfterReadingExpiredMessages", "upsertMessage", "convertToRecallMessages", "importLegacyBatch", "completeLegacyMigration"];
+export declare const READ_METHOD_NAMES: readonly ["getMessages", "getLatestMessage", "getLatestMessages", "getDialogLoadedState", "getMessageById", "getMessageByUId", "getMessageIdRange", "getMessagesByType", "getPinnedMessages", "searchMessages", "searchTextMessages", "getLegacyMediaReferences", "getLegacyMigrationState"];
+export declare const WRITE_METHOD_NAMES: readonly ["addMessages", "clearConversationCache", "clearAllCache", "removeMessagesByUId", "updateMessageReceiptStatus", "setMessagePinned", "setMessageReactions", "unpinAllMessages", "clearBurnAfterReadingExpiredMessages", "upsertMessage", "convertToRecallMessages", "importLegacyBatch", "completeLegacyMigration"];
 export type DatabaseReadMethod = (typeof READ_METHOD_NAMES)[number];
 export type DatabaseWriteMethod = (typeof WRITE_METHOD_NAMES)[number];
 export type DatabaseMethod = DatabaseReadMethod | DatabaseWriteMethod;
@@ -17,6 +17,9 @@ export type DatabaseRequest = Readonly<{
     options: DatabaseOpenOptions;
 }> | Readonly<{
     type: 'close';
+}> | Readonly<{
+    type: 'delete';
+    options: DatabaseOpenOptions;
 }> | Readonly<{
     type: 'read';
     method: DatabaseReadMethod;

package/types/database/legacyMediaReferences.d.ts

@@ -0,0 +1,21 @@
+export type LegacyMediaKind = 'image' | 'image-thumbnail' | 'gif' | 'video' | 'video-thumbnail' | 'file' | 'audio';
+export type LegacyMediaReference = Readonly<{
+    messageId: number;
+    conversationType: number;
+    targetId: string;
+    objectKey: string;
+    kind: LegacyMediaKind;
+}>;
+export type LegacyMediaReferencePage = Readonly<{
+    items: ReadonlyArray<LegacyMediaReference>;
+    nextCursor?: number;
+}>;
+type LegacyMessageLike = Readonly<{
+    messageId: number;
+    conversationType?: number;
+    targetId?: string;
+    messageType?: number;
+    content?: Record<string, unknown> | null;
+}>;
+export declare function extractLegacyMediaReferences(message: LegacyMessageLike): ReadonlyArray<LegacyMediaReference>;
+export {};

package/types/database/main/ipc.d.ts

@@ -6,6 +6,7 @@ export interface DatabaseIpcMain {
 export interface DatabaseServiceLike {
     open(options: DatabaseOpenOptions): Promise<void>;
     close(): Promise<void>;
+    deleteAccount(options: DatabaseOpenOptions): Promise<void>;
     read(method: DatabaseReadMethod, args: ReadonlyArray<unknown>): Promise<unknown>;
     write(method: DatabaseWriteMethod, args: ReadonlyArray<unknown>): Promise<unknown>;
 }

package/types/database/main/keyStore.d.ts

@@ -8,6 +8,7 @@ export declare class DatabaseKeyStore {
     private readonly filePath;
     constructor(directory: string, safeStorage: SafeStorageAdapter);
     getOrCreate(accountId: string): string;
+    remove(accountId: string): void;
     private readKeys;
     private writeKeys;
     private validateKey;

package/types/database/main/messageStore.d.ts

@@ -1,16 +1,28 @@
 import type { LegacyMigrationState } from '../contracts';
+import { type LegacyMediaReferencePage } from '../legacyMediaReferences';
 import type { SqlDatabase } from './sqlTypes';
 export type StoredMessage = {
     messageId: number;
     messageUId?: string;
+    conversationType?: number;
+    targetId?: string;
     sentTime: string;
     content?: any;
     quotedReply?: any;
     receivedStatus?: number;
     burnAfterReadingFlag?: boolean;
     burnAfterReadingTime?: number;
+    burnAfterReadingStartedAt?: number;
     messageType?: number;
     isPersited?: boolean;
+    pinned?: boolean;
+    reactions?: ReadonlyArray<{
+        uid: string;
+        msgId: string;
+        content: string;
+        nickname: string;
+        time: number;
+    }>;
     [key: string]: any;
 };
 export type DialogState = Readonly<{
@@ -50,13 +62,21 @@ export declare class MessageStore {
     clearConversationCache(dialogId: string): void;
     clearAllCache(): void;
     removeMessagesByUId(messageUIds: ReadonlyArray<string>): void;
-    updateMessageReceiptStatus(messageUIds: ReadonlyArray<string>, receivedStatus: number): void;
+    updateMessageReceiptStatus(messageUIds: ReadonlyArray<string>, receivedStatus: number, burnAfterReadingStartedAt?: number): void;
     setMessagePinned(dialogId: string, messageUId: string, pinned: boolean): void;
+    setMessageReactions(dialogId: string, messageUId: string, reactions: ReadonlyArray<{
+        uid: string;
+        msgId: string;
+        content: string;
+        nickname: string;
+        time: number;
+    }>): boolean;
     unpinAllMessages(dialogId: string): void;
     clearBurnAfterReadingExpiredMessages(dialogId: string, now?: number): string[];
     convertToRecallMessages(messageUIds: ReadonlyArray<string>, recallMessageType: number): void;
     searchTextMessages(dialogId: string, keyword: string): StoredMessage[];
     searchMessages(keyword: string, dialogId?: string, limit?: number): StoredMessage[];
+    getLegacyMediaReferences(afterMessageId?: number, limit?: number): LegacyMediaReferencePage;
     getLegacyMigrationState(): LegacyMigrationState;
     importLegacyBatch(batch: LegacyImportBatch): void;
     completeLegacyMigration(): void;

package/types/database/main/service.d.ts

@@ -23,6 +23,7 @@ export declare class MainDatabaseService {
     read(method: DatabaseReadMethod, args: ReadonlyArray<unknown>): Promise<unknown>;
     write(method: DatabaseWriteMethod, args: ReadonlyArray<unknown>): Promise<unknown>;
     close(): Promise<void>;
+    deleteAccount(options: DatabaseOpenOptions): Promise<void>;
     private assertOpen;
 }
 export declare class ThreadWorkerClient implements DatabaseWorkerClient {

package/types/database/renderer/legacyIndexedDbMigration.d.ts

@@ -1,5 +1,5 @@
 import CryptoJS from 'crypto-js';
-import type { DatabaseBridge } from '../contracts';
+import type { DatabaseBridge, LegacyMigrationState } from '../contracts';
 type LegacySecret = {
     key: string;
     iv: string;
@@ -13,7 +13,13 @@ export type LegacyMigrationResult = Readonly<{
     messages: number;
     dialogStates: number;
 }>;
-type MigrationOptions = Readonly<{
+export type LegacyMigrationInfo = Readonly<{
+    state: LegacyMigrationState;
+    exists: boolean;
+    totalMessages: number;
+    totalDialogStates: number;
+}>;
+export type MigrationOptions = Readonly<{
     appKey: string;
     userId: string;
     bridge: DatabaseBridge;
@@ -22,7 +28,14 @@ type MigrationOptions = Readonly<{
     batchSize?: number;
     onProgress?: (progress: LegacyMigrationProgress) => void;
 }>;
+export type DeleteLegacyOptions = Readonly<{
+    appKey: string;
+    userId: string;
+    indexedDBFactory?: IDBFactory;
+}>;
 export declare function deriveLegacyEncryptionKey(appKey: string, userId: string): LegacySecret;
 export declare function decryptLegacyMessage<T extends Record<string, any>>(source: T, secret: LegacySecret, crypto?: typeof CryptoJS): T;
+export declare function inspectLegacyIndexedDb({ appKey, userId, bridge, indexedDBFactory }: Pick<MigrationOptions, 'appKey' | 'userId' | 'bridge' | 'indexedDBFactory'>): Promise<LegacyMigrationInfo>;
+export declare function deleteLegacyIndexedDb({ appKey, userId, indexedDBFactory }: DeleteLegacyOptions): Promise<void>;
 export declare function migrateLegacyIndexedDb({ appKey, userId, bridge, indexedDBFactory, keyRange, batchSize, onProgress }: MigrationOptions): Promise<LegacyMigrationResult>;
 export {};

package/types/database/renderer/messageRepository.d.ts

@@ -1,16 +1,27 @@
 import type IReceivedMessage from '../../model/iReceivedMessage';
 import type { IConversationOption, IReceiptReceivedEvent } from '../../types';
 import type { DatabaseBridge } from '../contracts';
-import { type LegacyMigrationProgress, type LegacyMigrationResult } from './legacyIndexedDbMigration';
+import { type LegacyMigrationInfo, type LegacyMigrationProgress, type LegacyMigrationResult } from './legacyIndexedDbMigration';
+import type { LegacyMediaReferencePage } from '../legacyMediaReferences';
+export type SqlMessageRepositoryOptions = Readonly<{
+    legacyMigrationMode?: 'automatic' | 'manual';
+    indexedDBFactory?: IDBFactory;
+    keyRange?: typeof IDBKeyRange;
+}>;
 export declare class SqlMessageRepository {
     private readonly appKey;
     private readonly userId;
     private readonly bridge;
+    private readonly options;
     private initialization;
-    constructor(appKey: string, userId: string, bridge?: DatabaseBridge);
+    constructor(appKey: string, userId: string, bridge?: DatabaseBridge, options?: SqlMessageRepositoryOptions);
     initDB(): Promise<void>;
     migrateLegacyDatabase(onProgress?: (progress: LegacyMigrationProgress) => void): Promise<LegacyMigrationResult>;
+    getLegacyMigrationInfo(): Promise<LegacyMigrationInfo>;
+    getLegacyMediaReferences(afterMessageId?: number, limit?: number): Promise<LegacyMediaReferencePage>;
+    deleteLegacyDatabase(): Promise<void>;
     close(): Promise<void>;
+    deleteDatabase(): Promise<void>;
     addMessages(messages: IReceivedMessage[], conversation: IConversationOption, isEnd?: boolean): Promise<void>;
     getMessages(conversation: IConversationOption, timestamp?: string, count?: number, isForward?: boolean): Promise<{
         messages: IReceivedMessage[];
@@ -38,13 +49,22 @@ export declare class SqlMessageRepository {
     clearAllCache(): Promise<void>;
     removeMessagesByUId(messageUIds: string[]): Promise<void>;
     updateMessageReceiptStatus(event: IReceiptReceivedEvent, type: 0 | 1): Promise<void>;
+    markMessagesRead(messageUIds: ReadonlyArray<string>, readAt: number): Promise<void>;
     setMessagePinned(conversation: IConversationOption, messageUId: string, pinned: boolean): Promise<void>;
+    setMessageReactions(conversation: IConversationOption, messageUId: string, reactions: ReadonlyArray<{
+        uid: string;
+        msgId: string;
+        content: string;
+        nickname: string;
+        time: number;
+    }>): Promise<boolean>;
     unpinAllMessages(conversation: IConversationOption): Promise<void>;
     clearBurnAfterReadingExpiredMessages(conversation: IConversationOption): Promise<string[]>;
     upsertMessage(message: IReceivedMessage): Promise<void>;
     convertToRecallMessages(messageUIds: string[]): Promise<void>;
     searchTextMessages(conversation: IConversationOption, keyword: string): Promise<IReceivedMessage[]>;
     searchMessages(keyword: string, limit?: number): Promise<IReceivedMessage[]>;
+    private migrationOptions;
     private read;
     private write;
 }

package/types/index.d.ts

@@ -1,19 +1,25 @@
 import { ConnectionStatus, ConversationType, NotificationLevel, NotificationStatus } from './model/statusTypes';
-import { EventListeners, Events, GetHistoryMessageOption, GetHistoryMessageResult, IAsyncRes, IBaseConversationInfo, IConversationOption, IConversationState, IDeleteMessageOptions, IGetConversationListOptions, IImageMessageOption, IInitOption, IPromiseResult, IRecallMessageOptions, ISendBody, ISenderEnrichedMessage, ISendMessageOptions, IUploadHooks, IUploadMessageOption, ProfileInfo, IInsertOptions } from './types';
+import { EventListeners, Events, GetHistoryMessageOption, GetHistoryMessageResult, IAsyncRes, IBaseConversationInfo, IConversationOption, IConversationState, IDeleteMessageOptions, IGetConversationListOptions, IImageMessageOption, IInitOption, IPromiseResult, IRecallMessageOptions, ICommentMessageOptions, ISendBody, ISenderEnrichedMessage, ISendMessageOptions, IUploadHooks, IUploadMessageOption, ProfileInfo, IInsertOptions, MessagePinnedScope } from './types';
 import { BaseMessage, IBaseMessageBody } from './model/baseMessage';
 import { ITextMessageBody } from './model/messages/textMessage';
 import IReceivedMessage from './model/iReceivedMessage';
+import type { IMessageReaction } from './core/messageReactions';
 import IReceivedConversation from './model/iReceivedConversation';
 import { CommonReqResult, PBCodec } from './net/connection/webSocketServer';
 import { BaseResp } from './net/pbs/rpc.base';
 import { IChatRecordMsgDetail } from './model/messages/otherMediaMessages';
-import type { LegacyMigrationProgress, LegacyMigrationResult } from './database/renderer/legacyIndexedDbMigration';
+import type { LegacyMigrationInfo, LegacyMigrationProgress, LegacyMigrationResult } from './database/renderer/legacyIndexedDbMigration';
+import type { LegacyMediaReferencePage } from './database/legacyMediaReferences';
+import type { DialogFilterConfig } from './net/pbs/dialogFilter';
 export { TextMessage, ImageMessage, HQVoiceMessage, GIFMessage, FileMessage, VideoMessage, RecallCommandMessage, LocationMessage, ChatRecordMessage, ContactMessage, InvitationMessage, RedEnvelopeMessage, TransferMessage, LinkMessage, PrivateOpenBurnAfterReadingMessage, PrivateCloseBurnAfterReadingMessage, GroupOpenBurnAfterReadingMessage, GroupCloseBurnAfterReadingMessage, PrivateMessagePinnedNotification, GroupMessagePinnedNotification } from './model/messages';
-export type { ITextMessageBody, ITextMessageEntity, ITextMessageLinkPreview, ITextMessageStyleAttribute, TextMessageEntityType, IImageMessageBody, IGIFMessageBody, IFileMessageBody, IHQVoiceMessageBody, IRecallCommandMessageBody, IVideoMessageBody, ILocationMessageBody, IChatRecordMessageBody, IContactMessageBody, IInvitationMessageBody, IRedEnvelopeMessageBody, ITransferMessageBody, IBurnAfterReadingMessageBody, IMessagePinnedNotificationBody, ILinkMessageBody } from './model/messages';
-export { MessageTypes, NotiMessageTypes } from './constants/messageTypes';
+export type { ITextMessageBody, ITextMessageEntity, ITextMessageLinkPreview, ITextMessageStyleAttribute, TextMessageEntityType, IImageMessageBody, IGIFMessageBody, IFileMessageBody, IHQVoiceMessageBody, IRecallCommandMessageBody, IVideoMessageBody, ILocationMessageBody, IChatRecordMessageBody, IChatRecordMsgDetail, IContactMessageBody, IInvitationMessageBody, IRedEnvelopeMessageBody, ITransferMessageBody, IBurnAfterReadingMessageBody, IMessagePinnedNotificationBody, ILinkMessageBody } from './model/messages';
+export { isRecallMessageType, MessageTypes, NotiMessageTypes, remapIncomingRecallConstructor } from './constants/messageTypes';
 export type { IBaseMessageBody, IReceivedMessage, IReceivedConversation };
 export * from './types';
 export * from './model/statusTypes';
+export type { DialogFilter, DialogFilterConfig } from './net/pbs/dialogFilter';
+export type { LegacyMigrationInfo, LegacyMigrationProgress, LegacyMigrationResult } from './database/renderer/legacyIndexedDbMigration';
+export type { LegacyMediaKind, LegacyMediaReference, LegacyMediaReferencePage } from './database/legacyMediaReferences';
 /**
  * 初始化
  * @param initOption
@@ -24,6 +30,9 @@ export declare const init: (initOption: IInitOption) => void;
  * Migration also runs automatically when the current user's database opens.
  */
 export declare const migrateLegacyDatabase: (onProgress?: (progress: LegacyMigrationProgress) => void) => Promise<LegacyMigrationResult>;
+export declare const getLegacyMigrationInfo: () => Promise<LegacyMigrationInfo>;
+export declare const getLegacyMediaReferences: (afterMessageId?: number, limit?: number) => Promise<LegacyMediaReferencePage>;
+export declare const deleteLegacyDatabase: () => Promise<void>;
 /**
  * 建立 IM 连接
  * @param token
@@ -36,6 +45,7 @@ export declare const connect: () => IPromiseResult<void>;
 export declare const disconnect: () => Promise<void>;
 export declare const setUserLogged: (info: ProfileInfo) => Promise<void>;
 export declare const logOut: () => Promise<void>;
+export declare const deleteLocalDatabase: (userId: string) => Promise<void>;
 /**
  * 获取 IM 连接状态
  */
@@ -65,6 +75,7 @@ export declare function onceEventListener<T extends Events>(eventType: T, listen
  * 移除事件
  */
 export declare const removeEventListener: <T extends Events>(eventType: T, listener: EventListeners[T], target?: any) => void;
+export declare const getCachedDialogFilterConfig: () => DialogFilterConfig;
 /**
  * 获取会话列表
  * @param options
@@ -168,6 +179,13 @@ export declare const getBlockedConversationList: () => IPromiseResult<IBaseConve
  * 设置会话是否置顶
  */
 export declare const setConversationToTop: (options: IConversationOption, isTop?: boolean) => IPromiseResult<void>;
+/**
+ * 设置会话阅后即焚。
+ * @param conversation 会话
+ * @param enabled 是否开启
+ * @param burnAfterReadingTime 消息已读后的保留时长（毫秒）；开启时 0 表示即刻焚烧
+ */
+export declare const setConversationBurnAfterReading: (conversation: IConversationOption, enabled: boolean, burnAfterReadingTime?: number) => IPromiseResult<void>;
 /**
  * 获取置顶会话
  */
@@ -187,6 +205,12 @@ export declare const insertMessage: (conversation: IConversationOption, content:
  * @param options
  */
 export declare const sendMessage: (conversation: IConversationOption, message: BaseMessage, options?: ISendMessageOptions) => IPromiseResult<IReceivedMessage>;
+/**
+ * 转发一条已接收消息。IMLib 负责克隆消息内容和发送生命周期，
+ * 资源复制由业务配置的 uploader copy hook 完成。
+ */
+export declare const forwardMessage: (conversation: IConversationOption, originalMessage: IReceivedMessage, options?: ISendMessageOptions) => IPromiseResult<IReceivedMessage>;
+export declare const mergeForwardMessages: (conversation: IConversationOption, originalMessages: ReadonlyArray<ISenderEnrichedMessage>, chatTitle: string, options?: ISendMessageOptions) => IPromiseResult<IReceivedMessage>;
 /**
  * 发送文本消息
  */
@@ -217,7 +241,15 @@ export declare const sendSightMessage: (conversation: IConversationOption, msgBo
  */
 export declare const recallMessage: (conversation: IConversationOption, options: IRecallMessageOptions) => IPromiseResult<IReceivedMessage>;
 /**
- * 获取远程历史消息
+ * 对消息发表或取消表情评论。空 content 表示删除当前用户的评论。
+ */
+export declare const commentMessage: (conversation: IConversationOption, options: ICommentMessageOptions) => IPromiseResult<{
+    reactions: IMessageReaction[];
+}>;
+/**
+ * 获取历史消息。
+ * order 0：先读本地再按需向服务端补更旧消息。
+ * order 1：只读本地数据库中更新方向的消息。
  */
 export declare const getRemoteHistoryMessages: (conversation: IConversationOption, options: GetHistoryMessageOption) => IPromiseResult<GetHistoryMessageResult>;
 /**
@@ -227,7 +259,7 @@ export declare const getHistoryMessages: (conversation: IConversationOption, opt
 /**
  * 设置或取消置顶一条消息。状态将在服务端置顶通知到达后更新。
  */
-export declare const setMessagePinned: (conversation: IConversationOption, messageUId: string, pinned: boolean) => IPromiseResult<void>;
+export declare const setMessagePinned: (conversation: IConversationOption, messageUId: string, pinned: boolean, scope?: MessagePinnedScope) => IPromiseResult<void>;
 /**
  * 取消当前会话的全部置顶消息。
  */
@@ -240,6 +272,10 @@ export declare const getPinnedMessages: (conversation: IConversationOption, coun
  * 按消息 id 删除消息
  */
 export declare const deleteMessages: (conversation: IConversationOption, messages: IDeleteMessageOptions[]) => IPromiseResult<void>;
+/**
+ * 仅删除本地缓存中的消息，不请求服务端。
+ */
+export declare const deleteLocalMessages: (conversation: IConversationOption, messageUIds: string[]) => IPromiseResult<void>;
 /**
  * 按时间戳删除消息
  * @param conversation 会话
@@ -264,7 +300,7 @@ export declare const encodeReceivedMessage2ChatRecordMsgDetail: (message: ISende
  * @param messages 消息列表
  * @returns
  */
-export declare const sendReadReceipts: (messages: IReceivedMessage[]) => IPromiseResult<void>;
+export declare const sendReadReceipts: (messages: IReceivedMessage[], readAt?: number) => IPromiseResult<void>;
 export declare const mockLogin: (config: {
     langCode: string;
     phone: string;
@@ -303,6 +339,10 @@ export declare const getMessageById: (messageId: number) => IPromiseResult<IRece
  * 获取消息
  */
 export declare const getMessageByUId: (messageUId: string) => IPromiseResult<IReceivedMessage | null | undefined>;
+/**
+ * 更新本地消息缓存中的既有消息，不向服务端发送请求。
+ */
+export declare const updateMessage: (message: IReceivedMessage) => IPromiseResult<IReceivedMessage>;
 /**
  * 按消息类型查询当前会话的本地缓存消息。
  * 只读 IMLib 本地库，不向服务端补历史。

package/types/model/iReceivedMessage.d.ts

@@ -1,5 +1,6 @@
 import { ConversationType, MessageDirection, ReceivedStatus, SentStatus } from './statusTypes';
 import IQuotedReplyMessage from './iQuotedReplyMessage';
+import type { IMessageReaction } from '../core/messageReactions';
 /**
  * 消息数据
  */
@@ -81,6 +82,10 @@ export default interface IReceivedMessage {
      * 消息发送状态
      */
     sentStatus: SentStatus;
+    /**
+     * 本地消息发送失败时的错误码。发送成功或尚未失败时不存在。
+     */
+    sendErrorCode?: number;
     /**
      * 是否为阅后即焚消息
      */
@@ -90,10 +95,18 @@ export default interface IReceivedMessage {
      * @default false
      */
     pinned: boolean;
+    /**
+     * 挂在目标消息上的表情评论
+     */
+    reactions?: IMessageReaction[];
     /**
      * 阅后即焚消息的时长
      */
     burnAfterReadingTime?: number;
+    /**
+     * 入站阅后即焚消息首次在本设备标记已读的时间
+     */
+    burnAfterReadingStartedAt?: number;
     /**
      * 引用消息
      */

package/types/model/messages/index.d.ts

@@ -4,9 +4,9 @@ import GIFMessage, { IGIFMessageBody } from './gifMessage';
 import HQVoiceMessage, { IHQVoiceMessageBody } from './voiceMessage';
 import FileMessage, { IFileMessageBody } from './fileMessage';
 import VideoMessage, { IVideoMessageBody } from './videoMessage';
-import { ILocationMessageBody, LocationMessage, IChatRecordMessageBody, ChatRecordMessage, IContactMessageBody, ContactMessage, IInvitationMessageBody, InvitationMessage, IRedEnvelopeMessageBody, RedEnvelopeMessage, ITransferMessageBody, TransferMessage, ILinkMessageBody, LinkMessage } from './otherMediaMessages';
+import { ILocationMessageBody, LocationMessage, IChatRecordMessageBody, IChatRecordMsgDetail, ChatRecordMessage, IContactMessageBody, ContactMessage, IInvitationMessageBody, InvitationMessage, IRedEnvelopeMessageBody, RedEnvelopeMessage, ITransferMessageBody, TransferMessage, ILinkMessageBody, LinkMessage } from './otherMediaMessages';
 import { IBurnAfterReadingMessageBody, IMessagePinnedNotificationBody } from './notificationMessages';
 import { PrivateOpenBurnAfterReadingMessage, PrivateCloseBurnAfterReadingMessage, GroupOpenBurnAfterReadingMessage, GroupCloseBurnAfterReadingMessage, PrivateMessagePinnedNotification, GroupMessagePinnedNotification } from './notificationMessages';
 import RecallCommandMessage, { IRecallCommandMessageBody } from './recallCommandMessage';
 export { TextMessage, ImageMessage, GIFMessage, HQVoiceMessage, FileMessage, RecallCommandMessage, VideoMessage, LocationMessage, ChatRecordMessage, ContactMessage, InvitationMessage, RedEnvelopeMessage, TransferMessage, PrivateOpenBurnAfterReadingMessage, PrivateCloseBurnAfterReadingMessage, GroupOpenBurnAfterReadingMessage, GroupCloseBurnAfterReadingMessage, PrivateMessagePinnedNotification, GroupMessagePinnedNotification, LinkMessage };
-export type { ITextMessageBody, ITextMessageEntity, ITextMessageLinkPreview, ITextMessageStyleAttribute, TextMessageEntityType, IImageMessageBody, IGIFMessageBody, IHQVoiceMessageBody, IFileMessageBody, IRecallCommandMessageBody, IVideoMessageBody, ILocationMessageBody, IChatRecordMessageBody, IContactMessageBody, IInvitationMessageBody, IRedEnvelopeMessageBody, ITransferMessageBody, IBurnAfterReadingMessageBody, IMessagePinnedNotificationBody, ILinkMessageBody };
+export type { ITextMessageBody, ITextMessageEntity, ITextMessageLinkPreview, ITextMessageStyleAttribute, TextMessageEntityType, IImageMessageBody, IGIFMessageBody, IHQVoiceMessageBody, IFileMessageBody, IRecallCommandMessageBody, IVideoMessageBody, ILocationMessageBody, IChatRecordMessageBody, IChatRecordMsgDetail, IContactMessageBody, IInvitationMessageBody, IRedEnvelopeMessageBody, ITransferMessageBody, IBurnAfterReadingMessageBody, IMessagePinnedNotificationBody, ILinkMessageBody };

package/types/model/messages/notificationMessages.d.ts

@@ -16,10 +16,16 @@ export interface IMessageReadMessageBody extends IBaseMessageBody {
 export interface IChangeGroupTitleMessageBody extends IBaseMessageBody {
     newTitle: string;
     groupUin: string;
+    templateId?: number;
+    params?: string[];
 }
 export interface IChangeGroupAvatarMessageBody extends IBaseMessageBody {
     smallAvatarUrl: string;
     groupId: string;
+    originalAvatarUrl?: string;
+    operatorUserId?: string;
+    templateId?: number;
+    params?: string[];
 }
 export interface IMessagePinnedNotificationBody extends IBaseMessageBody {
     operatorUserId?: string;
@@ -29,6 +35,14 @@ export interface IMessagePinnedNotificationBody extends IBaseMessageBody {
     msgId: string;
     pinned: 0 | 1 | 2;
 }
+export interface IChatCommentNotificationBody extends IBaseMessageBody {
+    uid?: string | number;
+    msgId?: string | number;
+    content?: string;
+    nickName?: string;
+    nickname?: string;
+    time?: number | string;
+}
 declare const GroupArrivalReceiptMessage: new (content: IReceiptMessageBody) => import("../baseMessage").BaseMessage<IReceiptMessageBody>;
 declare const GroupReadReceiptMessage: new (content: IReceiptMessageBody) => import("../baseMessage").BaseMessage<IReceiptMessageBody>;
 declare const PrivateArrivalReceiptMessage: new (content: IReceiptMessageBody) => import("../baseMessage").BaseMessage<IReceiptMessageBody>;
@@ -42,4 +56,5 @@ declare const ChangeGroupTitleMessage: new (content: IChangeGroupTitleMessageBod
 declare const ChangeGroupAvatarMessage: new (content: IChangeGroupAvatarMessageBody) => import("../baseMessage").BaseMessage<IChangeGroupAvatarMessageBody>;
 declare const PrivateMessagePinnedNotification: new (content: IMessagePinnedNotificationBody) => import("../baseMessage").BaseMessage<IMessagePinnedNotificationBody>;
 declare const GroupMessagePinnedNotification: new (content: IMessagePinnedNotificationBody) => import("../baseMessage").BaseMessage<IMessagePinnedNotificationBody>;
-export { GroupArrivalReceiptMessage, GroupReadReceiptMessage, PrivateArrivalReceiptMessage, PrivateReadReceiptMessage, PrivateOpenBurnAfterReadingMessage, PrivateCloseBurnAfterReadingMessage, GroupOpenBurnAfterReadingMessage, GroupCloseBurnAfterReadingMessage, MessageReadMessage, ChangeGroupTitleMessage, ChangeGroupAvatarMessage, PrivateMessagePinnedNotification, GroupMessagePinnedNotification };
+declare const ChatCommentNotification: new (content: IChatCommentNotificationBody) => import("../baseMessage").BaseMessage<IChatCommentNotificationBody>;
+export { GroupArrivalReceiptMessage, GroupReadReceiptMessage, PrivateArrivalReceiptMessage, PrivateReadReceiptMessage, PrivateOpenBurnAfterReadingMessage, PrivateCloseBurnAfterReadingMessage, GroupOpenBurnAfterReadingMessage, GroupCloseBurnAfterReadingMessage, MessageReadMessage, ChangeGroupTitleMessage, ChangeGroupAvatarMessage, PrivateMessagePinnedNotification, GroupMessagePinnedNotification, ChatCommentNotification };

package/types/model/messages/otherMediaMessages.d.ts

@@ -14,7 +14,8 @@ export interface IChatRecordMessageBody {
         srcId: string;
         senderNickname: string;
         mediaConstructor: number;
-        msgPostContent: string;
+        msgPostContent?: string;
+        mediaAttribute?: string;
     }>;
     encryptKey?: string;
 }

package/types/model/messages/textMessage.d.ts

@@ -15,6 +15,8 @@ export interface ITextMessageStyleAttribute {
 }
 export interface ITextMessageLinkPreview {
     url: string;
+    /** 仅用于发送阶段，由 IMLib 上传，不会写入消息内容。 */
+    image?: Blob;
     domain?: string;
     title?: string;
     previewDescription?: string;

package/types/types.d.ts

@@ -1,7 +1,11 @@
 import { BaseMessage, IExtraData, IUserInfo } from './model/baseMessage';
 import IReceivedMessage from './model/iReceivedMessage';
+import type { IMessageReaction } from './core/messageReactions';
 import { ConnectionStatus, ConversationType, ErrorCode, MessageDirection, NotificationLevel, NotificationStatus } from './model/statusTypes';
 import IReceivedConversation from './model/iReceivedConversation';
+export type { DialogFilterConfig } from './net/pbs/dialogFilter';
+import type { DialogFilterConfig } from './net/pbs/dialogFilter';
+export type { IMessageReaction };
 export declare enum LogLevel {
     DEBUG = 0,
     INFO = 1,
@@ -10,6 +14,7 @@ export declare enum LogLevel {
     FATAL = 4,
     NONE = 1000
 }
+export type LegacyMigrationMode = 'automatic' | 'manual';
 export type IInitOption = {
     appkey: string;
     /**
@@ -24,6 +29,7 @@ export type IInitOption = {
     uploader?: IUploader;
     deviceCode: string;
     deviceType: number;
+    legacyMigrationMode?: LegacyMigrationMode;
 };
 export interface ProfileInfo {
     deviceId: string;
@@ -42,13 +48,16 @@ export declare enum Events {
     RECALL = "RECALL",
     ARRIVAL_RECEIPT_RECEIVED = "ARRIVAL_RECEIPT_RECEIVED",
     READ_RECEIPT_RECEIVED = "READ_RECEIPT_RECEIVED",
-    MESSAGE_PINNED_CHANGED = "MESSAGE_PINNED_CHANGED"
+    MESSAGE_PINNED_CHANGED = "MESSAGE_PINNED_CHANGED",
+    MESSAGE_REACTIONS_CHANGED = "MESSAGE_REACTIONS_CHANGED",
+    DIALOG_FILTER_CONFIG = "DIALOG_FILTER_CONFIG"
 }
 export declare enum MessagePinnedOperation {
     PIN = 0,
     UNPIN = 1,
     UNPIN_ALL = 2
 }
+export type MessagePinnedScope = 'everyone' | 'me';
 export interface IMessagePinnedChangedEvent {
     conversation: IConversationOption;
     messageUId?: string;
@@ -88,6 +97,8 @@ export type EventListeners = {
     [Events.ARRIVAL_RECEIPT_RECEIVED]: (event: IReceiptReceivedEvent) => void;
     [Events.READ_RECEIPT_RECEIVED]: (event: IReceiptReceivedEvent) => void;
     [Events.MESSAGE_PINNED_CHANGED]: (event: IMessagePinnedChangedEvent) => void;
+    [Events.MESSAGE_REACTIONS_CHANGED]: (event: IMessageReactionsChangedEvent) => void;
+    [Events.DIALOG_FILTER_CONFIG]: (config: DialogFilterConfig) => void;
 };
 export interface IBaseConversationInfo {
     conversationType: ConversationType;
@@ -118,6 +129,7 @@ export type IUpdatedConversationItem = Partial<Record<IUpdatedConversationItemKe
 export type IUpdatedConversation = {
     conversation: IReceivedConversation;
     updatedItems: IUpdatedConversationItem;
+    removed?: boolean;
 };
 /**
  * 消息的推送配置
@@ -197,10 +209,34 @@ export type IUploadCallback = {
     onCompleted?: (result: IUploadCompletedResult) => void;
     onError?: (reason: string) => void;
 };
+export type IForwardResourceSource = {
+    sourceUrl: string;
+    encryptKey?: string;
+};
+export type IForwardResourceItem = IForwardResourceSource & {
+    url: string;
+};
+export type IForwardResourcePrepareParams = {
+    sourceConversation: IConversationOption;
+    targetConversation: IConversationOption;
+    items: ReadonlyArray<IForwardResourceSource>;
+};
+export type IForwardResourceCopyParams = {
+    sourceConversation: IConversationOption;
+    targetConversation: IConversationOption;
+    items: ReadonlyArray<IForwardResourceItem>;
+};
+export type IForwardResourceCallback = {
+    onProgress?: (progress: number) => void;
+    onCompleted?: () => void;
+    onError?: (reason: string) => void;
+};
 export interface IUploader {
     upload(params: IUploadMessageParams, callback: IUploadCallback): void;
     cancel(): void;
     prepare(files: Blob[]): Promise<IUploadPrepareResult>;
+    prepareCopy?(params: IForwardResourcePrepareParams): Promise<IForwardResourceCopyParams>;
+    copy?(params: IForwardResourceCopyParams, callback: IForwardResourceCallback): void;
 }
 /**
  * 文件消息配置
@@ -238,6 +274,17 @@ export interface IRecallMessageOptions {
      */
     messageUId: string;
 }
+export interface ICommentMessageOptions {
+    messageUId: string;
+    content: string;
+    nickname?: string;
+}
+export interface IMessageReactionsChangedEvent {
+    conversation: IConversationOption;
+    messageUId: string;
+    reactions: IMessageReaction[];
+    change: IMessageReaction;
+}
 /**
  * 获取远程消息 option 参数
  */