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

package/lib/commonjs/tools/XStream.js

@@ -0,0 +1,84 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.XStream = void 0;
+/**
+ * XStream — SSE 流适配器（React Native 版本）
+ *
+ * 基于 react-native-sse 封装，支持 POST 方法 + 自定义请求体
+ */
+
+const defaultTransform = event => ({
+  data: event.data,
+  event: event.event
+});
+class XStream {
+  es = null;
+  timeoutTimer = null;
+  constructor(config) {
+    this.config = config;
+  }
+  connect(callbacks) {
+    this.abort();
+    const {
+      url,
+      method = 'POST',
+      headers,
+      body,
+      timeout = 120000,
+      transformStream = defaultTransform
+    } = this.config;
+
+    // react-native-sse 动态 require，避免非 RN 环境报错
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const RNEventSource = require('react-native-sse').default;
+    const es = new RNEventSource(url, {
+      method,
+      headers: {
+        'Content-Type': 'application/json',
+        ...headers
+      },
+      body: body ? JSON.stringify(body) : undefined
+    });
+    this.es = es;
+    this.timeoutTimer = setTimeout(() => {
+      this.abort();
+      callbacks.onError?.(new Error('SSE 连接超时'));
+    }, timeout);
+    es.addEventListener('open', () => {
+      callbacks.onOpen?.();
+    });
+    es.addEventListener('message', event => {
+      if (event.data) {
+        const output = transformStream({
+          data: event.data
+        });
+        callbacks.onMessage(output);
+      }
+    });
+    es.addEventListener('error', event => {
+      this.clearTimer();
+      callbacks.onError?.(new Error(event.message || 'SSE 连接错误'));
+    });
+  }
+  abort() {
+    this.clearTimer();
+    if (this.es) {
+      this.es.close();
+      this.es = null;
+    }
+  }
+  dispose() {
+    this.abort();
+  }
+  clearTimer() {
+    if (this.timeoutTimer) {
+      clearTimeout(this.timeoutTimer);
+      this.timeoutTimer = null;
+    }
+  }
+}
+exports.XStream = XStream;
+//# sourceMappingURL=XStream.js.map

