@appthen/sdk-react 0.0.2 → 0.0.3

package/dist/ChatHubMessageBody.js

@@ -12,11 +12,29 @@ function renderMutedMessageBody(status) {
     const label = status === 'deleted' ? '消息已删除' : '消息已撤回';
     return (_jsx("div", { className: "rounded-2xl border border-dashed border-border/60 bg-muted/20 px-3 py-2 text-sm text-muted-foreground", children: label }));
 }
+/**
+ * 卡片消息内容判定（与宿主 messageCardRendering.isCardTemplateMessageContent 同构）。
+ * content.cardTemplate.templateId 是卡片段的唯一权威判定；kind 只是分派提示，
+ * 第三方写入方漏传/误标（'text'、'cardTemplate' 等）时不应导致卡片降级为 JSON 文本。
+ */
+function isCardTemplateMessageContent(message) {
+    const cardTemplate = message.content
+        ?.cardTemplate;
+    if (!cardTemplate || typeof cardTemplate !== 'object' || Array.isArray(cardTemplate)) {
+        return false;
+    }
+    const templateId = cardTemplate.templateId;
+    return typeof templateId === 'string' && templateId.length > 0;
+}
 export function ChatHubMessageBody(props) {
     const { message, renderers } = props;
     if (message.status === 'deleted' || message.status === 'revoked') {
         return _jsx(_Fragment, { children: renderMutedMessageBody(message.status) });
     }
-    const renderer = (message.kind && renderers?.[message.kind]) || renderers?.default;
+    const renderer = (message.kind && renderers?.[message.kind]) ||
+        // kind 误标兜底：content 权威判定为卡片时回落到卡片渲染器，
+        // 避免 kind !== 'card' 的卡片消息走 defaultRenderBody 渲染成原始 JSON。
+        (isCardTemplateMessageContent(message) ? renderers?.card : undefined) ||
+        renderers?.default;
     return _jsx(_Fragment, { children: renderer ? renderer(message) : defaultRenderBody(message) });
 }

package/dist/index.d.ts

