@unif/react-native-chat-sdk 0.1.1 → 0.2.0

package/lib/typescript/module/stores/historyStore.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 历史会话持久化
+ * 使用 ChatStorage 抽象，不直接依赖 AsyncStorage
+ */
+import type { ChatMessage } from '../types/message';
+import type { ChatStorage } from './storage';
+export interface SessionSummary {
+    id: string;
+    title: string;
+    lastMessage: string;
+    timestamp: number;
+    messageCount: number;
+}
+export interface HistoryStore {
+    sessions: SessionSummary[];
+    archiveSession: (id: string, title: string, messages: ChatMessage[]) => Promise<void>;
+    loadSessionMessages: (id: string) => Promise<ChatMessage[]>;
+    deleteSession: (id: string) => Promise<void>;
+    clearAll: () => Promise<void>;
+}
+export declare function createHistoryStore(storage: ChatStorage): HistoryStore;
+//# sourceMappingURL=historyStore.d.ts.map

package/lib/typescript/module/stores/historyStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyStore.d.ts","sourceRoot":"","sources":["../../../../src/stores/historyStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,WAAW,CAAC;AAK3C,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,cAAc,EAAE,CACd,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,WAAW,EAAE,KACpB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5D,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAqFrE"}

package/lib/typescript/module/stores/modelStore.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 模型选择状态（Zustand）
+ * 内部 store，通过 useXModel hook 封装后对外暴露
+ */
+interface ModelState {
+    selectedModel: string;
+    setSelectedModel: (id: string) => void;
+}
+export declare const createModelStore: (defaultModel: string) => import("zustand").UseBoundStore<import("zustand").StoreApi<ModelState>>;
+export {};
+//# sourceMappingURL=modelStore.d.ts.map

package/lib/typescript/module/stores/modelStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelStore.d.ts","sourceRoot":"","sources":["../../../../src/stores/modelStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,UAAU,UAAU;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,eAAO,MAAM,gBAAgB,GAAI,cAAc,MAAM,4EAIhD,CAAC"}

package/lib/typescript/module/stores/sessionStore.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 会话状态管理（Zustand）
+ * 内部 store，通过 useXConversations hook 封装后对外暴露
+ */
+interface SessionState {
+    sessionId: string;
+    sessionTitle: string;
+    setSessionId: (id: string) => void;
+    setSessionTitle: (title: string) => void;
+}
+export declare const createSessionStore: (generateId: () => string) => import("zustand").UseBoundStore<import("zustand").StoreApi<SessionState>>;
+export {};
+//# sourceMappingURL=sessionStore.d.ts.map

package/lib/typescript/module/stores/sessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../../../../src/stores/sessionStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,eAAO,MAAM,kBAAkB,GAAI,YAAY,MAAM,MAAM,8EAMtD,CAAC"}

package/lib/typescript/module/stores/storage.d.ts

@@ -0,0 +1,10 @@
+/**
+ * ChatStorage — 存储抽象接口
+ * 不绑定 AsyncStorage，支持注入任意存储实现
+ */
+export interface ChatStorage {
+    getItem: (key: string) => Promise<string | null>;
+    setItem: (key: string, value: string) => Promise<void>;
+    removeItem: (key: string) => Promise<void>;
+}
+//# sourceMappingURL=storage.d.ts.map

package/lib/typescript/module/stores/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../../src/stores/storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACjD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C"}

package/lib/typescript/module/tools/SSEParser.d.ts

@@ -0,0 +1,19 @@
+/**
+ * SSE 解析器
+ * - event_id 幂等去重
+ * - seq 严格排序（乱序缓冲，顺序到达后 flush）
+ * - 每轮对话调用 reset() 重置
+ */
+import type { SSEEnvelope } from '../types/sse';
+export declare class SSEParser {
+    private processedIds;
+    private buffer;
+    private nextSeq;
+    reset(): void;
+    /**
+     * 解析原始 SSE data 字符串，返回按 seq 排序的事件数组
+     * 已处理的 event_id 会被自动跳过（幂等）
+     */
+    process(raw: string): SSEEnvelope[];
+}
+//# sourceMappingURL=SSEParser.d.ts.map

package/lib/typescript/module/tools/SSEParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SSEParser.d.ts","sourceRoot":"","sources":["../../../../src/tools/SSEParser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAE9C,qBAAa,SAAS;IACpB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,OAAO,CAAK;IAEpB,KAAK,IAAI,IAAI;IAMb;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE;CA2BpC"}