package/lib/commonjs/tools/XStream.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["defaultTransform","event","data","XStream","es","timeoutTimer","constructor","config","connect","callbacks","abort","url","method","headers","body","timeout","transformStream","RNEventSource","require","default","JSON","stringify","undefined","setTimeout","onError","Error","addEventListener","onOpen","output","onMessage","clearTimer","message","close","dispose","clearTimeout","exports"],"sourceRoot":"../../../src","sources":["tools/XStream.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;;AAqBA,MAAMA,gBAAgB,GAAIC,KAGzB,KAAiB;EAChBC,IAAI,EAAED,KAAK,CAACC,IAAI;EAChBD,KAAK,EAAEA,KAAK,CAACA;AACf,CAAC,CAAC;AAEK,MAAME,OAAO,CAAC;EAEXC,EAAE,GAAuB,IAAI;EAC7BC,YAAY,GAAyC,IAAI;EAEjEC,WAAWA,CAACC,MAAqB,EAAE;IACjC,IAAI,CAACA,MAAM,GAAGA,MAAM;EACtB;EAEAC,OAAOA,CAACC,SAA2B,EAAQ;IACzC,IAAI,CAACC,KAAK,CAAC,CAAC;IAEZ,MAAM;MACJC,GAAG;MACHC,MAAM,GAAG,MAAM;MACfC,OAAO;MACPC,IAAI;MACJC,OAAO,GAAG,MAAM;MAChBC,eAAe,GAAGhB;IACpB,CAAC,GAAG,IAAI,CAACO,MAAM;;IAEf;IACA;IACA,MAAMU,aAAa,GAAGC,OAAO,CAAC,kBAAkB,CAAC,CAACC,OAAO;IAEzD,MAAMf,EAAE,GAAG,IAAIa,aAAa,CAACN,GAAG,EAAE;MAChCC,MAAM;MACNC,OAAO,EAAE;QACP,cAAc,EAAE,kBAAkB;QAClC,GAAGA;MACL,CAAC;MACDC,IAAI,EAAEA,IAAI,GAAGM,IAAI,CAACC,SAAS,CAACP,IAAI,CAAC,GAAGQ;IACtC,CAAC,CAAC;IAEF,IAAI,CAAClB,EAAE,GAAGA,EAAE;IAEZ,IAAI,CAACC,YAAY,GAAGkB,UAAU,CAAC,MAAM;MACnC,IAAI,CAACb,KAAK,CAAC,CAAC;MACZD,SAAS,CAACe,OAAO,GAAG,IAAIC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC,EAAEV,OAAO,CAAC;IAEXX,EAAE,CAACsB,gBAAgB,CAAC,MAAM,EAAE,MAAM;MAChCjB,SAAS,CAACkB,MAAM,GAAG,CAAC;IACtB,CAAC,CAAC;IAEFvB,EAAE,CAACsB,gBAAgB,CAAC,SAAS,EAAGzB,KAAwB,IAAK;MAC3D,IAAIA,KAAK,CAACC,IAAI,EAAE;QACd,MAAM0B,MAAM,GAAGZ,eAAe,CAAC;UAAEd,IAAI,EAAED,KAAK,CAACC;QAAK,CAAC,CAAC;QACpDO,SAAS,CAACoB,SAAS,CAACD,MAAM,CAAC;MAC7B;IACF,CAAC,CAAC;IAEFxB,EAAE,CAACsB,gBAAgB,CAAC,OAAO,EAAGzB,KAA0C,IAAK;MAC3E,IAAI,CAAC6B,UAAU,CAAC,CAAC;MACjBrB,SAAS,CAACe,OAAO,GACf,IAAIC,KAAK,CAACxB,KAAK,CAAC8B,OAAO,IAAI,UAAU,CACvC,CAAC;IACH,CAAC,CAAC;EACJ;EAEArB,KAAKA,CAAA,EAAS;IACZ,IAAI,CAACoB,UAAU,CAAC,CAAC;IACjB,IAAI,IAAI,CAAC1B,EAAE,EAAE;MACX,IAAI,CAACA,EAAE,CAAC4B,KAAK,CAAC,CAAC;MACf,IAAI,CAAC5B,EAAE,GAAG,IAAI;IAChB;EACF;EAEA6B,OAAOA,CAAA,EAAS;IACd,IAAI,CAACvB,KAAK,CAAC,CAAC;EACd;EAEQoB,UAAUA,CAAA,EAAS;IACzB,IAAI,IAAI,CAACzB,YAAY,EAAE;MACrB6B,YAAY,CAAC,IAAI,CAAC7B,YAAY,CAAC;MAC/B,IAAI,CAACA,YAAY,GAAG,IAAI;IAC1B;EACF;AACF;AAAC8B,OAAA,CAAAhC,OAAA,GAAAA,OAAA","ignoreList":[]}

package/lib/commonjs/types/message.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=message.js.map

package/lib/commonjs/types/message.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/message.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/types/provider.js

@@ -0,0 +1,6 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+//# sourceMappingURL=provider.js.map

package/lib/commonjs/types/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/provider.ts"],"mappings":"","ignoreList":[]}

package/lib/commonjs/types/sse.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=sse.js.map

package/lib/commonjs/types/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/sse.ts"],"mappings":"","ignoreList":[]}

package/lib/module/hooks/ChatProvider.js

