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

package/README.md

@@ -0,0 +1,252 @@
+# @unif/react-native-chat-sdk
+
+AI 聊天 SDK — 流式通信、Provider 模式、状态管理，参考 [Ant Design X SDK](https://ant-design-x.antgroup.com/x-sdks/introduce) 架构设计。
+
+## 安装
+
+```bash
+yarn add @unif/react-native-chat-sdk
+```
+
+### peerDependencies
+
+```bash
+yarn add react react-native react-native-sse
+```
+
+## 架构
+
+```
+┌──────────────────────────────────────────┐
+│            useXChat (Hook)               │
+│  组合 Provider + store，输出 messages    │
+├──────────────────────────────────────────┤
+│           ChatProvider 层                │
+│  AbstractChatProvider → OpenAI/DeepSeek  │
+├──────────────────────────────────────────┤
+│              工具层                      │
+│  XRequest + XStream + SSEParser          │
+└──────────────────────────────────────────┘
+```
+
+## 快速开始
+
+### 方式一：ChatProvider 全局模式
+
+```tsx
+import {
+  ChatProvider,
+  useChatContext,
+  OpenAIChatProvider,
+  XRequest,
+} from '@unif/react-native-chat-sdk';
+import AsyncStorage from '@react-native-async-storage/async-storage';
+
+const request = new XRequest({
+  baseURL: 'https://api.openai.com',
+  getToken: async () => 'sk-...',
+});
+const provider = new OpenAIChatProvider({request, model: 'gpt-4o'});
+
+function App() {
+  return (
+    <ChatProvider provider={provider} storage={AsyncStorage}>
+      <ChatScreen />
+    </ChatProvider>
+  );
+}
+
+function ChatScreen() {
+  const {messages, onRequest, requesting, abort} = useChatContext();
+  // 使用 messages 渲染列表，onRequest 发送消息...
+}
+```
+
+### 方式二：直接使用 Hooks
+
+```tsx
+import {useXChat, useXConversations, useXModel} from '@unif/react-native-chat-sdk';
+
+function ChatScreen() {
+  const {messages, onRequest, abort, requesting} = useXChat({provider});
+  const {sessions, switchSession, newSession} = useXConversations({storage: AsyncStorage});
+  const {selectedModel, setSelectedModel} = useXModel({models: MODELS});
+}
+```
+
+## API
+
+### Hooks
+
+#### useXChat
+
+聊天操作核心 hook，消费 Provider 输出可渲染 messages。
+
+```typescript
+const {
+  messages,      // MessageInfo[] — 可渲染消息列表
+  requesting,    // boolean — 是否请求中
+  suggestions,   // SuggestionItem[] — 建议提示
+  error,         // string | null — 错误信息
+  onRequest,     // (input) => void — 发起请求
+  abort,         // () => void — 中止请求
+  resetChat,     // () => void — 重置聊天
+  loadSession,   // (messages) => void — 加载历史会话
+  clearError,    // () => void — 清除错误
+} = useXChat({provider});
+```
+
+#### useXConversations
+
+会话管理 hook，组合 session + history。
+
+```typescript
+const {
+  sessions,        // SessionSummary[]
+  activeId,        // string
+  switchSession,   // (id) => Promise<ChatMessage[]>
+  newSession,      // () => void
+  deleteSession,   // (id) => Promise<void>
+  archiveSession,  // (id, title, messages) => Promise<void>
+} = useXConversations({storage: AsyncStorage});
+```
+
+#### useXModel
+
+模型选择 hook。
+
+```typescript
+const {
+  selectedModel,     // string
+  models,            // ModelInfo[]
+  setSelectedModel,  // (id) => void
+} = useXModel({models: AVAILABLE_MODELS, defaultModel: 'gpt-4o'});
+```
+
+### Providers
+
+#### AbstractChatProvider
+
+抽象基类，自定义 Provider 需继承并实现 3 个方法：
+
+```typescript
+class MyProvider extends AbstractChatProvider {
+  // 将 useXChat.onRequest() 参数转为 HTTP 请求体
+  transformParams(input: RequestParams): Record<string, unknown>;
+
+  // 创建用户本地消息（立即显示在列表中）
+  transformLocalMessage(input: RequestParams): ChatMessage;
+
+  // 将 SSE 流数据转为 assistant 消息（流式累积）
+  transformMessage(output: SSEOutput, current?: ChatMessage): ChatMessage;
+}
+```
+
+#### OpenAIChatProvider
+
+OpenAI 兼容 Provider，支持所有 OpenAI 标准 API。
+
+```typescript
+const provider = new OpenAIChatProvider({
+  baseURL: 'https://api.openai.com',
+  model: 'gpt-4o',
+  getToken: async () => apiKey,
+});
+```
+
+#### DeepSeekChatProvider
+
+DeepSeek Provider，继承 OpenAI，额外处理 `reasoning_content`。
+
+```typescript
+const provider = new DeepSeekChatProvider({
+  model: 'deepseek-chat',
+  getToken: async () => apiKey,
+});
+```
+
+### Tools
+
+#### XStream
+
+SSE 流适配器，基于 `react-native-sse` 的 RN 原生实现。
+
+```typescript
+const stream = new XStream({
+  url: 'https://api.example.com/stream',
+  method: 'POST',
+  body: {message: 'hello'},
+  timeout: 120000,
+});
+
+stream.connect({
+  onMessage: (output) => console.log(output.data),
+  onError: (err) => console.error(err),
+  onComplete: () => console.log('done'),
+});
+```
+
+#### XRequest
+
+面向 LLM 的 HTTP 请求工具，组合 XStream + SSEParser。
+
+```typescript
+const request = new XRequest({
+  baseURL: 'https://api.example.com',
+  endpoint: '/v1/chat/completions',
+  getToken: async () => token,
+});
+
+await request.create(params, {
+  onStream: (chunk) => handleChunk(chunk),
+  onSuccess: () => handleDone(),
+  onError: (err) => handleError(err),
+});
+```
+
+#### SSEParser
+
+SSE 解析器，event_id 幂等去重 + seq 严格排序。
+
+```typescript
+const parser = new SSEParser();
+parser.reset(); // 每轮对话重置
+
+const envelopes = parser.process(rawData); // 返回排序后的事件数组
+```
+
+### Types
+
+```typescript
+// 消息类型
+interface ChatMessage {
+  id: string;
+  text: string;
+  role: 'user' | 'assistant' | 'system';
+  status: 'local' | 'loading' | 'updating' | 'success' | 'error' | 'abort';
+  messageType: 'text' | 'card' | 'system';
+  createdAt: Date;
+  turnId: string;
+  cardType?: string;
+  cardData?: { data: Record<string, unknown>; actions: string[] };
+  extra?: Record<string, unknown>;
+}
+
+// 存储抽象
+interface ChatStorage {
+  getItem: (key: string) => Promise<string | null>;
+  setItem: (key: string, value: string) => Promise<void>;
+  removeItem: (key: string) => Promise<void>;
+}
+```
+
+## 兼容性
+
+| @unif/react-native-chat-sdk | React Native | React | 状态 |
+|-----------------------------|-------------|-------|------|
+| 0.1.x | >= 0.71 | >= 18 | ✅ |
+| 0.1.x | 0.74.x | 18.x | ✅ 已验证（PECPortal） |
+
+## 许可证
+
+MIT

package/lib/commonjs/hooks/ChatProvider.js

@@ -0,0 +1,76 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ChatProvider = ChatProvider;
+exports.useChatContext = useChatContext;
+var _react = _interopRequireWildcard(require("react"));
+var _useXChat = require("./useXChat");
+var _useXConversations = require("./useXConversations");
+var _useXModel = require("./useXModel");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * ChatProvider — 全局数据提供 Context
+ *
+ * 可选的全局 Provider 模式（也可直接使用 hooks）
+ */
+
+const ChatContext = /*#__PURE__*/(0, _react.createContext)(null);
+const memoryStorage = {
+  _data: new Map(),
+  async getItem(key) {
+    return this._data.get(key) ?? null;
+  },
+  async setItem(key, value) {
+    this._data.set(key, value);
+  },
+  async removeItem(key) {
+    this._data.delete(key);
+  }
+};
+function ChatProvider(props) {
+  const {
+    provider,
+    storage,
+    models = [],
+    defaultModel,
+    generateId,
+    requestPlaceholder,
+    requestFallback,
+    children
+  } = props;
+  const chatConfig = (0, _react.useMemo)(() => ({
+    provider,
+    generateId,
+    requestPlaceholder,
+    requestFallback
+  }), [provider, generateId, requestPlaceholder, requestFallback]);
+  const chat = (0, _useXChat.useXChat)(chatConfig);
+  const convOptions = (0, _react.useMemo)(() => ({
+    storage: storage ?? memoryStorage
+  }), [storage]);
+  const conversations = (0, _useXConversations.useXConversations)(convOptions);
+  const model = (0, _useXModel.useXModel)({
+    models,
+    defaultModel
+  });
+  const value = (0, _react.useMemo)(() => ({
+    ...chat,
+    ...conversations,
+    ...model
+  }), [chat, conversations, model]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(ChatContext.Provider, {
+    value: value,
+    children: children
+  });
+}
+function useChatContext() {
+  const ctx = (0, _react.useContext)(ChatContext);
+  if (!ctx) {
+    throw new Error('useChatContext must be used within a ChatProvider');
+  }
+  return ctx;
+}
+//# sourceMappingURL=ChatProvider.js.map

package/lib/commonjs/hooks/ChatProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireWildcard","require","_useXChat","_useXConversations","_useXModel","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","ChatContext","createContext","memoryStorage","_data","Map","getItem","key","setItem","value","removeItem","delete","ChatProvider","props","provider","storage","models","defaultModel","generateId","requestPlaceholder","requestFallback","children","chatConfig","useMemo","chat","useXChat","convOptions","conversations","useXConversations","model","useXModel","jsx","Provider","useChatContext","ctx","useContext","Error"],"sourceRoot":"../../../src","sources":["hooks/ChatProvider.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/hooks/useXChat.js

@@ -0,0 +1,95 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useXChat = useXChat;
+var _react = require("react");
+var _chatStore = require("../stores/chatStore");
+/**
+ * useXChat — 聊天操作 hook
+ *
+ * 消费 ChatProvider，输出可渲染的 messages 列表
+ */
+
+function useXChat(config) {
+  const {
+    provider
+  } = config;
+  const storeRef = (0, _react.useRef)((0, _chatStore.createChatStore)());
+  const store = storeRef.current;
+
+  // 使用 useSyncExternalStore 订阅 zustand store 变化
+  const state = (0, _react.useSyncExternalStore)(store.subscribe, store.getState, store.getState);
+  const onRequest = (0, _react.useCallback)(input => {
+    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);
+    provider.sendMessage(input, {
+      onUpdate: message => {
+        store.getState().upsertMessage(message);
+      },
+      onSuccess: message => {
+        const m = message;
+        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);
+        }
+      },
+      onSuggestion: items => {
+        store.getState().setSuggestions(items);
+      }
+    });
+  }, [provider, store, config]);
+  const abort = (0, _react.useCallback)(() => {
+    provider.abort();
+    store.getState().setRequesting(false);
+  }, [provider, store]);
+  const resetChat = (0, _react.useCallback)(() => {
+    store.getState().resetChat();
+  }, [store]);
+  const loadSession = (0, _react.useCallback)(messages => {
+    store.getState().loadSession(messages);
+  }, [store]);
+  const clearError = (0, _react.useCallback)(() => {
+    store.getState().setError(null);
+  }, [store]);
+  (0, _react.useEffect)(() => {
+    return () => {
+      provider.abort();
+    };
+  }, [provider]);
+  const messages = state.messages.map(m => ({
+    id: m.id,
+    message: m,
+    status: m.status,
+    extra: m.extra
+  }));
+  return {
+    messages,
+    requesting: state.isRequesting,
+    suggestions: state.suggestions,
+    error: state.error,
+    onRequest,
+    abort,
+    resetChat,
+    loadSession,
+    clearError
+  };
+}
+//# sourceMappingURL=useXChat.js.map