package/lib/typescript/module/tools/XRequest.d.ts

@@ -0,0 +1,33 @@
+/**
+ * XRequest — 面向 LLM 的 HTTP 请求工具
+ *
+ * 组合 XStream + SSEParser 实现完整 SSE 请求链路
+ */
+import type { SSEOutput } from '../types/provider';
+export interface XRequestConfig {
+    baseURL: string;
+    endpoint?: string;
+    model?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    getToken?: () => Promise<string | null>;
+}
+export interface XRequestCallbacks {
+    onStream?: (chunk: SSEOutput) => void;
+    onSuccess?: (message: string) => void;
+    onError?: (error: {
+        type: string;
+        message: string;
+    }) => void;
+    onAbort?: () => void;
+}
+export declare class XRequest {
+    private config;
+    private stream;
+    private parser;
+    constructor(config: XRequestConfig);
+    create(params: Record<string, unknown>, callbacks: XRequestCallbacks): Promise<void>;
+    abort(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=XRequest.d.ts.map

package/lib/typescript/module/tools/XRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XRequest.d.ts","sourceRoot":"","sources":["../../../../src/tools/XRequest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAGjD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACtC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,cAAc;IAI5B,MAAM,CACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,IAAI,CAAC;IA0DhB,KAAK,IAAI,IAAI;IAOb,OAAO,IAAI,IAAI;CAGhB"}

package/lib/typescript/module/tools/XStream.d.ts

@@ -0,0 +1,34 @@
+/**
+ * XStream — SSE 流适配器（React Native 版本）
+ *
+ * 基于 react-native-sse 封装，支持 POST 方法 + 自定义请求体
+ */
+import type { SSEOutput } from '../types/provider';
+export interface XStreamConfig {
+    url: string;
+    method?: 'GET' | 'POST';
+    headers?: Record<string, string>;
+    body?: Record<string, unknown>;
+    timeout?: number;
+    transformStream?: (event: {
+        data: string;
+        event?: string;
+    }) => SSEOutput;
+}
+export interface XStreamCallbacks {
+    onMessage: (data: SSEOutput) => void;
+    onError?: (error: Error) => void;
+    onComplete?: () => void;
+    onOpen?: () => void;
+}
+export declare class XStream {
+    private config;
+    private es;
+    private timeoutTimer;
+    constructor(config: XStreamConfig);
+    connect(callbacks: XStreamCallbacks): void;
+    abort(): void;
+    dispose(): void;
+    private clearTimer;
+}
+//# sourceMappingURL=XStream.d.ts.map

package/lib/typescript/module/tools/XStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XStream.d.ts","sourceRoot":"","sources":["../../../../src/tools/XStream.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,SAAS,CAAC;CAC1E;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAUD,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,YAAY,CAA8C;gBAEtD,MAAM,EAAE,aAAa;IAIjC,OAAO,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAmD1C,KAAK,IAAI,IAAI;IAQb,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,UAAU;CAMnB"}

package/lib/typescript/module/types/message.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Chat 消息类型定义
+ */
+export type MessageRole = 'user' | 'assistant' | 'system';
+export type MessageType = 'text' | 'card' | 'system';
+export type MessageStatus = 'local' | 'loading' | 'updating' | 'success' | 'error' | 'abort';
+export interface ChatMessage {
+    id: string;
+    text: string;
+    role: MessageRole;
+    createdAt: Date;
+    messageType: MessageType;
+    status: MessageStatus;
+    cardType?: string;
+    cardData?: {
+        data: Record<string, unknown>;
+        actions: string[];
+    };
+    turnId: string;
+    extra?: Record<string, unknown>;
+}
+//# sourceMappingURL=message.d.ts.map

package/lib/typescript/module/types/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../../src/types/message.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AACrD,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,SAAS,GACT,UAAU,GACV,SAAS,GACT,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC"}

package/lib/typescript/module/types/provider.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Provider 协议类型
+ * 定义 ChatProvider ↔ useXChat 之间的数据契约
+ */
+import type { ChatMessage } from './message';
+import type { SuggestionItem } from './sse';
+export interface RequestParams<T = ChatMessage> {
+    message: T;
+    messages?: T[];
+    model?: string;
+    extra?: Record<string, unknown>;
+}
+export interface SSEOutput {
+    data: string;
+    event?: string;
+}
+export interface ProviderCallbacks<Message = ChatMessage> {
+    onUpdate: (message: Message) => void;
+    onSuccess: (message: Message) => void;
+    onError: (error: Error) => void;
+    onSuggestion?: (items: SuggestionItem[]) => void;
+}
+//# sourceMappingURL=provider.d.ts.map

package/lib/typescript/module/types/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/types/provider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,OAAO,CAAC;AAE1C,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,WAAW;IAC5C,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB,CAAC,OAAO,GAAG,WAAW;IACtD,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAChC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;CAClD"}

package/lib/typescript/module/types/sse.d.ts

@@ -0,0 +1,63 @@
+/**
+ * SSEEnvelope 协议类型定义
+ */
+export type SSEEventType = 'text' | 'card_data' | 'suggestion' | 'error' | 'done';
+export interface SSEEnvelopeBase {
+    event_id: string;
+    turn_id: string;
+    seq: number;
+    ts: string;
+    session_id: string;
+}
+export interface SSETextEvent extends SSEEnvelopeBase {
+    type: 'text';
+    payload: {
+        content: string;
+    };
+}
+export interface SSECardDataEvent extends SSEEnvelopeBase {
+    type: 'card_data';
+    payload: {
+        cardType: string;
+        payload: CardPayload;
+    };
+}
+export interface SSESuggestionEvent extends SSEEnvelopeBase {
+    type: 'suggestion';
+    payload: {
+        items: SuggestionItem[];
+    };
+}
+export interface SSEErrorEvent extends SSEEnvelopeBase {
+    type: 'error';
+    payload: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        recover_actions?: ActionPayload[];
+    };
+}
+export interface SSEDoneEvent extends SSEEnvelopeBase {
+    type: 'done';
+    payload: {
+        messageId: string;
+        reason: 'ok' | 'abort' | 'error';
+    };
+}
+export type SSEEnvelope = SSETextEvent | SSECardDataEvent | SSESuggestionEvent | SSEErrorEvent | SSEDoneEvent;
+export interface SuggestionItem {
+    id: string;
+    label: string;
+    action?: ActionPayload;
+    mode?: 'action' | 'input_focus';
+}
+export type ActionType = 'confirm_order' | 'select_product' | 'reorder' | 'add_product' | 'clear_draft' | 'push_dealer' | 'new_order' | 'view_detail' | 'add_to_order' | 'browse_products' | 'retry_order';
+export interface ActionPayload {
+    type: ActionType;
+    payload?: Record<string, unknown>;
+}
+export interface CardPayload {
+    data: Record<string, unknown>;
+    actions: string[];
+}
+//# sourceMappingURL=sse.d.ts.map

package/lib/typescript/module/types/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../../src/types/sse.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,WAAW,GACX,YAAY,GACZ,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,WAAW,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE;QACP,KAAK,EAAE,cAAc,EAAE,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;QACnB,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;KACnC,CAAC;CACH;AAED,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;KAClC,CAAC;CACH;AAED,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,gBAAgB,GAChB,kBAAkB,GAClB,aAAa,GACb,YAAY,CAAC;AAEjB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,IAAI,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;CACjC;AAED,MAAM,MAAM,UAAU,GAClB,eAAe,GACf,gBAAgB,GAChB,SAAS,GACT,aAAa,GACb,aAAa,GACb,aAAa,GACb,WAAW,GACX,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,aAAa,CAAC;AAElB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/package.json

@@ -1,14 +1,24 @@
 {
   "name": "@unif/react-native-chat-sdk",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "UNIF React Native Chat SDK — 流式通信、Provider、状态管理",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./lib/commonjs/index.js",
+  "module": "./lib/module/index.js",
+  "types": "./lib/typescript/commonjs/index.d.ts",
+  "react-native": "./src/index.ts",
+  "source": "./src/index.ts",
   "exports": {
     ".": {
       "source": "./src/index.ts",
-      "types": "./src/index.ts",
-      "default": "./src/index.ts"
+      "react-native": "./src/index.ts",
+      "import": {
+        "types": "./lib/typescript/module/index.d.ts",
+        "default": "./lib/module/index.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/index.d.ts",
+        "default": "./lib/commonjs/index.js"
+      }
     },
     "./package.json": "./package.json"
   },
@@ -22,14 +32,25 @@
   "scripts": {
     "build": "bob build",
     "clean": "del-cli lib",
+    "prepublishOnly": "bob build",
     "typecheck": "tsc"
   },
-  "keywords": ["react-native", "chat", "sdk", "sse", "streaming"],
+  "keywords": [
+    "react-native",
+    "chat",
+    "sdk",
+    "sse",
+    "streaming"
+  ],
   "author": "qq382724935 <liulijun@pec.com.cn>",
   "license": "MIT",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },
+  "devDependencies": {
+    "react-native-sse": "^1.2.1",
+    "typescript": "^5.9.2"
+  },
   "dependencies": {
     "zustand": "^4.5.0"
   },
@@ -42,8 +63,19 @@
     "source": "src",
     "output": "lib",
     "targets": [
-      ["module", { "esm": true }],
-      ["typescript", { "project": "tsconfig.build.json" }]
+      "commonjs",
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
     ]
   }
 }