@@ -0,0 +1,70 @@
+"use strict";
+
+/**
+ * ChatProvider — 全局数据提供 Context
+ *
+ * 可选的全局 Provider 模式（也可直接使用 hooks）
+ */
+
+import React, { createContext, useContext, useMemo } from 'react';
+import { useXChat } from "./useXChat.js";
+import { useXConversations } from "./useXConversations.js";
+import { useXModel } from "./useXModel.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+const ChatContext = /*#__PURE__*/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);
+  }
+};
+export function ChatProvider(props) {
+  const {
+    provider,
+    storage,
+    models = [],
+    defaultModel,
+    generateId,
+    requestPlaceholder,
+    requestFallback,
+    children
+  } = props;
+  const chatConfig = useMemo(() => ({
+    provider,
+    generateId,
+    requestPlaceholder,
+    requestFallback
+  }), [provider, generateId, requestPlaceholder, requestFallback]);
+  const chat = useXChat(chatConfig);
+  const convOptions = useMemo(() => ({
+    storage: storage ?? memoryStorage
+  }), [storage]);
+  const conversations = useXConversations(convOptions);
+  const model = useXModel({
+    models,
+    defaultModel
+  });
+  const value = useMemo(() => ({
+    ...chat,
+    ...conversations,
+    ...model
+  }), [chat, conversations, model]);
+  return /*#__PURE__*/_jsx(ChatContext.Provider, {
+    value: value,
+    children: children
+  });
+}
+export function useChatContext() {
+  const ctx = useContext(ChatContext);
+  if (!ctx) {
+    throw new Error('useChatContext must be used within a ChatProvider');
+  }
+  return ctx;
+}
+//# sourceMappingURL=ChatProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["React","createContext","useContext","useMemo","useXChat","useXConversations","useXModel","jsx","_jsx","ChatContext","memoryStorage","_data","Map","getItem","key","get","setItem","value","set","removeItem","delete","ChatProvider","props","provider","storage","models","defaultModel","generateId","requestPlaceholder","requestFallback","children","chatConfig","chat","convOptions","conversations","model","Provider","useChatContext","ctx","Error"],"sourceRoot":"../../../src","sources":["hooks/ChatProvider.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,KAAK,IAAGC,aAAa,EAAEC,UAAU,EAAEC,OAAO,QAAO,OAAO;AAC/D,SAAQC,QAAQ,QAAO,eAAY;AACnC,SAAQC,iBAAiB,QAAO,wBAAqB;AACrD,SAAQC,SAAS,QAAO,gBAAa;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAiDtC,MAAMC,WAAW,gBAAGR,aAAa,CAA0B,IAAI,CAAC;AAEhE,MAAMS,aAA0B,GAAG;EACjCC,KAAK,EAAE,IAAIC,GAAG,CAAiB,CAAC;EAChC,MAAMC,OAAOA,CAACC,GAAW,EAAE;IACzB,OAAQ,IAAI,CAACH,KAAK,CAAyBI,GAAG,CAACD,GAAG,CAAC,IAAI,IAAI;EAC7D,CAAC;EACD,MAAME,OAAOA,CAACF,GAAW,EAAEG,KAAa,EAAE;IACvC,IAAI,CAACN,KAAK,CAAyBO,GAAG,CAACJ,GAAG,EAAEG,KAAK,CAAC;EACrD,CAAC;EACD,MAAME,UAAUA,CAACL,GAAW,EAAE;IAC3B,IAAI,CAACH,KAAK,CAAyBS,MAAM,CAACN,GAAG,CAAC;EACjD;AACF,CAAiD;AAEjD,OAAO,SAASO,YAAYA,CAI1BC,KAAgD,EAAE;EAClD,MAAM;IACJC,QAAQ;IACRC,OAAO;IACPC,MAAM,GAAG,EAAE;IACXC,YAAY;IACZC,UAAU;IACVC,kBAAkB;IAClBC,eAAe;IACfC;EACF,CAAC,GAAGR,KAAK;EAET,MAAMS,UAAkD,GAAG5B,OAAO,CAChE,OAAO;IACLoB,QAAQ;IACRI,UAAU;IACVC,kBAAkB;IAClBC;EACF,CAAC,CAAC,EACF,CAACN,QAAQ,EAAEI,UAAU,EAAEC,kBAAkB,EAAEC,eAAe,CAC5D,CAAC;EAED,MAAMG,IAAI,GAAG5B,QAAQ,CAAC2B,UAAU,CAAC;EAEjC,MAAME,WAAqC,GAAG9B,OAAO,CACnD,OAAO;IAAEqB,OAAO,EAAEA,OAAO,IAAId;EAAc,CAAC,CAAC,EAC7C,CAACc,OAAO,CACV,CAAC;EACD,MAAMU,aAAa,GAAG7B,iBAAiB,CAAC4B,WAAW,CAAC;EAEpD,MAAME,KAAK,GAAG7B,SAAS,CAAC;IAAEmB,MAAM;IAAEC;EAAa,CAAC,CAAC;EAEjD,MAAMT,KAAK,GAAGd,OAAO,CACnB,OAAO;IACL,GAAG6B,IAAI;IACP,GAAGE,aAAa;IAChB,GAAGC;EACL,CAAC,CAAC,EACF,CAACH,IAAI,EAAEE,aAAa,EAAEC,KAAK,CAC7B,CAAC;EAED,oBACE3B,IAAA,CAACC,WAAW,CAAC2B,QAAQ;IAACnB,KAAK,EAAEA,KAAqC;IAAAa,QAAA,EAC/DA;EAAQ,CACW,CAAC;AAE3B;AAEA,OAAO,SAASO,cAAcA,CAAA,EAEC;EAC7B,MAAMC,GAAG,GAAGpC,UAAU,CAACO,WAAW,CAAC;EACnC,IAAI,CAAC6B,GAAG,EAAE;IACR,MAAM,IAAIC,KAAK,CAAC,mDAAmD,CAAC;EACtE;EACA,OAAOD,GAAG;AACZ","ignoreList":[]}

