k2-im 0.1.16 → 0.1.17

package/dist/browser.js

@@ -1 +1 @@
-export{A as createLazyBrowserApiProtocolClient}from'./chunk-KBKZ27GY.js';import'./chunk-KZM3GLRL.js';import'./chunk-WOT6VMZA.js';
+export{A as createLazyBrowserApiProtocolClient}from'./chunk-K6P5ZYHG.js';import'./chunk-KTWXKQ4J.js';import'./chunk-WOT6VMZA.js';

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

@@ -1313,6 +1313,13 @@ interface ImLoginContext {
 interface ImAuthIssue {
     code: number;
     reason: 'token_expired' | 'kicked' | 'banned' | 'unknown';
+    /**
+     * 服务端记录的账号上次登录时间（毫秒时间戳），用于宿主提示「你的账号于某时在其他设备登录」。
+     *
+     * 只有登录被拒的被踢路径（CMLoginAck.nLastLoginTime）能拿到该时间；运行期收到
+     * CM_KICKOUT_NOTIFICATION 时协议不带时间，此处为 undefined，由宿主自行决定如何展示。
+     */
+    lastLoginTime?: number;
 }
 interface ImAuthProvider {
     /** 返回登录上下文；返回 null 表示当前不可登录（缺凭据）。 */
@@ -1645,6 +1652,45 @@ interface ImProfilePort {
     clearCache?: () => void;
 }
 
+/** 会话收藏可展示的内容类型；与 iOS `isSupportCollectionMsgType` 对齐。 */
+type ImSessionFavoriteKind = 'text' | 'image' | 'video' | 'voice' | 'location' | 'file';
+/** 服务端一条会话收藏快照；列表以 HTTP 为准，不回写原消息。 */
+interface ImSessionFavoriteItem$1 {
+    readonly collectId: string;
+    readonly msgId: string;
+    readonly kind: ImSessionFavoriteKind;
+    readonly senderId: string;
+    readonly senderName: string;
+    readonly avatarUrl: string;
+    readonly createdAt: string;
+    readonly text: string;
+    readonly imageUrl: string;
+    readonly fileName: string;
+    readonly body: Readonly<Record<string, unknown>>;
+    readonly conversation: ConversationRef | null;
+}
+/** 把一条会话消息写成收藏快照时所需的已校验字段。 */
+interface ImSessionFavoriteWriteInput {
+    readonly messageId: string;
+    readonly conversation: ConversationRef;
+    readonly senderId: string;
+    readonly createdAt: number;
+    readonly kind: ImSessionFavoriteKind;
+    readonly plainBody: Readonly<Record<string, unknown>>;
+    readonly peerId: string;
+    readonly hide?: boolean;
+}
+/**
+ * 会话收藏 HTTP 端口。
+ *
+ * Browser adapter 负责 `/user/favorite/*`、收藏 TEA 和 DTO 映射；Core 不持有收藏列表副本。
+ */
+interface ImSessionFavoritePort {
+    list: () => Promise<readonly ImSessionFavoriteItem$1[]>;
+    add: (input: ImSessionFavoriteWriteInput) => Promise<ImSessionFavoriteItem$1>;
+    delete: (collectIds: readonly string[]) => Promise<void>;
+}
+
 /** 迁移期存储会话入参；新代码使用 ref，string 仅兼容唯一命中的旧调用。 */
 type ImStorageConversation = ConversationRef | string;
 /** 打开账号库的选项。namespace = 账号隔离键（登录 userId）。 */
@@ -2063,6 +2109,10 @@ type ImEvent = {
  | {
     type: 'application:updated';
     application: ApplicationUpdate;
+}
+/** 其它端改了会话收藏；权威列表必须重新拉 HTTP，不携带收藏正文。 */
+ | {
+    type: 'session-favorites:changed';
 } | {
     type: 'sync:complete';
     conversations: ConversationRef[];
@@ -4719,12 +4769,16 @@ interface ImProductEventMap {
     'application:updated': Readonly<{
         application: ImProductApplicationUpdate;
     }>;
+    /** 其它端改了会话收藏；权威列表必须重新拉 HTTP。 */
+    'session-favorites:changed': Readonly<Record<never, never>>;
     'sync:complete': Readonly<{
         conversations: readonly ConversationRef<ProductConversationListType>[];
     }>;
+    /** `lastLoginTime` 为服务端记录的上次登录时间（毫秒），仅被踢且走登录 ACK 的路径才有值。 */
     'auth:invalid': Readonly<{
         code: string;
         reason: ImProductAuthInvalidReason;
+        lastLoginTime?: number;
     }>;
     'error': Readonly<{
         error: ImProductEventError;
@@ -5010,6 +5064,25 @@ interface ImSearchApi {
     readonly messages: ImMessageSearchApi;
 }
 
+/**
+ * 会话收藏稳定产品门面。
+ *
+ * 本模块不缓存服务端列表；每次 list/add/delete 都以当前账号 provider 为准。
+ * 收藏快照与原聊天消息解耦：原消息删除、撤回或编辑不会回写收藏。
+ */
+
+type ImSessionFavoriteItem = Readonly<ImSessionFavoriteItem$1>;
+/** 产品层会话收藏 API。 */
+interface ImSessionFavoritesApi {
+    list: () => Promise<readonly ImSessionFavoriteItem[]>;
+    addFromMessage: (input: {
+        message: ImMessageView;
+        conversation: ConversationRef;
+        selfId: string;
+    }) => Promise<ImSessionFavoriteItem>;
+    delete: (collectIds: readonly string[]) => Promise<void>;
+}
+
 /**
  * 当前账号的 IM 本地偏好产品域。
  *
@@ -5235,6 +5308,8 @@ interface ImAdvancedClientOptions extends ImClientOptions {
     coreClient?: ApiProtocolClient;
     /** 高级/测试入口可注入端口替身；default 始终使用 Browser adapter。 */
     expressionProvider?: ImExpressionPort;
+    /** 高级/测试入口可注入会话收藏端口替身；default 始终使用 Browser adapter。 */
+    sessionFavoriteProvider?: ImSessionFavoritePort;
 }
 /** 产品级账号与连接生命周期；adapter、transport 和连接状态机原子不进入该接口。 */
 interface ImSessionApi {
@@ -5510,6 +5585,7 @@ interface ImProductClient {
     readonly channels: ImChannelsApi;
     readonly applications: ImApplicationsApi;
     readonly expressions: ImExpressionsApi;
+    readonly sessionFavorites: ImSessionFavoritesApi;
     readonly outbox: ImOutboxApi;
     readonly drafts: ImDraftsApi;
     readonly search: ImSearchApi;
@@ -6086,7 +6162,7 @@ type ImPinnedMessageActionResult = Readonly<{
 }>;
 
 type ConversationCapabilityAction = 'conversation.openProfile' | 'conversation.readHistory' | 'conversation.listPreferences' | 'composer.send' | 'composer.mentionAll' | 'profile.edit' | 'relationship.manage' | 'members.view' | 'members.manage' | 'members.invite' | 'members.remove' | 'members.setAdmin' | 'ownership.transfer' | 'conversation.leave' | 'channel.manageMute' | 'channel.setMemberPrivateChat' | 'channel.dismiss';
-type MessageCapabilityAction = 'message.reply' | 'message.recall' | 'message.edit' | 'message.pin' | 'message.unpin' | 'message.deleteLocal' | 'message.deleteForEveryone' | 'message.forward' | 'message.multiSelect';
+type MessageCapabilityAction = 'message.reply' | 'message.recall' | 'message.edit' | 'message.pin' | 'message.unpin' | 'message.deleteLocal' | 'message.deleteForEveryone' | 'message.forward' | 'message.favorite' | 'message.multiSelect';
 type MemberTargetCapabilityAction = 'members.removeTarget' | 'members.editNicknameTarget' | 'members.setAdminTarget' | 'members.unsetAdminTarget';
 interface MemberTargetCapabilityInput {
     snapshot: ConversationCapabilitySnapshot;
@@ -7945,6 +8021,47 @@ type ImSearchOperationResult = Readonly<{
 /** 取得当前 Vue setup 或显式 Pinia 的搜索 Store；不同宿主实例不会共享查询或定位状态。 */
 declare function useImSearchStore(pinia?: Pinia): any;
 
+/**
+ * 为 PC/H5 提供同一套会话收藏列表和已收藏标记。
+ *
+ * 【状态来源】
+ * `items` 始终来自 SDK `client.sessionFavorites.list()`。4633 产品事件只唤醒重拉，不从通知拼造条目。
+ * 已收藏标记由当前列表按 `msgId → collectId` 派生，不写回 ImMessage。
+ *
+ * 【明确不负责】
+ * 页面、预览、Toast、路由和 i18n 属于宿主；HTTP、收藏 TEA 和协议通知属于 SDK。
+ */
+
+type ImSessionFavoritesStoreError = Readonly<Pick<ImSdkErrorShape, 'code' | 'category' | 'operation' | 'retryable'>>;
+type ImSessionFavoritesReloadResult = Readonly<{
+    ok: true;
+    operation: 'reload';
+} | {
+    ok: false;
+    operation: 'reload';
+    reason: 'stale';
+} | {
+    ok: false;
+    operation: 'reload';
+    reason: 'failed';
+    error: ImSessionFavoritesStoreError;
+}>;
+type ImSessionFavoritesWriteResult = Readonly<{
+    ok: true;
+    operation: 'add' | 'delete';
+    collectId: string;
+} | {
+    ok: false;
+    operation: 'add' | 'delete';
+    reason: 'stale';
+} | {
+    ok: false;
+    operation: 'add' | 'delete';
+    reason: 'failed';
+    error: ImSessionFavoritesStoreError;
+}>;
+declare function useImSessionFavoritesStore(pinia?: Pinia): any;
+
 /** 页面可展示的 IM 启动阶段：空闲、恢复本机数据、联网、可用、失败或永久销毁。 */
 type ImSessionPhase = 'idle' | 'preparing' | 'connecting' | 'ready' | 'error' | 'disposed';
 /** 宿主每次登录、退出或切账号时交给 `applySession` 的完整输入。 */
@@ -8146,5 +8263,5 @@ type ImThreadStore = Store<'k2-im-thread', ImThreadStoreState, Record<string, ne
 /** 取得当前 Vue setup 或显式 Pinia 的消息线程 Store；每个实例只管理一个当前会话。 */
 declare function useImThreadStore(pinia?: Pinia): ImThreadStore;
 
-export { applicationKey, createAndInstallImChatKit, createImChatKitContext, disposeImChatKit, ensureImChatKitSelfProfile, getImChatKitContext, installImChatKit, useImApplicationsStore, useImCapabilitiesStore, useImComposerStore, useImConversationActivationCoordinator, useImConversationDeletionCoordinator, useImConversationListStore, useImExpressionStore, useImHistoryReturnAfterSendCoordinator, useImMediaStore, useImMessageOperationsStore, useImProfileDirectoryStore, useImQuotedMessageStore, useImReactionStore, useImSearchStore, useImSessionStore, useImThreadPagingStore, useImThreadReturnToLatestCoordinator, useImThreadStore };
-export type { ApplyImSessionInput, ChatRuntimeFactories, ChatRuntimeHostDeps, ImApplicationDomainCounts, ImApplicationReviewOperation, ImApplicationReviewResult, ImApplicationsReloadResult, ImApplicationsStoreError, ImCapabilitiesStore, ImChannelManagementMemberTarget, ImChannelMemberManagementOperation, ImChannelMemberManagementResult, ImChannelMemberManagementResultFor, ImChannelProfileActionResult, ImChannelProfileActionResultFor, ImChannelProfileOperation, ImChatKitContext, ImChatKitInstallation, ImComposerStore, ImComposerStoreActions, ImComposerStoreState, ImComposerSubmitResult, ImConversationActivationCoordinator, ImConversationActivationError, ImConversationActivationResult, ImConversationDeletionCoordinator, ImConversationDeletionError, ImConversationDeletionResult, ImConversationListActionError, ImConversationListMutationOperation, ImConversationListMutationResult, ImConversationListRefreshResult, ImConversationListStore, ImDirectContactActionResult, ImDirectContactActionResultFor, ImDirectContactOperation, ImDirectoryState, ImEmojiPanelRecentEntry, ImEmojiRecentEntry, ImExpressionLoadStatus, ImExpressionOperation, ImExpressionOperationResult, ImExpressionRecentPersistencePort, ImExpressionRecentPersistenceSnapshot, ImExpressionRecentViewItem, ImExpressionResetOptions, ImExpressionSendResult, ImExpressionStore, ImExpressionStoreActions, ImExpressionStoreError, ImExpressionStoreGetters, ImExpressionStoreState, ImForwardPreparationResult, ImGameRecentEntry, ImGroupMemberManagementOperation, ImGroupMemberManagementResult, ImGroupMemberManagementResultFor, ImGroupProfileActionResult, ImGroupProfileActionResultFor, ImGroupProfileOperation, ImHistoryReturnAfterSendCoordinator, ImHistoryReturnError, ImHistoryReturnExecution, ImHistoryReturnResult, ImMediaOperationResult, ImMediaReplacementRequest, ImMediaStoreError, ImMediaTaskPresentation, ImMembershipJoinActionResult, ImMembershipJoinOperation, ImMessageOperationsStore, ImMessageOperationsStoreActions, ImMessageOperationsStoreState, ImMessageSelectionResult, ImPersistedEmojiPanelRecentEntry, ImPersistedEmojiRecentEntry, ImPersistedExpressionAssetRecentEntry, ImPersistedGameRecentEntry, ImProfileAccessDestination, ImProfileAccessResult, ImProfileDirectoryResult, ImQuotedMessageState, ImQuotedMessageStore, ImQuotedMessageStoreActions, ImQuotedMessageStoreState, ImReactionOperationResult, ImReactionStore, ImReactionStoreActions, ImReactionStoreError, ImReactionStoreState, ImSearchOperationResult, ImSessionPhase, ImSessionStore, ImThreadPagingActions, ImThreadPagingState, ImThreadPagingStore, ImThreadReturnToLatestCoordinator, ImThreadStore, ImThreadStoreActions, ImThreadStoreState };
+export { applicationKey, createAndInstallImChatKit, createImChatKitContext, disposeImChatKit, ensureImChatKitSelfProfile, getImChatKitContext, installImChatKit, useImApplicationsStore, useImCapabilitiesStore, useImComposerStore, useImConversationActivationCoordinator, useImConversationDeletionCoordinator, useImConversationListStore, useImExpressionStore, useImHistoryReturnAfterSendCoordinator, useImMediaStore, useImMessageOperationsStore, useImProfileDirectoryStore, useImQuotedMessageStore, useImReactionStore, useImSearchStore, useImSessionFavoritesStore, useImSessionStore, useImThreadPagingStore, useImThreadReturnToLatestCoordinator, useImThreadStore };
+export type { ApplyImSessionInput, ChatRuntimeFactories, ChatRuntimeHostDeps, ImApplicationDomainCounts, ImApplicationReviewOperation, ImApplicationReviewResult, ImApplicationsReloadResult, ImApplicationsStoreError, ImCapabilitiesStore, ImChannelManagementMemberTarget, ImChannelMemberManagementOperation, ImChannelMemberManagementResult, ImChannelMemberManagementResultFor, ImChannelProfileActionResult, ImChannelProfileActionResultFor, ImChannelProfileOperation, ImChatKitContext, ImChatKitInstallation, ImComposerStore, ImComposerStoreActions, ImComposerStoreState, ImComposerSubmitResult, ImConversationActivationCoordinator, ImConversationActivationError, ImConversationActivationResult, ImConversationDeletionCoordinator, ImConversationDeletionError, ImConversationDeletionResult, ImConversationListActionError, ImConversationListMutationOperation, ImConversationListMutationResult, ImConversationListRefreshResult, ImConversationListStore, ImDirectContactActionResult, ImDirectContactActionResultFor, ImDirectContactOperation, ImDirectoryState, ImEmojiPanelRecentEntry, ImEmojiRecentEntry, ImExpressionLoadStatus, ImExpressionOperation, ImExpressionOperationResult, ImExpressionRecentPersistencePort, ImExpressionRecentPersistenceSnapshot, ImExpressionRecentViewItem, ImExpressionResetOptions, ImExpressionSendResult, ImExpressionStore, ImExpressionStoreActions, ImExpressionStoreError, ImExpressionStoreGetters, ImExpressionStoreState, ImForwardPreparationResult, ImGameRecentEntry, ImGroupMemberManagementOperation, ImGroupMemberManagementResult, ImGroupMemberManagementResultFor, ImGroupProfileActionResult, ImGroupProfileActionResultFor, ImGroupProfileOperation, ImHistoryReturnAfterSendCoordinator, ImHistoryReturnError, ImHistoryReturnExecution, ImHistoryReturnResult, ImMediaOperationResult, ImMediaReplacementRequest, ImMediaStoreError, ImMediaTaskPresentation, ImMembershipJoinActionResult, ImMembershipJoinOperation, ImMessageOperationsStore, ImMessageOperationsStoreActions, ImMessageOperationsStoreState, ImMessageSelectionResult, ImPersistedEmojiPanelRecentEntry, ImPersistedEmojiRecentEntry, ImPersistedExpressionAssetRecentEntry, ImPersistedGameRecentEntry, ImProfileAccessDestination, ImProfileAccessResult, ImProfileDirectoryResult, ImQuotedMessageState, ImQuotedMessageStore, ImQuotedMessageStoreActions, ImQuotedMessageStoreState, ImReactionOperationResult, ImReactionStore, ImReactionStoreActions, ImReactionStoreError, ImReactionStoreState, ImSearchOperationResult, ImSessionFavoritesReloadResult, ImSessionFavoritesStoreError, ImSessionFavoritesWriteResult, ImSessionPhase, ImSessionStore, ImThreadPagingActions, ImThreadPagingState, ImThreadPagingStore, ImThreadReturnToLatestCoordinator, ImThreadStore, ImThreadStoreActions, ImThreadStoreState };