@unif/react-native-chat-sdk 0.1.0 → 0.1.2

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.0",
+  "version": "0.1.2",
   "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

@@ -37,8 +37,12 @@ interface ChatContextValue<Message = ChatMessage> {
   messages: MessageInfo<Message>[];
   requesting: boolean;
   suggestions: SuggestionItem[];
+  error: string | null;
   onRequest: (input: unknown) => void;
   abort: () => void;
+  resetChat: () => void;
+  loadSession: (messages: ChatMessage[]) => void;
+  clearError: () => void;
   // useXConversations
   sessions: SessionSummary[];
   activeId: string;
@@ -54,7 +58,6 @@ interface ChatContextValue<Message = ChatMessage> {
 
 const ChatContext = createContext<ChatContextValue | null>(null);
 
-// 内存存储 fallback（无 storage 时使用）
 const memoryStorage: ChatStorage = {
   _data: new Map<string, string>(),
   async getItem(key: string) {
@@ -104,7 +107,7 @@ export function ChatProvider<
 
   const model = useXModel({ models, defaultModel });
 
-  const value: ChatContextValue<Message> = useMemo(
+  const value = useMemo(
     () => ({
       ...chat,
       ...conversations,

package/src/hooks/useXChat.ts

@@ -4,7 +4,7 @@
  * 消费 ChatProvider，输出可渲染的 messages 列表
  */
 
-import {useCallback, useEffect, useRef} from 'react';
+import {useCallback, useEffect, useRef, useSyncExternalStore} from 'react';
 import {createChatStore} from '../stores/chatStore';
 import type {AbstractChatProvider} from '../providers/AbstractChatProvider';
 import type {ChatMessage, MessageStatus} from '../types/message';
@@ -36,13 +36,14 @@ export interface UseXChatReturn<
   messages: MessageInfo<Message>[];
   requesting: boolean;
   suggestions: SuggestionItem[];
+  error: string | null;
   onRequest: (input: Input) => void;
   abort: () => void;
+  resetChat: () => void;
+  loadSession: (messages: ChatMessage[]) => void;
+  clearError: () => void;
 }
 
-let _idCounter = 0;
-const defaultGenId = () => `xc-${Date.now()}-${++_idCounter}`;
-
 export function useXChat<
   Message = ChatMessage,
   Input = RequestParams<Message>,
@@ -50,32 +51,30 @@ 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;
 
-  // 订阅 store 变化
-  const state = store.getState();
-
-  // 同步最新值（组件级别使用 zustand subscribe 或 useSyncExternalStore）
-  // 简化实现：直接用 store.getState()
-  const getState = useCallback(() => store.getState(), [store]);
+  // 使用 useSyncExternalStore 订阅 zustand store 变化
+  const state = useSyncExternalStore(
+    store.subscribe,
+    store.getState,
+    store.getState,
+  );
 
   const onRequest = useCallback(
     (input: Input) => {
-      const s = getState();
-      if (s.isRequesting) return; // 请求去重
+      const s = store.getState();
+      if (s.isRequesting) return;
 
       store.getState().setRequesting(true);
       store.getState().setError(null);
       store.getState().setSuggestions([]);
 
-      // 添加用户本地消息
       const localMessage = provider.transformLocalMessage(input);
       store.getState().addMessage(localMessage as unknown as ChatMessage);
 
-      // 发起请求
       provider.sendMessage(input, {
         onUpdate: (message) => {
           store
@@ -101,9 +100,12 @@ export function useXChat<
               .addMessage(fallbackMsg as unknown as ChatMessage);
           }
         },
+        onSuggestion: (items) => {
+          store.getState().setSuggestions(items);
+        },
       });
     },
-    [provider, getState, store, config]
+    [provider, store, config]
   );
 
   const abort = useCallback(() => {
@@ -111,14 +113,27 @@ export function useXChat<
     store.getState().setRequesting(false);
   }, [provider, store]);
 
-  // 清理
+  const resetChat = useCallback(() => {
+    store.getState().resetChat();
+  }, [store]);
+
+  const loadSession = useCallback(
+    (messages: ChatMessage[]) => {
+      store.getState().loadSession(messages);
+    },
+    [store]
+  );
+
+  const clearError = useCallback(() => {
+    store.getState().setError(null);
+  }, [store]);
+
   useEffect(() => {
     return () => {
       provider.abort();
     };
   }, [provider]);
 
-  // 转换为 MessageInfo 格式
   const messages: MessageInfo<Message>[] = state.messages.map((m) => ({
     id: m.id,
     message: m as unknown as Message,
@@ -130,7 +145,11 @@ export function useXChat<
     messages,
     requesting: state.isRequesting,
     suggestions: state.suggestions,
+    error: state.error,
     onRequest,
     abort,
+    resetChat,
+    loadSession,
+    clearError,
   };
 }

package/src/index.ts

@@ -20,6 +20,7 @@ export type {
   SSEErrorEvent,
   SSEDoneEvent,
   SSEEnvelope,
+  SuggestionItem,
 } from './types/sse';
 
 export type {
@@ -49,7 +50,7 @@ export type {ChatStorage} from './stores/storage';
 
 // Hooks
 export {useXChat} from './hooks/useXChat';
-export type {UseXChatConfig, MessageInfo} from './hooks/useXChat';
+export type {UseXChatConfig, UseXChatReturn, MessageInfo} from './hooks/useXChat';
 
 export {useXConversations} from './hooks/useXConversations';
 export type {UseXConversationsOptions, SessionSummary} from './hooks/useXConversations';

package/src/tools/XRequest.ts

@@ -7,6 +7,7 @@
 import {XStream} from './XStream';
 import {SSEParser} from './SSEParser';
 import type {SSEOutput} from '../types/provider';
+import type {SSEEnvelope} from '../types/sse';
 
 export interface XRequestConfig {
   baseURL: string;
@@ -49,11 +50,12 @@ export class XRequest {
     } = this.config;
 
     // 注入 auth token
+    const reqHeaders = {...headers};
     if (getToken) {
       try {
         const token = await getToken();
         if (token) {
-          headers['Authorization'] = `Bearer ${token}`;
+          reqHeaders['Authorization'] = `Bearer ${token}`;
         }
       } catch {
         // token 获取失败，继续无认证请求
@@ -65,14 +67,21 @@ export class XRequest {
     this.stream = new XStream({
       url,
       method: 'POST',
-      headers,
+      headers: reqHeaders,
       body: params,
       timeout,
     });
 
     this.stream.connect({
       onMessage: (output: SSEOutput) => {
-        callbacks.onStream?.(output);
+        // 通过 SSEParser 进行幂等去重和排序
+        const envelopes: SSEEnvelope[] = this.parser.process(output.data);
+        for (const envelope of envelopes) {
+          callbacks.onStream?.({
+            data: JSON.stringify(envelope),
+            event: envelope.type,
+          });
+        }
       },
       onError: (error: Error) => {
         callbacks.onError?.({

package/src/types/provider.ts

@@ -4,6 +4,7 @@
  */
 
 import type {ChatMessage} from './message';
+import type {SuggestionItem} from './sse';
 
 export interface RequestParams<T = ChatMessage> {
   message: T;
@@ -21,4 +22,5 @@ export interface ProviderCallbacks<Message = ChatMessage> {
   onUpdate: (message: Message) => void;
   onSuccess: (message: Message) => void;
   onError: (error: Error) => void;
+  onSuggestion?: (items: SuggestionItem[]) => void;
 }