package/lib/commonjs/hooks/useXChat.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_chatStore","useXChat","config","provider","storeRef","useRef","createChatStore","store","current","state","useSyncExternalStore","subscribe","getState","onRequest","useCallback","input","s","isRequesting","setRequesting","setError","setSuggestions","localMessage","transformLocalMessage","addMessage","sendMessage","onUpdate","message","upsertMessage","onSuccess","m","status","onError","error","requestFallback","fallbackMsg","onSuggestion","items","abort","resetChat","loadSession","messages","clearError","useEffect","map","id","extra","requesting","suggestions"],"sourceRoot":"../../../src","sources":["hooks/useXChat.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/hooks/useXConversations.js

@@ -0,0 +1,69 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useXConversations = useXConversations;
+var _react = require("react");
+var _historyStore = require("../stores/historyStore");
+/**
+ * useXConversations — 会话管理 hook
+ *
+ * 组合 sessionStore + historyStore，管理会话生命周期
+ */
+
+function useXConversations(options) {
+  const {
+    storage
+  } = options;
+  const historyRef = (0, _react.useRef)((0, _historyStore.createHistoryStore)(storage));
+  const history = historyRef.current;
+  const [sessions, setSessions] = (0, _react.useState)(history.sessions);
+  const [activeId, setActiveId] = (0, _react.useState)('');
+
+  // 初始化加载
+  (0, _react.useEffect)(() => {
+    // 触发 loadIndex
+    history.archiveSession('__init__', '', []).then(() => {
+      history.deleteSession('__init__').then(() => {
+        setSessions([...history.sessions]);
+      });
+    });
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+  const switchSession = (0, _react.useCallback)(async id => {
+    setActiveId(id);
+    return await history.loadSessionMessages(id);
+  }, [history]);
+  const newSession = (0, _react.useCallback)(() => {
+    setActiveId('');
+  }, []);
+  const deleteSession = (0, _react.useCallback)(async id => {
+    await history.deleteSession(id);
+    setSessions([...history.sessions]);
+    if (activeId === id) {
+      setActiveId('');
+    }
+  }, [history, activeId]);
+  const archiveSession = (0, _react.useCallback)(async (id, title, messages) => {
+    await history.archiveSession(id, title, messages);
+    setSessions([...history.sessions]);
+  }, [history]);
+  const updateSession = (0, _react.useCallback)((id, data) => {
+    const session = history.sessions.find(s => s.id === id);
+    if (session && data.title) {
+      session.title = data.title;
+      setSessions([...history.sessions]);
+    }
+  }, [history]);
+  return {
+    sessions,
+    activeId,
+    switchSession,
+    newSession,
+    deleteSession,
+    archiveSession,
+    updateSession
+  };
+}
+//# sourceMappingURL=useXConversations.js.map

package/lib/commonjs/hooks/useXConversations.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_historyStore","useXConversations","options","storage","historyRef","useRef","createHistoryStore","history","current","sessions","setSessions","useState","activeId","setActiveId","useEffect","archiveSession","then","deleteSession","switchSession","useCallback","id","loadSessionMessages","newSession","title","messages","updateSession","data","session","find","s"],"sourceRoot":"../../../src","sources":["hooks/useXConversations.ts"],"mappings":";;;;;;AAMA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,aAAA,GAAAD,OAAA;AAPA;AACA;AACA;AACA;AACA;;AAcO,SAASE,iBAAiBA,CAACC,OAAiC,EAAE;EACnE,MAAM;IAACC;EAAO,CAAC,GAAGD,OAAO;EAEzB,MAAME,UAAU,GAAG,IAAAC,aAAM,EAAC,IAAAC,gCAAkB,EAACH,OAAO,CAAC,CAAC;EACtD,MAAMI,OAAO,GAAGH,UAAU,CAACI,OAAO;EAElC,MAAM,CAACC,QAAQ,EAAEC,WAAW,CAAC,GAAG,IAAAC,eAAQ,EAACJ,OAAO,CAACE,QAAQ,CAAC;EAC1D,MAAM,CAACG,QAAQ,EAAEC,WAAW,CAAC,GAAG,IAAAF,eAAQ,EAAC,EAAE,CAAC;;EAE5C;EACA,IAAAG,gBAAS,EAAC,MAAM;IACd;IACAP,OAAO,CAACQ,cAAc,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAACC,IAAI,CAAC,MAAM;MACpDT,OAAO,CAACU,aAAa,CAAC,UAAU,CAAC,CAACD,IAAI,CAAC,MAAM;QAC3CN,WAAW,CAAC,CAAC,GAAGH,OAAO,CAACE,QAAQ,CAAC,CAAC;MACpC,CAAC,CAAC;IACJ,CAAC,CAAC;IACF;EACF,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMS,aAAa,GAAG,IAAAC,kBAAW,EAC/B,MAAOC,EAAU,IAA6B;IAC5CP,WAAW,CAACO,EAAE,CAAC;IACf,OAAO,MAAMb,OAAO,CAACc,mBAAmB,CAACD,EAAE,CAAC;EAC9C,CAAC,EACD,CAACb,OAAO,CACV,CAAC;EAED,MAAMe,UAAU,GAAG,IAAAH,kBAAW,EAAC,MAAM;IACnCN,WAAW,CAAC,EAAE,CAAC;EACjB,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMI,aAAa,GAAG,IAAAE,kBAAW,EAC/B,MAAOC,EAAU,IAAK;IACpB,MAAMb,OAAO,CAACU,aAAa,CAACG,EAAE,CAAC;IAC/BV,WAAW,CAAC,CAAC,GAAGH,OAAO,CAACE,QAAQ,CAAC,CAAC;IAClC,IAAIG,QAAQ,KAAKQ,EAAE,EAAE;MACnBP,WAAW,CAAC,EAAE,CAAC;IACjB;EACF,CAAC,EACD,CAACN,OAAO,EAAEK,QAAQ,CACpB,CAAC;EAED,MAAMG,cAAc,GAAG,IAAAI,kBAAW,EAChC,OAAOC,EAAU,EAAEG,KAAa,EAAEC,QAAuB,KAAK;IAC5D,MAAMjB,OAAO,CAACQ,cAAc,CAACK,EAAE,EAAEG,KAAK,EAAEC,QAAQ,CAAC;IACjDd,WAAW,CAAC,CAAC,GAAGH,OAAO,CAACE,QAAQ,CAAC,CAAC;EACpC,CAAC,EACD,CAACF,OAAO,CACV,CAAC;EAED,MAAMkB,aAAa,GAAG,IAAAN,kBAAW,EAC/B,CAACC,EAAU,EAAEM,IAAgC,KAAK;IAChD,MAAMC,OAAO,GAAGpB,OAAO,CAACE,QAAQ,CAACmB,IAAI,CAAEC,CAAC,IAAKA,CAAC,CAACT,EAAE,KAAKA,EAAE,CAAC;IACzD,IAAIO,OAAO,IAAID,IAAI,CAACH,KAAK,EAAE;MACzBI,OAAO,CAACJ,KAAK,GAAGG,IAAI,CAACH,KAAK;MAC1Bb,WAAW,CAAC,CAAC,GAAGH,OAAO,CAACE,QAAQ,CAAC,CAAC;IACpC;EACF,CAAC,EACD,CAACF,OAAO,CACV,CAAC;EAED,OAAO;IACLE,QAAQ;IACRG,QAAQ;IACRM,aAAa;IACbI,UAAU;IACVL,aAAa;IACbF,cAAc;IACdU;EACF,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/hooks/useXModel.js

@@ -0,0 +1,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useXModel = useXModel;
+var _react = require("react");
+/**
+ * useXModel — 模型选择 hook
+ */
+
+function useXModel(options) {
+  const {
+    models,
+    defaultModel
+  } = options;
+  const [selectedModel, setSelected] = (0, _react.useState)(defaultModel ?? models[0]?.id ?? '');
+  const setSelectedModel = (0, _react.useCallback)(id => {
+    setSelected(id);
+  }, []);
+  return {
+    selectedModel,
+    models,
+    setSelectedModel
+  };
+}
+//# sourceMappingURL=useXModel.js.map

package/lib/commonjs/hooks/useXModel.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","useXModel","options","models","defaultModel","selectedModel","setSelected","useState","id","setSelectedModel","useCallback"],"sourceRoot":"../../../src","sources":["hooks/useXModel.ts"],"mappings":";;;;;;AAIA,IAAAA,MAAA,GAAAC,OAAA;AAJA;AACA;AACA;;AAeO,SAASC,SAASA,CAACC,OAAyB,EAAE;EACnD,MAAM;IAACC,MAAM;IAAEC;EAAY,CAAC,GAAGF,OAAO;EACtC,MAAM,CAACG,aAAa,EAAEC,WAAW,CAAC,GAAG,IAAAC,eAAQ,EAC3CH,YAAY,IAAID,MAAM,CAAC,CAAC,CAAC,EAAEK,EAAE,IAAI,EACnC,CAAC;EAED,MAAMC,gBAAgB,GAAG,IAAAC,kBAAW,EAAEF,EAAU,IAAK;IACnDF,WAAW,CAACE,EAAE,CAAC;EACjB,CAAC,EAAE,EAAE,CAAC;EAEN,OAAO;IACLH,aAAa;IACbF,MAAM;IACNM;EACF,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/index.js

@@ -0,0 +1,82 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "AbstractChatProvider", {
+  enumerable: true,
+  get: function () {
+    return _AbstractChatProvider.AbstractChatProvider;
+  }
+});
+Object.defineProperty(exports, "ChatProvider", {
+  enumerable: true,
+  get: function () {
+    return _ChatProvider.ChatProvider;
+  }
+});
+Object.defineProperty(exports, "DeepSeekChatProvider", {
+  enumerable: true,
+  get: function () {
+    return _DeepSeekChatProvider.DeepSeekChatProvider;
+  }
+});
+Object.defineProperty(exports, "OpenAIChatProvider", {
+  enumerable: true,
+  get: function () {
+    return _OpenAIChatProvider.OpenAIChatProvider;
+  }
+});
+Object.defineProperty(exports, "SSEParser", {
+  enumerable: true,
+  get: function () {
+    return _SSEParser.SSEParser;
+  }
+});
+Object.defineProperty(exports, "XRequest", {
+  enumerable: true,
+  get: function () {
+    return _XRequest.XRequest;
+  }
+});
+Object.defineProperty(exports, "XStream", {
+  enumerable: true,
+  get: function () {
+    return _XStream.XStream;
+  }
+});
+Object.defineProperty(exports, "useChatContext", {
+  enumerable: true,
+  get: function () {
+    return _ChatProvider.useChatContext;
+  }
+});
+Object.defineProperty(exports, "useXChat", {
+  enumerable: true,
+  get: function () {
+    return _useXChat.useXChat;
+  }
+});
+Object.defineProperty(exports, "useXConversations", {
+  enumerable: true,
+  get: function () {
+    return _useXConversations.useXConversations;
+  }
+});
+Object.defineProperty(exports, "useXModel", {
+  enumerable: true,
+  get: function () {
+    return _useXModel.useXModel;
+  }
+});
+var _XStream = require("./tools/XStream");
+var _XRequest = require("./tools/XRequest");
+var _SSEParser = require("./tools/SSEParser");
+var _AbstractChatProvider = require("./providers/AbstractChatProvider");
+var _OpenAIChatProvider = require("./providers/OpenAIChatProvider");
+var _DeepSeekChatProvider = require("./providers/DeepSeekChatProvider");
+var _useXChat = require("./hooks/useXChat");
+var _useXConversations = require("./hooks/useXConversations");
+var _useXModel = require("./hooks/useXModel");
+var _ChatProvider = require("./hooks/ChatProvider");
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_XStream","require","_XRequest","_SSEParser","_AbstractChatProvider","_OpenAIChatProvider","_DeepSeekChatProvider","_useXChat","_useXConversations","_useXModel","_ChatProvider"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,IAAAA,QAAA,GAAAC,OAAA;AAGA,IAAAC,SAAA,GAAAD,OAAA;AAGA,IAAAE,UAAA,GAAAF,OAAA;AAGA,IAAAG,qBAAA,GAAAH,OAAA;AACA,IAAAI,mBAAA,GAAAJ,OAAA;AAEA,IAAAK,qBAAA,GAAAL,OAAA;AAOA,IAAAM,SAAA,GAAAN,OAAA;AAGA,IAAAO,kBAAA,GAAAP,OAAA;AAGA,IAAAQ,UAAA,GAAAR,OAAA;AAGA,IAAAS,aAAA,GAAAT,OAAA","ignoreList":[]}