chat-nest-sdk 1.0.1 → 1.1.0

package/README.md

@@ -1,26 +1,29 @@
 # chat-nest-sdk
 
-> Frontend SDK for Chat Nest providing a simple React hook to consume streaming AI APIs safely.
+> Frontend SDK for Chat Nest providing a simple React hook to consume streaming AI APIs safely using Server-Side Events (SSE).
 
 This package handles:
-- Streaming response handling
+- Server-Side Events (SSE) streaming response handling
+- Real-time token streaming via SSE protocol
 - Cancellation propagation
 - Intelligent retry behavior
 - Error normalization
 - Message state management
 
-Designed for production usage in React applications.
+Designed for production usage in React applications. Uses SSE for efficient, bidirectional communication with the backend.
 
 ---
 
 ## ✨ Features
 
-- Streaming token handling
+- Server-Side Events (SSE) streaming protocol
+- Real-time token streaming via SSE events
 - Abort-safe cancellation
 - Retry only on network / server failures
 - No retries on client or policy errors
 - Message state management
 - Lightweight and framework-friendly
+- Efficient SSE event parsing (`token`, `done`, `error`, `ping`, `start` events)
 
 ---
 
@@ -96,6 +99,8 @@ Cancel immediately stops streaming and billing.
 
 Network failures retry automatically.
 
+**Server-Side Events (SSE)**: The SDK communicates with the backend using the SSE protocol. The backend must send events in SSE format (`event: <type>\ndata: <data>\n\n`). Supported event types: `start`, `token`, `done`, `error`, `ping`.
+
 ---
 
 ## 📄 License

package/dist/index.js

@@ -54,6 +54,7 @@ var FetchAiClient = class {
       () => this.abortController?.abort(),
       this.config.timeoutMs
     );
+    let completed = false;
     try {
       const response = await fetch(this.config.endpoint, {
         method: "POST",
@@ -75,13 +76,64 @@ var FetchAiClient = class {
       }
       const reader = response.body.getReader();
       const decoder = new TextDecoder();
+      let buffer = "";
       while (true) {
+        if (this.abortController.signal.aborted) {
+          throw new DOMException("Aborted", "AbortError");
+        }
         const { value, done } = await reader.read();
+        if (value) {
+          buffer += decoder.decode(value, { stream: true });
+        }
+        const events = buffer.split("\n\n");
+        buffer = events.pop() || "";
+        for (const eventText of events) {
+          if (!eventText.trim()) continue;
+          let eventType = "";
+          let eventDataParts = [];
+          for (const line of eventText.split("\n")) {
+            if (line.startsWith("event:")) {
+              eventType = line.substring(6).trim();
+            } else if (line.startsWith("data:")) {
+              eventDataParts.push(line.substring(5).trim());
+            }
+          }
+          const eventData = eventDataParts.join("\n");
+          switch (eventType) {
+            case "token": {
+              try {
+                const token = JSON.parse(eventData);
+                callbacks.onToken(token);
+              } catch {
+                callbacks.onToken(eventData);
+              }
+              break;
+            }
+            case "done":
+              completed = true;
+              callbacks.onComplete();
+              return;
+            case "error":
+              completed = true;
+              try {
+                const errorObj = JSON.parse(eventData);
+                callbacks.onError(
+                  new Error(errorObj.message || "Stream error")
+                );
+              } catch {
+                callbacks.onError(new Error(eventData || "Stream error"));
+              }
+              return;
+            case "ping":
+            case "start":
+              break;
+          }
+        }
         if (done) break;
-        const chunk = decoder.decode(value, { stream: true });
-        callbacks.onToken(chunk);
       }
-      callbacks.onComplete();
+      if (!completed) {
+        callbacks.onComplete();
+      }
     } finally {
       clearTimeout(timeoutId);
     }

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "chat-nest-sdk",
 	"description": "Frontend React SDK for consuming streaming AI APIs with cancellation and retry safety.",
-	"version": "1.0.1",
+	"version": "1.1.0",
 	"type": "module",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",