package/src/hooks/ChatProvider.tsx

@@ -39,10 +39,23 @@ interface ChatContextValue<Message = ChatMessage> {
   suggestions: SuggestionItem[];
   error: string | null;
   onRequest: (input: unknown) => void;
+  onReload: (id: string, input: unknown) => void;
   abort: () => void;
   resetChat: () => void;
   loadSession: (messages: ChatMessage[]) => void;
   clearError: () => void;
+  setMessages: (
+    messages:
+      | MessageInfo<Message>[]
+      | ((prev: MessageInfo<Message>[]) => MessageInfo<Message>[]),
+  ) => void;
+  setMessage: (
+    id: string,
+    partial:
+      | Partial<MessageInfo<Message>>
+      | ((msg: MessageInfo<Message>) => Partial<MessageInfo<Message>>),
+  ) => void;
+  removeMessage: (id: string) => void;
   // useXConversations
   sessions: SessionSummary[];
   activeId: string;
@@ -107,7 +120,7 @@ export function ChatProvider<
 
   const model = useXModel({ models, defaultModel });
 
-  const value: ChatContextValue<Message> = useMemo(
+  const value = useMemo(
     () => ({
       ...chat,
       ...conversations,

package/src/hooks/useXChat.ts

@@ -38,15 +38,25 @@ export interface UseXChatReturn<
   suggestions: SuggestionItem[];
   error: string | null;
   onRequest: (input: Input) => void;
+  onReload: (id: string, input: Input) => void;
   abort: () => void;
   resetChat: () => void;
   loadSession: (messages: ChatMessage[]) => void;
   clearError: () => void;
+  setMessages: (
+    messages:
+      | MessageInfo<Message>[]
+      | ((prev: MessageInfo<Message>[]) => MessageInfo<Message>[]),
+  ) => void;
+  setMessage: (
+    id: string,
+    partial:
+      | Partial<MessageInfo<Message>>
+      | ((msg: MessageInfo<Message>) => Partial<MessageInfo<Message>>),
+  ) => void;
+  removeMessage: (id: string) => void;
 }
 
-let _idCounter = 0;
-const defaultGenId = () => `xc-${Date.now()}-${++_idCounter}`;
-
 export function useXChat<
   Message = ChatMessage,
   Input = RequestParams<Message>,
@@ -54,7 +64,7 @@ export function useXChat<
 >(
   config: UseXChatConfig<Message, Input, Output>
 ): UseXChatReturn<Message, Input> {
-  const { provider, generateId = defaultGenId } = config;
+  const { provider } = config;
 
   const storeRef = useRef(createChatStore());
   const store = storeRef.current;
@@ -131,6 +141,117 @@ export function useXChat<
     store.getState().setError(null);
   }, [store]);
 
+  const onReload = useCallback(
+    (id: string, input: Input) => {
+      const s = store.getState();
+      if (s.isRequesting) return;
+
+      // 将目标消息标记为 loading，移除其后的 assistant 消息
+      const targetIdx = s.messages.findIndex((m) => m.id === id);
+      if (targetIdx < 0) return;
+
+      store.getState().setRequesting(true);
+      store.getState().setError(null);
+      store.getState().setSuggestions([]);
+
+      provider.sendMessage(input, {
+        onUpdate: (message) => {
+          store
+            .getState()
+            .upsertMessage(message as unknown as ChatMessage);
+        },
+        onSuccess: (message) => {
+          const m = message as unknown as ChatMessage;
+          store.getState().upsertMessage({
+            ...m,
+            status: 'success',
+          });
+          store.getState().setRequesting(false);
+        },
+        onError: (error) => {
+          store.getState().setError(error.message);
+          store.getState().setRequesting(false);
+
+          if (config.requestFallback) {
+            const fallbackMsg = config.requestFallback(input, { error });
+            store
+              .getState()
+              .addMessage(fallbackMsg as unknown as ChatMessage);
+          }
+        },
+        onSuggestion: (items) => {
+          store.getState().setSuggestions(items);
+        },
+      });
+    },
+    [provider, store, config]
+  );
+
+  const setMessages = useCallback(
+    (
+      messagesOrFn:
+        | MessageInfo<Message>[]
+        | ((prev: MessageInfo<Message>[]) => MessageInfo<Message>[]),
+    ) => {
+      if (typeof messagesOrFn === 'function') {
+        const current = store.getState().messages;
+        const currentInfos: MessageInfo<Message>[] = current.map((m) => ({
+          id: m.id,
+          message: m as unknown as Message,
+          status: m.status,
+          extra: m.extra as Record<string, unknown> | undefined,
+        }));
+        const next = messagesOrFn(currentInfos);
+        store
+          .getState()
+          .setMessages(next.map((info) => info.message as unknown as ChatMessage));
+      } else {
+        store
+          .getState()
+          .setMessages(
+            messagesOrFn.map((info) => info.message as unknown as ChatMessage),
+          );
+      }
+    },
+    [store]
+  );
+
+  const setMessage = useCallback(
+    (
+      id: string,
+      partialOrFn:
+        | Partial<MessageInfo<Message>>
+        | ((msg: MessageInfo<Message>) => Partial<MessageInfo<Message>>),
+    ) => {
+      store.getState().setMessage(id, (m) => {
+        const info: MessageInfo<Message> = {
+          id: m.id,
+          message: m as unknown as Message,
+          status: m.status,
+          extra: m.extra as Record<string, unknown> | undefined,
+        };
+        const partial =
+          typeof partialOrFn === 'function' ? partialOrFn(info) : partialOrFn;
+        const updated: Partial<ChatMessage> = {};
+        if (partial.message !== undefined) {
+          Object.assign(updated, partial.message);
+        }
+        if (partial.status !== undefined) {
+          updated.status = partial.status;
+        }
+        return updated;
+      });
+    },
+    [store]
+  );
+
+  const removeMessage = useCallback(
+    (id: string) => {
+      store.getState().removeMessage(id);
+    },
+    [store]
+  );
+
   useEffect(() => {
     return () => {
       provider.abort();
@@ -150,9 +271,13 @@ export function useXChat<
     suggestions: state.suggestions,
     error: state.error,
     onRequest,
+    onReload,
     abort,
     resetChat,
     loadSession,
     clearError,
+    setMessages,
+    setMessage,
+    removeMessage,
   };
 }

package/src/stores/chatStore.ts

@@ -17,6 +17,18 @@ interface ChatState {
   addMessage: (message: ChatMessage) => void;
   updateMessage: (id: string, updater: (msg: ChatMessage) => ChatMessage) => void;
   upsertMessage: (message: ChatMessage) => void;
+  setMessages: (
+    messages:
+      | ChatMessage[]
+      | ((prev: ChatMessage[]) => ChatMessage[]),
+  ) => void;
+  setMessage: (
+    id: string,
+    partial:
+      | Partial<ChatMessage>
+      | ((msg: ChatMessage) => Partial<ChatMessage>),
+  ) => void;
+  removeMessage: (id: string) => void;
   setSuggestions: (items: SuggestionItem[]) => void;
   setRequesting: (v: boolean) => void;
   setError: (error: string | null) => void;
@@ -55,6 +67,29 @@ export const createChatStore = () =>
       }
     },
 
+    setMessages: (messagesOrFn) =>
+      set((state) => ({
+        messages:
+          typeof messagesOrFn === 'function'
+            ? messagesOrFn(state.messages)
+            : messagesOrFn,
+      })),
+
+    setMessage: (id, partialOrFn) =>
+      set((state) => ({
+        messages: state.messages.map((m) => {
+          if (m.id !== id) return m;
+          const partial =
+            typeof partialOrFn === 'function' ? partialOrFn(m) : partialOrFn;
+          return { ...m, ...partial };
+        }),
+      })),
+
+    removeMessage: (id) =>
+      set((state) => ({
+        messages: state.messages.filter((m) => m.id !== id),
+      })),
+
     setSuggestions: (items) => set({ suggestions: items }),
     setRequesting: (v) => set({ isRequesting: v }),
     setError: (error) => set({ error }),