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

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,173 @@
+"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]);
+  const onReload = (0, _react.useCallback)((id, 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);
+      },
+      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 setMessages = (0, _react.useCallback)(messagesOrFn => {
+    if (typeof messagesOrFn === 'function') {
+      const current = store.getState().messages;
+      const currentInfos = current.map(m => ({
+        id: m.id,
+        message: m,
+        status: m.status,
+        extra: m.extra
+      }));
+      const next = messagesOrFn(currentInfos);
+      store.getState().setMessages(next.map(info => info.message));
+    } else {
+      store.getState().setMessages(messagesOrFn.map(info => info.message));
+    }
+  }, [store]);
+  const setMessage = (0, _react.useCallback)((id, partialOrFn) => {
+    store.getState().setMessage(id, m => {
+      const info = {
+        id: m.id,
+        message: m,
+        status: m.status,
+        extra: m.extra
+      };
+      const partial = typeof partialOrFn === 'function' ? partialOrFn(info) : partialOrFn;
+      const updated = {};
+      if (partial.message !== undefined) {
+        Object.assign(updated, partial.message);
+      }
+      if (partial.status !== undefined) {
+        updated.status = partial.status;
+      }
+      return updated;
+    });
+  }, [store]);
+  const removeMessage = (0, _react.useCallback)(id => {
+    store.getState().removeMessage(id);
+  }, [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,
+    onReload,
+    abort,
+    resetChat,
+    loadSession,
+    clearError,
+    setMessages,
+    setMessage,
+    removeMessage
+  };
+}
+//# 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","onReload","id","targetIdx","findIndex","setMessages","messagesOrFn","currentInfos","map","extra","next","info","setMessage","partialOrFn","partial","updated","undefined","Object","assign","removeMessage","useEffect","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":[]}

package/lib/commonjs/index.md

@@ -0,0 +1,188 @@
+---
+title: SDK 概览
+nav:
+  title: SDK
+  path: /sdk
+---
+
+# @unif/react-native-chat-sdk
+
+聊天 SDK 包，提供 Provider 抽象、Hooks、状态管理和流式处理工具。
+
+## 架构
+
+```
+┌─────────────────────────────────────────┐
+│            useXChat (Hook)              │
+│   组合 Provider + store，输出 messages  │
+├─────────────────────────────────────────┤
+│           ChatProvider 层               │
+│  AbstractChatProvider → OpenAI/DeepSeek │
+├─────────────────────────────────────────┤
+│              工具层                     │
+│   XRequest → XStream → SSEParser       │
+├─────────────────────────────────────────┤
+│              数据层                     │
+│   chatStore / sessionStore / modelStore │
+└─────────────────────────────────────────┘
+```
+
+## 核心 Hooks
+
+### useXChat — 聊天操作
+
+```tsx
+import { useXChat, OpenAIChatProvider, XRequest } from '@unif/react-native-chat-sdk';
+
+const request = new XRequest({
+  baseURL: 'https://api.openai.com',
+  getToken: async () => 'sk-...',
+});
+const provider = new OpenAIChatProvider({ request, model: 'gpt-4o' });
+
+const { messages, requesting, onRequest, abort } = useXChat({ provider });
+
+// 发起请求
+onRequest({ message: { text: '你好' } });
+
+// 中止请求
+abort();
+```
+
+**返回值:**
+
+| 属性 | 说明 | 类型 |
+|------|------|------|
+| messages | 可渲染消息列表 | `MessageInfo<Message>[]` |
+| requesting | 是否请求中 | `boolean` |
+| suggestions | 建议提示 | `SuggestionItem[]` |
+| onRequest | 发起请求 | `(input: Input) => void` |
+| abort | 中止请求 | `() => void` |
+
+### useXConversations — 会话管理
+
+```tsx
+import { useXConversations } from '@unif/react-native-chat-sdk';
+import AsyncStorage from '@react-native-async-storage/async-storage';
+
+const {
+  sessions, activeId,
+  switchSession, newSession, deleteSession,
+} = useXConversations({ storage: AsyncStorage });
+```
+
+### useXModel — 模型选择
+
+```tsx
+import { useXModel } from '@unif/react-native-chat-sdk';
+
+const { selectedModel, setSelectedModel } = useXModel({
+  models: [
+    { id: 'gpt-4o', name: 'GPT-4o', desc: '最强模型' },
+    { id: 'gpt-4o-mini', name: 'GPT-4o Mini', desc: '快速响应' },
+  ],
+  defaultModel: 'gpt-4o',
+});
+```
+
+## Provider 体系
+
+### 内置 Provider
+
+| Provider | 说明 |
+|----------|------|
+| `OpenAIChatProvider` | 兼容 OpenAI API 格式（含 Azure、Moonshot、通义千问等） |
+| `DeepSeekChatProvider` | 继承 OpenAI，额外处理 `reasoning_content` 字段 |
+
+### 自定义 Provider
+
+继承 `AbstractChatProvider`，实现 3 个抽象方法：
+
+```tsx
+import { AbstractChatProvider } from '@unif/react-native-chat-sdk';
+
+class MyProvider extends AbstractChatProvider {
+  transformParams(input) {
+    // 转换请求参数为你的 API 格式
+    return { query: input.message.text, model: input.model };
+  }
+
+  transformLocalMessage(input) {
+    // 创建本地用户消息
+    return { id: generateId(), text: input.message.text, role: 'user', status: 'local', ... };
+  }
+
+  transformMessage(output, current) {
+    // 解析流式响应，累积到 assistant 消息
+    const data = JSON.parse(output.data);
+    return { ...current, text: (current?.text || '') + data.content, status: 'updating' };
+  }
+}
+```
+
+## 工具类
+
+### XRequest
+
+面向 LLM 的 HTTP 请求工具，内置 token 注入和 SSE 解析。
+
+```tsx
+const request = new XRequest({
+  baseURL: 'https://api.example.com',
+  endpoint: '/v1/chat/completions',
+  getToken: async () => await loadToken(),
+  timeout: 120000,
+});
+```
+
+### XStream
+
+SSE 流适配器（RN 原生实现，基于 react-native-sse）。
+
+### SSEParser
+
+SSE 解析器，提供 `event_id` 幂等去重和 `seq` 严格排序。
+
+## ChatProvider — 全局模式
+
+```tsx
+import { ChatProvider, useChatContext } from '@unif/react-native-chat-sdk';
+
+// 根组件
+<ChatProvider provider={provider} storage={AsyncStorage} models={MODELS}>
+  <App />
+</ChatProvider>
+
+// 子组件
+const { messages, onRequest, sessions, selectedModel } = useChatContext();
+```
+
+## 类型定义
+
+### ChatMessage
+
+```typescript
+interface ChatMessage {
+  id: string;
+  text: string;
+  role: 'user' | 'assistant' | 'system';
+  createdAt: Date;
+  messageType: 'text' | 'card' | 'system';
+  status: 'local' | 'loading' | 'updating' | 'success' | 'error' | 'abort';
+  cardType?: string;
+  cardData?: { data: Record<string, unknown>; actions: string[] };
+  turnId: string;
+  extra?: Record<string, unknown>;
+}
+```
+
+### MessageInfo
+
+```typescript
+interface MessageInfo<Message> {
+  id: string;
+  message: Message;
+  status: MessageStatus;
+  extra?: Record<string, unknown>;
+}
+```

package/lib/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}