package/lib/module/hooks/useXChat.js

@@ -0,0 +1,91 @@
+"use strict";
+
+/**
+ * useXChat — 聊天操作 hook
+ *
+ * 消费 ChatProvider，输出可渲染的 messages 列表
+ */
+
+import { useCallback, useEffect, useRef, useSyncExternalStore } from 'react';
+import { createChatStore } from "../stores/chatStore.js";
+export function useXChat(config) {
+  const {
+    provider
+  } = config;
+  const storeRef = useRef(createChatStore());
+  const store = storeRef.current;
+
+  // 使用 useSyncExternalStore 订阅 zustand store 变化
+  const state = useSyncExternalStore(store.subscribe, store.getState, store.getState);
+  const onRequest = 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 = useCallback(() => {
+    provider.abort();
+    store.getState().setRequesting(false);
+  }, [provider, store]);
+  const resetChat = useCallback(() => {
+    store.getState().resetChat();
+  }, [store]);
+  const loadSession = useCallback(messages => {
+    store.getState().loadSession(messages);
+  }, [store]);
+  const clearError = useCallback(() => {
+    store.getState().setError(null);
+  }, [store]);
+  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/module/hooks/useXChat.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useRef","useSyncExternalStore","createChatStore","useXChat","config","provider","storeRef","store","current","state","subscribe","getState","onRequest","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","map","id","extra","requesting","suggestions"],"sourceRoot":"../../../src","sources":["hooks/useXChat.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/hooks/useXConversations.js

@@ -0,0 +1,65 @@
+"use strict";
+
+/**
+ * useXConversations — 会话管理 hook
+ *
+ * 组合 sessionStore + historyStore，管理会话生命周期
+ */
+
+import { useState, useCallback, useEffect, useRef } from 'react';
+import { createHistoryStore } from "../stores/historyStore.js";
+export function useXConversations(options) {
+  const {
+    storage
+  } = options;
+  const historyRef = useRef(createHistoryStore(storage));
+  const history = historyRef.current;
+  const [sessions, setSessions] = useState(history.sessions);
+  const [activeId, setActiveId] = useState('');
+
+  // 初始化加载
+  useEffect(() => {
+    // 触发 loadIndex
+    history.archiveSession('__init__', '', []).then(() => {
+      history.deleteSession('__init__').then(() => {
+        setSessions([...history.sessions]);
+      });
+    });
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+  const switchSession = useCallback(async id => {
+    setActiveId(id);
+    return await history.loadSessionMessages(id);
+  }, [history]);
+  const newSession = useCallback(() => {
+    setActiveId('');
+  }, []);
+  const deleteSession = useCallback(async id => {
+    await history.deleteSession(id);
+    setSessions([...history.sessions]);
+    if (activeId === id) {
+      setActiveId('');
+    }
+  }, [history, activeId]);
+  const archiveSession = useCallback(async (id, title, messages) => {
+    await history.archiveSession(id, title, messages);
+    setSessions([...history.sessions]);
+  }, [history]);
+  const updateSession = 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/module/hooks/useXConversations.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useState","useCallback","useEffect","useRef","createHistoryStore","useXConversations","options","storage","historyRef","history","current","sessions","setSessions","activeId","setActiveId","archiveSession","then","deleteSession","switchSession","id","loadSessionMessages","newSession","title","messages","updateSession","data","session","find","s"],"sourceRoot":"../../../src","sources":["hooks/useXConversations.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;;AAEA,SAAQA,QAAQ,EAAEC,WAAW,EAAEC,SAAS,EAAEC,MAAM,QAAO,OAAO;AAC9D,SAAQC,kBAAkB,QAAO,2BAAwB;AAWzD,OAAO,SAASC,iBAAiBA,CAACC,OAAiC,EAAE;EACnE,MAAM;IAACC;EAAO,CAAC,GAAGD,OAAO;EAEzB,MAAME,UAAU,GAAGL,MAAM,CAACC,kBAAkB,CAACG,OAAO,CAAC,CAAC;EACtD,MAAME,OAAO,GAAGD,UAAU,CAACE,OAAO;EAElC,MAAM,CAACC,QAAQ,EAAEC,WAAW,CAAC,GAAGZ,QAAQ,CAACS,OAAO,CAACE,QAAQ,CAAC;EAC1D,MAAM,CAACE,QAAQ,EAAEC,WAAW,CAAC,GAAGd,QAAQ,CAAC,EAAE,CAAC;;EAE5C;EACAE,SAAS,CAAC,MAAM;IACd;IACAO,OAAO,CAACM,cAAc,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAACC,IAAI,CAAC,MAAM;MACpDP,OAAO,CAACQ,aAAa,CAAC,UAAU,CAAC,CAACD,IAAI,CAAC,MAAM;QAC3CJ,WAAW,CAAC,CAAC,GAAGH,OAAO,CAACE,QAAQ,CAAC,CAAC;MACpC,CAAC,CAAC;IACJ,CAAC,CAAC;IACF;EACF,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMO,aAAa,GAAGjB,WAAW,CAC/B,MAAOkB,EAAU,IAA6B;IAC5CL,WAAW,CAACK,EAAE,CAAC;IACf,OAAO,MAAMV,OAAO,CAACW,mBAAmB,CAACD,EAAE,CAAC;EAC9C,CAAC,EACD,CAACV,OAAO,CACV,CAAC;EAED,MAAMY,UAAU,GAAGpB,WAAW,CAAC,MAAM;IACnCa,WAAW,CAAC,EAAE,CAAC;EACjB,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMG,aAAa,GAAGhB,WAAW,CAC/B,MAAOkB,EAAU,IAAK;IACpB,MAAMV,OAAO,CAACQ,aAAa,CAACE,EAAE,CAAC;IAC/BP,WAAW,CAAC,CAAC,GAAGH,OAAO,CAACE,QAAQ,CAAC,CAAC;IAClC,IAAIE,QAAQ,KAAKM,EAAE,EAAE;MACnBL,WAAW,CAAC,EAAE,CAAC;IACjB;EACF,CAAC,EACD,CAACL,OAAO,EAAEI,QAAQ,CACpB,CAAC;EAED,MAAME,cAAc,GAAGd,WAAW,CAChC,OAAOkB,EAAU,EAAEG,KAAa,EAAEC,QAAuB,KAAK;IAC5D,MAAMd,OAAO,CAACM,cAAc,CAACI,EAAE,EAAEG,KAAK,EAAEC,QAAQ,CAAC;IACjDX,WAAW,CAAC,CAAC,GAAGH,OAAO,CAACE,QAAQ,CAAC,CAAC;EACpC,CAAC,EACD,CAACF,OAAO,CACV,CAAC;EAED,MAAMe,aAAa,GAAGvB,WAAW,CAC/B,CAACkB,EAAU,EAAEM,IAAgC,KAAK;IAChD,MAAMC,OAAO,GAAGjB,OAAO,CAACE,QAAQ,CAACgB,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;MAC1BV,WAAW,CAAC,CAAC,GAAGH,OAAO,CAACE,QAAQ,CAAC,CAAC;IACpC;EACF,CAAC,EACD,CAACF,OAAO,CACV,CAAC;EAED,OAAO;IACLE,QAAQ;IACRE,QAAQ;IACRK,aAAa;IACbG,UAAU;IACVJ,aAAa;IACbF,cAAc;IACdS;EACF,CAAC;AACH","ignoreList":[]}

package/lib/module/hooks/useXModel.js

@@ -0,0 +1,23 @@
+"use strict";
+
+/**
+ * useXModel — 模型选择 hook
+ */
+
+import { useState, useCallback } from 'react';
+export function useXModel(options) {
+  const {
+    models,
+    defaultModel
+  } = options;
+  const [selectedModel, setSelected] = useState(defaultModel ?? models[0]?.id ?? '');
+  const setSelectedModel = useCallback(id => {
+    setSelected(id);
+  }, []);
+  return {
+    selectedModel,
+    models,
+    setSelectedModel
+  };
+}
+//# sourceMappingURL=useXModel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useState","useCallback","useXModel","options","models","defaultModel","selectedModel","setSelected","id","setSelectedModel"],"sourceRoot":"../../../src","sources":["hooks/useXModel.ts"],"mappings":";;AAAA;AACA;AACA;;AAEA,SAAQA,QAAQ,EAAEC,WAAW,QAAO,OAAO;AAa3C,OAAO,SAASC,SAASA,CAACC,OAAyB,EAAE;EACnD,MAAM;IAACC,MAAM;IAAEC;EAAY,CAAC,GAAGF,OAAO;EACtC,MAAM,CAACG,aAAa,EAAEC,WAAW,CAAC,GAAGP,QAAQ,CAC3CK,YAAY,IAAID,MAAM,CAAC,CAAC,CAAC,EAAEI,EAAE,IAAI,EACnC,CAAC;EAED,MAAMC,gBAAgB,GAAGR,WAAW,CAAEO,EAAU,IAAK;IACnDD,WAAW,CAACC,EAAE,CAAC;EACjB,CAAC,EAAE,EAAE,CAAC;EAEN,OAAO;IACLF,aAAa;IACbF,MAAM;IACNK;EACF,CAAC;AACH","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,27 @@
+"use strict";
+
+/**
+ * @unif/react-native-chat-sdk
+ * AI 聊天 SDK — 流式通信、Provider 模式、状态管理
+ */
+
+// Types
+
+// Tools
+export { XStream } from "./tools/XStream.js";
+export { XRequest } from "./tools/XRequest.js";
+export { SSEParser } from "./tools/SSEParser.js";
+
+// Providers
+export { AbstractChatProvider } from "./providers/AbstractChatProvider.js";
+export { OpenAIChatProvider } from "./providers/OpenAIChatProvider.js";
+export { DeepSeekChatProvider } from "./providers/DeepSeekChatProvider.js";
+
+// Stores
+
+// Hooks
+export { useXChat } from "./hooks/useXChat.js";
+export { useXConversations } from "./hooks/useXConversations.js";
+export { useXModel } from "./hooks/useXModel.js";
+export { ChatProvider, useChatContext } from "./hooks/ChatProvider.js";
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["XStream","XRequest","SSEParser","AbstractChatProvider","OpenAIChatProvider","DeepSeekChatProvider","useXChat","useXConversations","useXModel","ChatProvider","useChatContext"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAEA;;AA0BA;AACA,SAAQA,OAAO,QAAO,oBAAiB;AAGvC,SAAQC,QAAQ,QAAO,qBAAkB;AAGzC,SAAQC,SAAS,QAAO,sBAAmB;;AAE3C;AACA,SAAQC,oBAAoB,QAAO,qCAAkC;AACrE,SAAQC,kBAAkB,QAAO,mCAAgC;AAEjE,SAAQC,oBAAoB,QAAO,qCAAkC;;AAGrE;;AAGA;AACA,SAAQC,QAAQ,QAAO,qBAAkB;AAGzC,SAAQC,iBAAiB,QAAO,8BAA2B;AAG3D,SAAQC,SAAS,QAAO,sBAAmB;AAG3C,SAAQC,YAAY,EAAEC,cAAc,QAAO,yBAAsB","ignoreList":[]}

package/lib/module/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/module/package.json

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

package/lib/module/providers/AbstractChatProvider.js

@@ -0,0 +1,59 @@
+"use strict";
+
+/**
+ * AbstractChatProvider — Provider 抽象基类
+ *
+ * 3 个抽象方法：transformParams / transformLocalMessage / transformMessage
+ */
+
+export class AbstractChatProvider {
+  constructor(config) {
+    this.request = config.request;
+  }
+
+  /**
+   * 转换请求参数
+   * 将 useXChat.onRequest() 传入的参数转换为 XRequest 需要的格式
+   */
+
+  /**
+   * 转换本地消息
+   * 将请求参数转换为用户发送的本地 ChatMessage（用于消息列表渲染）
+   */
+
+  /**
+   * 转换响应消息
+   * 将 XRequest 返回的流数据转换为 ChatMessage（用于 assistant 消息渲染）
+   */
+
+  /**
+   * 发起请求（内部调用 XRequest）
+   */
+  sendMessage(input, callbacks) {
+    const params = this.transformParams(input);
+    let currentMessage;
+    const requestCallbacks = {
+      onStream: chunk => {
+        currentMessage = this.transformMessage(chunk, currentMessage);
+        callbacks.onUpdate(currentMessage);
+      },
+      onSuccess: () => {
+        if (currentMessage) {
+          callbacks.onSuccess(currentMessage);
+        }
+      },
+      onError: error => {
+        callbacks.onError(new Error(error.message));
+      }
+    };
+    this.request.create(params, requestCallbacks);
+  }
+
+  /**
+   * 中止请求
+   */
+  abort() {
+    this.request.abort();
+  }
+}
+//# sourceMappingURL=AbstractChatProvider.js.map