sse-stream-plugin-react 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ryan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,117 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# sse-stream-plugin-react
+
+[sse-stream-plugin-sdk](../core) 的 React Hooks 封装。将插件化 SSE SDK 封装为声明式响应式 API，自动管理实例生命周期与事件订阅。
+
+## 安装
+
+需要同时安装核心 SDK：
+
+```bash
+npm install sse-stream-plugin-react sse-stream-plugin-sdk
+# 或
+pnpm add sse-stream-plugin-react sse-stream-plugin-sdk
+```
+
+> `react` 为 peerDependency，要求 `>=16.8.0`。
+
+## 快速开始
+
+```tsx
+import { useSSEStream } from 'sse-stream-plugin-react'
+import { recommendedPlugins } from 'sse-stream-plugin-sdk'
+
+function Chat() {
+  const { text, loading, status, start, stop } = useSSEStream({
+    url: 'https://api.example.com/stream',
+    method: 'POST',
+    getBody: () => JSON.stringify({ prompt: '你好' }),
+    headers: { 'Content-Type': 'application/json' },
+    plugins: recommendedPlugins(),
+    onMessage: (data) => console.log(data),
+    onError: (err) => console.error(err),
+  })
+
+  return (
+    <div>
+      <button onClick={start} disabled={loading}>发送</button>
+      <button onClick={stop}>停止</button>
+      <p>{status}</p>
+      <pre>{text}</pre>
+    </div>
+  )
+}
+```
+
+## API
+
+### `useSSEStream(options)`
+
+#### 入参 `UseSSEStreamOptions`
+
+继承 `PluginSSEOptions` 的核心字段，并追加事件回调与动态 body：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `url` | `string` | 请求地址（必填） |
+| `method` | `'GET' \| 'POST'` | 请求方法，默认 `GET` |
+| `body` | `string` | 请求体字符串 |
+| `getBody` | `() => string` | 每次 `start` 时动态生成请求体，优先级高于 `body` |
+| `headers` | `Record<string, string>` | 自定义请求头 |
+| `transport` | `string \| TransportFactory` | 传输层，省略则自动探测 `fetch` |
+| `parser` | `ParserFactory` | 自定义解析器 |
+| `plugins` | `SSEPlugin[]` | 插件列表 |
+| `onMessage` | `(data, event) => void` | 收到 message 事件回调 |
+| `onOpen` | `(info: { transport }) => void` | 连接打开回调 |
+| `onEnd` | `() => void` | 流结束回调 |
+| `onError` | `(err) => void` | 错误回调 |
+
+> 事件回调通过 `ref` 始终取最新值，不会出现闭包过期问题。
+
+#### 返回值 `UseSSEStreamReturn`
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `text` | `string` | 已拼接的消息文本（`message` 事件 `data` 累加） |
+| `status` | `string` | 连接状态描述 |
+| `loading` | `boolean` | 是否处于连接中/流式接收中 |
+| `msgCount` | `number` | 已接收 message 事件条数 |
+| `charCount` | `number` | 已接收字符总数 |
+| `start` | `() => void` | 发起一次连接（先销毁旧连接） |
+| `stop` | `() => void` | 手动断开并销毁实例 |
+| `instance` | `PluginSSE \| null` | 当前实例（便于 `use()` 追加插件等高级操作） |
+
+## 生命周期
+
+- 组件卸载时自动 `destroy()` 实例并清空订阅，无需手动清理
+- `start()` 会先销毁旧连接再创建新连接，可重复调用
+
+## 高级用法
+
+### 通过 `instance` 追加插件
+
+```tsx
+const { instance, start } = useSSEStream({ url, method: 'POST' })
+
+useEffect(() => {
+  if (instance) {
+    instance.use(loggerPlugin())
+  }
+}, [instance])
+```
+
+### 小程序环境
+
+通过 `transport` 传入小程序传输层工厂：
+
+```tsx
+import { createMpTransport } from 'sse-stream-plugin-sdk'
+
+useSSEStream({
+  url,
+  transport: createMpTransport(() => wx),
+})
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,92 @@
+'use strict';
+
+var react = require('react');
+var sseStreamPluginSdk = require('sse-stream-plugin-sdk');
+
+/**
+ * @file React Hook：将插件化 SSE SDK 封装为声明式响应式 API
+ * @description
+ * - 实例用 useRef 持有，不进入 React 状态；
+ * - start() 内按需创建 PluginSSE，组件卸载时自动 destroy()；
+ * - 事件回调通过 optionsRef 始终取最新值，避免闭包过期；
+ * - 暴露 text/status/loading 等响应式状态与 start/stop 方法。
+ */
+function useSSEStream(options) {
+    // 始终保存最新入参，start 内读取，保证回调与配置不过期
+    const optionsRef = react.useRef(options);
+    optionsRef.current = options;
+    const sseRef = react.useRef(null);
+    const [text, setText] = react.useState('');
+    const [status, setStatus] = react.useState('未连接');
+    const [loading, setLoading] = react.useState(false);
+    const [msgCount, setMsgCount] = react.useState(0);
+    const [charCount, setCharCount] = react.useState(0);
+    // 组件卸载：释放连接、清空订阅
+    react.useEffect(() => {
+        return () => {
+            sseRef.current?.destroy();
+            sseRef.current = null;
+        };
+    }, []);
+    const stop = react.useCallback(() => {
+        sseRef.current?.destroy();
+        sseRef.current = null;
+        setStatus('已手动断开');
+        setLoading(false);
+    }, []);
+    const start = react.useCallback(() => {
+        const { url, method, body, headers, transport, parser, plugins, getBody, onMessage, onOpen, onEnd, onError, } = optionsRef.current;
+        // 销毁旧连接（含旧实例的全部事件订阅）
+        sseRef.current?.destroy();
+        setText('');
+        setMsgCount(0);
+        setCharCount(0);
+        setStatus('连接中…');
+        setLoading(true);
+        const sse = new sseStreamPluginSdk.PluginSSE({
+            url,
+            method: method ?? 'GET',
+            body: getBody ? getBody() : body,
+            headers,
+            transport,
+            parser,
+            plugins,
+        });
+        sse.on('open', ({ transport: name }) => {
+            setStatus(`已连接（${name}）`);
+            onOpen?.({ transport: name });
+        });
+        sse.on('message', (data, event) => {
+            setText((prev) => prev + data);
+            setMsgCount((n) => n + 1);
+            setCharCount((n) => n + data.length);
+            onMessage?.(data, event);
+        });
+        sse.on('end', () => {
+            setStatus('流正常结束');
+            setLoading(false);
+            onEnd?.();
+        });
+        sse.on('error', (err) => {
+            const msg = err instanceof Error ? err.message : String(err);
+            setStatus(`错误：${msg}`);
+            setLoading(false);
+            onError?.(err);
+        });
+        sseRef.current = sse;
+        sse.connect();
+    }, []);
+    return {
+        text,
+        status,
+        loading,
+        msgCount,
+        charCount,
+        start,
+        stop,
+        instance: sseRef.current,
+    };
+}
+
+exports.useSSEStream = useSSEStream;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/useSSEStream.ts"],"sourcesContent":[null],"names":["useRef","useState","useEffect","useCallback","PluginSSE"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import { PluginSSEOptions, ParsedEvent, PluginSSE } from 'sse-stream-plugin-sdk';
+
+/**
+ * Hook 入参：在核心 PluginSSEOptions 基础上追加动态 body 与事件回调
+ */
+interface UseSSEStreamOptions extends Pick<PluginSSEOptions, 'url' | 'method' | 'body' | 'headers' | 'transport' | 'parser' | 'plugins'> {
+    /** 每次 start 时动态生成请求体（如带当前 prompt），优先级高于 body */
+    getBody?: () => string;
+    onMessage?: (data: string, event: ParsedEvent) => void;
+    onOpen?: (info: {
+        transport: string;
+    }) => void;
+    onEnd?: () => void;
+    onError?: (err: unknown) => void;
+}
+interface UseSSEStreamReturn {
+    /** 已拼接的消息文本（message 事件 data 累加） */
+    text: string;
+    /** 连接状态描述 */
+    status: string;
+    /** 是否处于连接中/流式接收中 */
+    loading: boolean;
+    /** 已接收 message 事件条数 */
+    msgCount: number;
+    /** 已接收字符总数 */
+    charCount: number;
+    /** 发起一次连接（先销毁旧连接） */
+    start: () => void;
+    /** 手动断开并销毁实例 */
+    stop: () => void;
+    /** 当前 PluginSSE 实例（便于 use() 追加插件等高级操作） */
+    instance: PluginSSE | null;
+}
+declare function useSSEStream(options: UseSSEStreamOptions): UseSSEStreamReturn;
+
+export { useSSEStream };
+export type { UseSSEStreamOptions, UseSSEStreamReturn };

package/dist/index.mjs

@@ -0,0 +1,90 @@
+import { useRef, useState, useEffect, useCallback } from 'react';
+import { PluginSSE } from 'sse-stream-plugin-sdk';
+
+/**
+ * @file React Hook：将插件化 SSE SDK 封装为声明式响应式 API
+ * @description
+ * - 实例用 useRef 持有，不进入 React 状态；
+ * - start() 内按需创建 PluginSSE，组件卸载时自动 destroy()；
+ * - 事件回调通过 optionsRef 始终取最新值，避免闭包过期；
+ * - 暴露 text/status/loading 等响应式状态与 start/stop 方法。
+ */
+function useSSEStream(options) {
+    // 始终保存最新入参，start 内读取，保证回调与配置不过期
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const sseRef = useRef(null);
+    const [text, setText] = useState('');
+    const [status, setStatus] = useState('未连接');
+    const [loading, setLoading] = useState(false);
+    const [msgCount, setMsgCount] = useState(0);
+    const [charCount, setCharCount] = useState(0);
+    // 组件卸载：释放连接、清空订阅
+    useEffect(() => {
+        return () => {
+            sseRef.current?.destroy();
+            sseRef.current = null;
+        };
+    }, []);
+    const stop = useCallback(() => {
+        sseRef.current?.destroy();
+        sseRef.current = null;
+        setStatus('已手动断开');
+        setLoading(false);
+    }, []);
+    const start = useCallback(() => {
+        const { url, method, body, headers, transport, parser, plugins, getBody, onMessage, onOpen, onEnd, onError, } = optionsRef.current;
+        // 销毁旧连接（含旧实例的全部事件订阅）
+        sseRef.current?.destroy();
+        setText('');
+        setMsgCount(0);
+        setCharCount(0);
+        setStatus('连接中…');
+        setLoading(true);
+        const sse = new PluginSSE({
+            url,
+            method: method ?? 'GET',
+            body: getBody ? getBody() : body,
+            headers,
+            transport,
+            parser,
+            plugins,
+        });
+        sse.on('open', ({ transport: name }) => {
+            setStatus(`已连接（${name}）`);
+            onOpen?.({ transport: name });
+        });
+        sse.on('message', (data, event) => {
+            setText((prev) => prev + data);
+            setMsgCount((n) => n + 1);
+            setCharCount((n) => n + data.length);
+            onMessage?.(data, event);
+        });
+        sse.on('end', () => {
+            setStatus('流正常结束');
+            setLoading(false);
+            onEnd?.();
+        });
+        sse.on('error', (err) => {
+            const msg = err instanceof Error ? err.message : String(err);
+            setStatus(`错误：${msg}`);
+            setLoading(false);
+            onError?.(err);
+        });
+        sseRef.current = sse;
+        sse.connect();
+    }, []);
+    return {
+        text,
+        status,
+        loading,
+        msgCount,
+        charCount,
+        start,
+        stop,
+        instance: sseRef.current,
+    };
+}
+
+export { useSSEStream };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/useSSEStream.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "sse-stream-plugin-react",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "React Hooks for sse-stream-plugin-sdk",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "sse",
+    "server-sent-events",
+    "stream",
+    "react",
+    "hooks"
+  ],
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "build:prod": "rollup -c --environment NODE_ENV:production"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "sse-stream-plugin-sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.18",
+    "react": "^19.2.8",
+    "sse-stream-plugin-sdk": "workspace:*"
+  }
+}