@@ -6,6 +6,17 @@ export { ChatHubMessageBody, type ChatHubMessageBodyRenderer, type ChatHubMessag
 export { createChatHubDefaultBodyRenderers, type ChatHubDefaultBodyRendererOptions, } from './ChatHubDefaultBodyRenderers';
 export { extractChatHubMessagePlainText, useChatHubMessageMutations, type ChatHubForwardDraftItem, type ForwardChatHubMessagesOptions, type ChatHubMutationActionState, type UseChatHubMessageMutationsOptions, type UseChatHubMessageMutationsResult, } from './useChatHubMessageMutations';
 export { useChatHubMessageActions, type ChatHubActionSurface, type ChatHubMessageActionItem, type UseChatHubMessageActionsOptions, type UseChatHubMessageActionsResult, } from './useChatHubMessageActions';
+/**
+ * 会话列表刷新选项（P1 游标分页）。
+ * - `limit`：页大小（不传 = 全量，保持历史行为）；
+ * - `search`：服务端搜索（标题 / conversationId 纯文本匹配）。
+ */
+export interface RefreshConversationsOptions {
+    limit?: number;
+    search?: string;
+}
+/** 会话列表「加载更多」的默认页大小（与服务端 limit 上限 200 无冲突）。 */
+export declare const DEFAULT_CONVERSATION_PAGE_SIZE = 30;
 export interface UseChatHubAppOptions {
     runtime: ChatHubAppRuntime;
     config: ChatHubAppConfig;
@@ -26,7 +37,12 @@ export interface UseChatHubAppResult {
     selectedSenderId: string;
     setSelectedSenderId: (subjectId: string) => void;
     bootstrapConversation: () => Promise<ChatHubBootstrapResult | null>;
-    refreshConversations: () => Promise<void>;
+    refreshConversations: (options?: RefreshConversationsOptions) => Promise<void>;
+    /**
+     * 加载下一页会话（P1 游标分页）：从当前列表最后一条构造 keyset 游标，
+     * 追加去重后返回本页新增条数（0 = 没有更多）。
+     */
+    loadMoreConversations: (limit?: number) => Promise<number>;
     refreshMessages: (conversationIdOrOptions?: string | (Partial<ListChatHubMessagesOptions> & {
         mode?: 'replace' | 'prepend' | 'append';
     })) => Promise<ConversationMessageRecord[]>;

package/dist/index.js

@@ -1,4 +1,5 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { buildConversationListCursorFromRecord } from '@appthen/sdk-core';
 export { ChatHubMessageTimeline } from './ChatHubMessageTimeline';
 export { ChatHubComposer } from './ChatHubComposer';
 export { ChatHubMessageActions } from './ChatHubMessageActions';
@@ -6,6 +7,17 @@ export { ChatHubMessageBody, } from './ChatHubMessageBody';
 export { createChatHubDefaultBodyRenderers, } from './ChatHubDefaultBodyRenderers';
 export { extractChatHubMessagePlainText, useChatHubMessageMutations, } from './useChatHubMessageMutations';
 export { useChatHubMessageActions, } from './useChatHubMessageActions';
+/**
+ * refreshMessages 未显式给出 limit 时的兜底页大小。
+ *
+ * 「不传 limit = 拉整段会话历史」是个陷阱：调用方少写一个参数，服务端就会把
+ * 该会话的全部消息一次性返回（2000 条消息的会话 ≈ 4.5MB/次），在 30s 兜底轮询
+ * 下尤其致命。任何「刷新消息」语义的调用都不需要全量，故在此兜底；确需历史请走
+ * refreshMessagesPage 的 beforeCreatedAt 分页。
+ */
+const DEFAULT_MESSAGE_REFRESH_LIMIT = 50;
+/** 会话列表「加载更多」的默认页大小（与服务端 limit 上限 200 无冲突）。 */
+export const DEFAULT_CONVERSATION_PAGE_SIZE = 30;
 export function areConversationMessagesEqual(left, right) {
     return JSON.stringify(left) === JSON.stringify(right);
 }
@@ -88,6 +100,8 @@ export function useChatHubApp(options) {
     const [error, setError] = useState(null);
     const [busy, setBusy] = useState(false);
     const [conversations, setConversations] = useState([]);
+    // ref 镜像：loadMoreConversations 需要「当前最后一条」构造游标，避免闭包过期
+    const conversationsRef = useRef([]);
     const [messages, setMessages] = useState([]);
     const [selectedConversationId, setSelectedConversationIdState] = useState(initialConversationId);
     const selectedConversationIdRef = useRef(initialConversationId);
@@ -145,12 +159,16 @@ export function useChatHubApp(options) {
             setBusy(false);
         }
     }, []);
-    const refreshConversations = useCallback(async () => {
+    const refreshConversations = useCallback(async (options) => {
         const requestSeq = ++refreshConversationsRequestSeqRef.current;
-        const list = await runtime.listConversations(selectedSenderIdRef.current);
+        const list = await runtime.listConversations(selectedSenderIdRef.current, {
+            ...(options?.limit ? { limit: options.limit } : {}),
+            ...(options?.search ? { search: options.search } : {}),
+        });
         if (requestSeq !== refreshConversationsRequestSeqRef.current) {
             return;
         }
+        conversationsRef.current = list;
         setConversations(list);
         setSelectedConversationIdState((current) => {
             const next = current || list[0]?.conversationId || '';
@@ -158,6 +176,32 @@ export function useChatHubApp(options) {
             return next;
         });
     }, [runtime]);
+    /**
+     * 加载下一页（P1 游标分页）：以当前列表最后一条构造 keyset 游标向后翻页，
+     * 追加去重（按 conversationId）。返回新增条数；0 = 已到底（调用方可收起入口）。
+     */
+    const loadMoreConversations = useCallback(async (limit = DEFAULT_CONVERSATION_PAGE_SIZE) => {
+        const current = conversationsRef.current;
+        const cursor = buildConversationListCursorFromRecord(current[current.length - 1]);
+        if (!cursor) {
+            return 0;
+        }
+        const next = await runtime.listConversations(selectedSenderIdRef.current, {
+            limit,
+            cursor,
+        });
+        if (next.length === 0) {
+            return 0;
+        }
+        const existingIds = new Set(current.map((item) => item.conversationId));
+        const appended = next.filter((item) => !existingIds.has(item.conversationId));
+        if (appended.length > 0) {
+            const merged = [...current, ...appended];
+            conversationsRef.current = merged;
+            setConversations(merged);
+        }
+        return appended.length;
+    }, [runtime]);
     const refreshMessages = useCallback(async (conversationIdOrOptions) => {
         const options = typeof conversationIdOrOptions === 'string'
             ? {
@@ -175,7 +219,7 @@ export function useChatHubApp(options) {
         }
         const list = await runtime.listMessages({
             conversationId: targetConversationId,
-            limit: options.limit,
+            limit: options.limit ?? DEFAULT_MESSAGE_REFRESH_LIMIT,
             beforeCreatedAt: options.beforeCreatedAt,
             afterSequence: options.afterSequence,
         });
@@ -297,6 +341,7 @@ export function useChatHubApp(options) {
         setSelectedSenderId,
         bootstrapConversation,
         refreshConversations,
+        loadMoreConversations,
         refreshMessages,
         refreshMessagesPage,
         mergeMessages,
@@ -309,6 +354,7 @@ export function useChatHubApp(options) {
         config,
         conversations,
         error,
+        loadMoreConversations,
         messages,
         refreshConversations,
         refreshMessages,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appthen/sdk-react",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "AppThen Conversation Hub SDK - React headless hooks",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@appthen/sdk-core": "0.0.2"
+    "@appthen/sdk-core": "0.0.3"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"