@unif/react-native-chat-sdk 0.4.1 → 0.5.0

package/src/providers/DeepSeekChatProvider.ts

@@ -5,9 +5,9 @@
  * 额外处理 reasoning_content 字段（DeepSeek 的思考过程）→ 映射到 <think> 标签
  */
 
-import {OpenAIChatProvider} from './OpenAIChatProvider';
-import type {ChatMessage} from '../types/message';
-import type {SSEOutput} from '../types/provider';
+import { OpenAIChatProvider } from './OpenAIChatProvider';
+import type { ChatMessage } from '../types/message';
+import type { SSEOutput } from '../types/provider';
 
 export interface DeepSeekChatProviderConfig {
   apiKey?: string;
@@ -71,10 +71,7 @@ export class DeepSeekChatProvider extends OpenAIChatProvider {
 
       if (content) {
         // 如果有未关闭的 think 标签，先关闭
-        if (
-          newText.includes('<think>') &&
-          !newText.includes('</think>')
-        ) {
+        if (newText.includes('<think>') && !newText.includes('</think>')) {
           newText += '</think>';
         }
         newText += content;

package/src/providers/OpenAIChatProvider.ts

@@ -4,10 +4,10 @@
  * 兼容所有 OpenAI 标准 API（OpenAI、Azure、Moonshot、通义千问兼容模式等）
  */
 
-import {AbstractChatProvider} from './AbstractChatProvider';
-import {XRequest} from '../tools/XRequest';
-import type {ChatMessage, MessageStatus} from '../types/message';
-import type {RequestParams, SSEOutput} from '../types/provider';
+import { AbstractChatProvider } from './AbstractChatProvider';
+import { XRequest } from '../tools/XRequest';
+import type { ChatMessage, MessageStatus } from '../types/message';
+import type { RequestParams, SSEOutput } from '../types/provider';
 
 export interface OpenAIChatProviderConfig {
   baseURL: string;
@@ -30,7 +30,7 @@ export class OpenAIChatProvider extends AbstractChatProvider<
   constructor(config: OpenAIChatProviderConfig) {
     const headers: Record<string, string> = {};
     if (config.apiKey) {
-      headers['Authorization'] = `Bearer ${config.apiKey}`;
+      headers.Authorization = `Bearer ${config.apiKey}`;
     }
 
     const request = new XRequest({
@@ -76,7 +76,7 @@ export class OpenAIChatProvider extends AbstractChatProvider<
       createdAt: new Date(),
       messageType: 'text',
       status: 'local' as MessageStatus,
-      turnId: input.extra?.turnId as string ?? genId(),
+      turnId: (input.extra?.turnId as string) ?? genId(),
     };
   }
 

package/src/stores/chatStore.ts

@@ -3,9 +3,9 @@
  * 内部 store，通过 useXChat hook 封装后对外暴露
  */
 
-import {create} from 'zustand';
-import type {ChatMessage} from '../types/message';
-import type {SuggestionItem} from '../types/sse';
+import { create } from 'zustand';
+import type { ChatMessage } from '../types/message';
+import type { SuggestionItem } from '../types/sse';
 
 interface ChatState {
   messages: ChatMessage[];
@@ -15,18 +15,17 @@ interface ChatState {
   error: string | null;
 
   addMessage: (message: ChatMessage) => void;
-  updateMessage: (id: string, updater: (msg: ChatMessage) => ChatMessage) => void;
+  updateMessage: (
+    id: string,
+    updater: (msg: ChatMessage) => ChatMessage
+  ) => void;
   upsertMessage: (message: ChatMessage) => void;
   setMessages: (
-    messages:
-      | ChatMessage[]
-      | ((prev: ChatMessage[]) => ChatMessage[]),
+    messages: ChatMessage[] | ((prev: ChatMessage[]) => ChatMessage[])
   ) => void;
   setMessage: (
     id: string,
-    partial:
-      | Partial<ChatMessage>
-      | ((msg: ChatMessage) => Partial<ChatMessage>),
+    partial: Partial<ChatMessage> | ((msg: ChatMessage) => Partial<ChatMessage>)
   ) => void;
   removeMessage: (id: string) => void;
   setSuggestions: (items: SuggestionItem[]) => void;
@@ -36,6 +35,26 @@ interface ChatState {
   loadSession: (messages: ChatMessage[]) => void;
 }
 
+// 全局 store 管理器 — 多会话内存常驻
+const chatStoreMap = new Map<string, ReturnType<typeof createChatStore>>();
+
+export function getOrCreateChatStore(key: string) {
+  let store = chatStoreMap.get(key);
+  if (!store) {
+    store = createChatStore();
+    chatStoreMap.set(key, store);
+  }
+  return store;
+}
+
+export function deleteChatStore(key: string) {
+  chatStoreMap.delete(key);
+}
+
+export function getChatStoreMessages(key: string) {
+  return chatStoreMap.get(key)?.getState()?.messages;
+}
+
 export const createChatStore = () =>
   create<ChatState>((set, get) => ({
     messages: [],

package/src/stores/historyStore.ts

@@ -3,8 +3,8 @@
  * 使用 ChatStorage 抽象，不直接依赖 AsyncStorage
  */
 
-import type {ChatMessage} from '../types/message';
-import type {ChatStorage} from './storage';
+import type { ChatMessage } from '../types/message';
+import type { ChatStorage } from './storage';
 
 const MAX_SESSIONS = 50;
 const MESSAGE_KEY_PREFIX = 'chat-session-';
@@ -24,6 +24,11 @@ export interface HistoryStore {
     title: string,
     messages: ChatMessage[]
   ) => Promise<void>;
+  saveSession: (
+    id: string,
+    title: string,
+    messages: ChatMessage[]
+  ) => Promise<void>;
   loadSessionMessages: (id: string) => Promise<ChatMessage[]>;
   deleteSession: (id: string) => Promise<void>;
   clearAll: () => Promise<void>;
@@ -81,9 +86,43 @@ export function createHistoryStore(storage: ChatStorage): HistoryStore {
       if (sessions.length > MAX_SESSIONS) {
         const removed = sessions.splice(MAX_SESSIONS);
         await Promise.all(
-          removed.map((s) =>
-            storage.removeItem(`${MESSAGE_KEY_PREFIX}${s.id}`)
-          )
+          removed.map((s) => storage.removeItem(`${MESSAGE_KEY_PREFIX}${s.id}`))
+        );
+      }
+
+      await saveIndex();
+    },
+
+    saveSession: async (id, title, messages) => {
+      await loadIndex();
+      if (messages.length === 0) return;
+
+      await storage.setItem(
+        `${MESSAGE_KEY_PREFIX}${id}`,
+        JSON.stringify(messages)
+      );
+
+      const lastMsg = messages[0];
+      const summary: SessionSummary = {
+        id,
+        title,
+        lastMessage: lastMsg?.text?.slice(0, 50) ?? '',
+        timestamp: Date.now(),
+        messageCount: messages.length,
+      };
+
+      const idx = sessions.findIndex((s) => s.id === id);
+      if (idx >= 0) {
+        sessions[idx] = summary;
+      } else {
+        sessions.unshift(summary);
+      }
+
+      // FIFO 淘汰
+      if (sessions.length > MAX_SESSIONS) {
+        const removed = sessions.splice(MAX_SESSIONS);
+        await Promise.all(
+          removed.map((s) => storage.removeItem(`${MESSAGE_KEY_PREFIX}${s.id}`))
         );
       }
 
@@ -106,9 +145,7 @@ export function createHistoryStore(storage: ChatStorage): HistoryStore {
     clearAll: async () => {
       await loadIndex();
       await Promise.all(
-        sessions.map((s) =>
-          storage.removeItem(`${MESSAGE_KEY_PREFIX}${s.id}`)
-        )
+        sessions.map((s) => storage.removeItem(`${MESSAGE_KEY_PREFIX}${s.id}`))
       );
       sessions = [];
       await saveIndex();

package/src/stores/modelStore.ts

@@ -3,7 +3,7 @@
  * 内部 store，通过 useXModel hook 封装后对外暴露
  */
 
-import {create} from 'zustand';
+import { create } from 'zustand';
 
 interface ModelState {
   selectedModel: string;

package/src/stores/sessionStore.ts

@@ -3,7 +3,7 @@
  * 内部 store，通过 useXConversations hook 封装后对外暴露
  */
 
-import {create} from 'zustand';
+import { create } from 'zustand';
 
 interface SessionState {
   sessionId: string;

package/src/tools/SSEParser.ts

@@ -5,7 +5,7 @@
  * - 每轮对话调用 reset() 重置
  */
 
-import type {SSEEnvelope} from '../types/sse';
+import type { SSEEnvelope } from '../types/sse';
 
 export class SSEParser {
   private processedIds = new Set<string>();

package/src/tools/XRequest.ts

@@ -57,7 +57,7 @@ export class XRequest {
       try {
         const token = await getToken();
         if (token) {
-          reqHeaders['Authorization'] = `Bearer ${token}`;
+          reqHeaders.Authorization = `Bearer ${token}`;
         }
       } catch {
         // token 获取失败，继续无认证请求

package/src/tools/XStream.ts

@@ -61,7 +61,6 @@ export class XStream {
     console.log(TAG, '连接', url, `timeout=${timeout}ms`);
 
     // 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, {

package/src/types/provider.ts

@@ -3,8 +3,8 @@
  * 定义 ChatProvider ↔ useXChat 之间的数据契约
  */
 
-import type {ChatMessage} from './message';
-import type {SuggestionItem} from './sse';
+import type { ChatMessage } from './message';
+import type { SuggestionItem } from './sse';
 
 export interface RequestParams<T = ChatMessage> {
   message: T;

package/lib/commonjs/index.md

@@ -1,188 +0,0 @@
----
-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/index.md

@@ -1,188 +0,0 @@
----
-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>;
-}
-```