@deltakit/react 0.1.0

package/dist/index.cjs

@@ -0,0 +1,195 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  fromOpenAiAgents: () => import_core2.fromOpenAiAgents,
+  parseSSEStream: () => import_core2.parseSSEStream,
+  useStreamChat: () => useStreamChat
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/use-stream-chat.ts
+var import_react = require("react");
+var import_core = require("@deltakit/core");
+var counter = 0;
+function generateId() {
+  return `msg_${Date.now()}_${++counter}`;
+}
+function createMessage(role, parts) {
+  return { id: generateId(), role, parts };
+}
+function defaultOnEvent(event, helpers) {
+  if (event.type === "text_delta") {
+    helpers.appendText(event.delta);
+  }
+}
+function useStreamChat(options) {
+  const {
+    api,
+    headers,
+    body,
+    initialMessages,
+    onEvent,
+    onMessage,
+    onError,
+    onFinish
+  } = options;
+  const [messages, setMessages] = (0, import_react.useState)(
+    initialMessages ?? []
+  );
+  const [isLoading, setIsLoading] = (0, import_react.useState)(false);
+  const [error, setError] = (0, import_react.useState)(null);
+  const abortRef = (0, import_react.useRef)(null);
+  const messagesRef = (0, import_react.useRef)(messages);
+  messagesRef.current = messages;
+  const appendText = (0, import_react.useCallback)((delta) => {
+    setMessages((prev) => {
+      const last = prev[prev.length - 1];
+      if (!last || last.role !== "assistant") return prev;
+      const parts = [...last.parts];
+      const lastPart = parts[parts.length - 1];
+      if (lastPart && lastPart.type === "text" && "text" in lastPart) {
+        const textPart = lastPart;
+        parts[parts.length - 1] = {
+          ...lastPart,
+          text: textPart.text + delta
+        };
+      } else {
+        parts.push({ type: "text", text: delta });
+      }
+      const updated = { ...last, parts };
+      return [...prev.slice(0, -1), updated];
+    });
+  }, []);
+  const appendPart = (0, import_react.useCallback)((part) => {
+    setMessages((prev) => {
+      const last = prev[prev.length - 1];
+      if (!last || last.role !== "assistant") return prev;
+      const updated = {
+        ...last,
+        parts: [...last.parts, part]
+      };
+      return [...prev.slice(0, -1), updated];
+    });
+  }, []);
+  const stop = (0, import_react.useCallback)(() => {
+    abortRef.current?.abort();
+    abortRef.current = null;
+    setIsLoading(false);
+  }, []);
+  const sendMessage = (0, import_react.useCallback)(
+    (text) => {
+      if (abortRef.current) {
+        return;
+      }
+      const userMessage = createMessage("user", [
+        { type: "text", text }
+      ]);
+      const assistantMessage = createMessage("assistant", []);
+      setMessages((prev) => {
+        const next = [...prev, userMessage, assistantMessage];
+        messagesRef.current = next;
+        return next;
+      });
+      onMessage?.(userMessage);
+      setError(null);
+      setIsLoading(true);
+      const controller = new AbortController();
+      abortRef.current = controller;
+      const eventHandler = onEvent ?? defaultOnEvent;
+      const helpers = {
+        appendText,
+        appendPart,
+        setMessages
+      };
+      (async () => {
+        try {
+          const response = await fetch(api, {
+            method: "POST",
+            headers: {
+              "Content-Type": "application/json",
+              ...headers
+            },
+            body: JSON.stringify({ message: text, ...body }),
+            signal: controller.signal
+          });
+          if (!response.ok) {
+            throw new Error(
+              `SSE request failed: ${response.status} ${response.statusText}`
+            );
+          }
+          if (!response.body) {
+            throw new Error(
+              "Response body is null \u2014 SSE streaming not supported"
+            );
+          }
+          for await (const event of (0, import_core.parseSSEStream)(
+            response.body,
+            controller.signal
+          )) {
+            eventHandler(event, helpers);
+          }
+          const finalMessages = messagesRef.current;
+          const lastMessage = finalMessages[finalMessages.length - 1];
+          if (lastMessage?.role === "assistant") {
+            onMessage?.(lastMessage);
+          }
+          onFinish?.(finalMessages);
+        } catch (err) {
+          if (err instanceof DOMException && err.name === "AbortError") {
+            return;
+          }
+          const error2 = err instanceof Error ? err : new Error(String(err));
+          setError(error2);
+          onError?.(error2);
+        } finally {
+          abortRef.current = null;
+          setIsLoading(false);
+        }
+      })();
+    },
+    [api, headers, body, onEvent, onMessage, onError, onFinish, appendText, appendPart]
+  );
+  (0, import_react.useEffect)(() => {
+    return () => {
+      abortRef.current?.abort();
+      abortRef.current = null;
+    };
+  }, []);
+  return {
+    messages,
+    isLoading,
+    error,
+    sendMessage,
+    stop,
+    setMessages
+  };
+}
+
+// src/index.ts
+var import_core2 = require("@deltakit/core");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  fromOpenAiAgents,
+  parseSSEStream,
+  useStreamChat
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/use-stream-chat.ts"],"sourcesContent":["export { useStreamChat } from \"./use-stream-chat\";\n\nexport type {\n  EventHelpers,\n  UseStreamChatOptions,\n  UseStreamChatReturn,\n} from \"./types\";\n\n// Re-export core types so consumers only need to import from @deltakit/react\nexport type {\n  TextPart,\n  ToolCallPart,\n  ReasoningPart,\n  ContentPart,\n  Message,\n  TextDeltaEvent,\n  ToolCallEvent,\n  ToolResultEvent,\n  SSEEvent,\n} from \"@deltakit/core\";\n\nexport { parseSSEStream, fromOpenAiAgents } from \"@deltakit/core\";\n","import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { parseSSEStream } from \"@deltakit/core\";\nimport type {\n  ContentPart,\n  Message,\n  SSEEvent,\n} from \"@deltakit/core\";\nimport type {\n  EventHelpers,\n  UseStreamChatOptions,\n  UseStreamChatReturn,\n} from \"./types\";\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nlet counter = 0;\n\nfunction generateId(): string {\n  return `msg_${Date.now()}_${++counter}`;\n}\n\nfunction createMessage<TPart extends { type: string }>(\n  role: Message[\"role\"],\n  parts: TPart[],\n): Message<TPart> {\n  return { id: generateId(), role, parts };\n}\n\n// ---------------------------------------------------------------------------\n// Default event handler — accumulates `text_delta` into the last\n// assistant message's parts.\n// ---------------------------------------------------------------------------\n\nfunction defaultOnEvent(\n  event: SSEEvent,\n  helpers: EventHelpers<ContentPart>,\n): void {\n  if (event.type === \"text_delta\") {\n    helpers.appendText(event.delta);\n  }\n  // Other event types (e.g. tool_call) are silently ignored by default.\n  // Users can provide their own `onEvent` to handle them.\n}\n\n// ---------------------------------------------------------------------------\n// useStreamChat\n// ---------------------------------------------------------------------------\n\nexport function useStreamChat<\n  TPart extends { type: string } = ContentPart,\n  TEvent extends { type: string } = SSEEvent,\n>(options: UseStreamChatOptions<TPart, TEvent>): UseStreamChatReturn<TPart> {\n  const {\n    api,\n    headers,\n    body,\n    initialMessages,\n    onEvent,\n    onMessage,\n    onError,\n    onFinish,\n  } = options;\n\n  const [messages, setMessages] = useState<Message<TPart>[]>(\n    initialMessages ?? [],\n  );\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const abortRef = useRef<AbortController | null>(null);\n\n  // We use a ref for the latest messages so that callbacks created inside\n  // `sendMessage` always see the current value without re-creating closures.\n  const messagesRef = useRef<Message<TPart>[]>(messages);\n  messagesRef.current = messages;\n\n  // -----------------------------------------------------------------------\n  // appendText — append a text delta to the last text part of the last\n  // assistant message, or create a new text part if needed.\n  // -----------------------------------------------------------------------\n\n  const appendText = useCallback((delta: string) => {\n    setMessages((prev) => {\n      const last = prev[prev.length - 1];\n      if (!last || last.role !== \"assistant\") return prev;\n\n      const parts = [...last.parts];\n      const lastPart = parts[parts.length - 1];\n\n      if (lastPart && lastPart.type === \"text\" && \"text\" in lastPart) {\n        // Append to existing text part\n        const textPart = lastPart as { type: \"text\"; text: string };\n        parts[parts.length - 1] = {\n          ...lastPart,\n          text: textPart.text + delta,\n        } as unknown as TPart;\n      } else {\n        // Create a new text part\n        parts.push({ type: \"text\", text: delta } as unknown as TPart);\n      }\n\n      const updated: Message<TPart> = { ...last, parts };\n      return [...prev.slice(0, -1), updated];\n    });\n  }, []);\n\n  // -----------------------------------------------------------------------\n  // appendPart — push a new content part to the last assistant message.\n  // -----------------------------------------------------------------------\n\n  const appendPart = useCallback((part: TPart) => {\n    setMessages((prev) => {\n      const last = prev[prev.length - 1];\n      if (!last || last.role !== \"assistant\") return prev;\n\n      const updated: Message<TPart> = {\n        ...last,\n        parts: [...last.parts, part],\n      };\n      return [...prev.slice(0, -1), updated];\n    });\n  }, []);\n\n  // -----------------------------------------------------------------------\n  // stop\n  // -----------------------------------------------------------------------\n\n  const stop = useCallback(() => {\n    abortRef.current?.abort();\n    abortRef.current = null;\n    setIsLoading(false);\n  }, []);\n\n  // -----------------------------------------------------------------------\n  // sendMessage\n  // -----------------------------------------------------------------------\n\n  const sendMessage = useCallback(\n    (text: string) => {\n      // Prevent sending while already streaming.\n      if (abortRef.current) {\n        return;\n      }\n\n      const userMessage = createMessage<TPart>(\"user\", [\n        { type: \"text\", text } as unknown as TPart,\n      ]);\n      const assistantMessage = createMessage<TPart>(\"assistant\", []);\n\n      setMessages((prev) => {\n        const next = [...prev, userMessage, assistantMessage];\n        messagesRef.current = next;\n        return next;\n      });\n\n      onMessage?.(userMessage);\n\n      setError(null);\n      setIsLoading(true);\n\n      const controller = new AbortController();\n      abortRef.current = controller;\n\n      const eventHandler =\n        onEvent ??\n        (defaultOnEvent as unknown as (\n          event: TEvent,\n          helpers: EventHelpers<TPart>,\n        ) => void);\n      const helpers: EventHelpers<TPart> = {\n        appendText,\n        appendPart,\n        setMessages,\n      };\n\n      // Fire-and-forget async IIFE — state is managed via React setState.\n      (async () => {\n        try {\n          const response = await fetch(api, {\n            method: \"POST\",\n            headers: {\n              \"Content-Type\": \"application/json\",\n              ...headers,\n            },\n            body: JSON.stringify({ message: text, ...body }),\n            signal: controller.signal,\n          });\n\n          if (!response.ok) {\n            throw new Error(\n              `SSE request failed: ${response.status} ${response.statusText}`,\n            );\n          }\n\n          if (!response.body) {\n            throw new Error(\n              \"Response body is null — SSE streaming not supported\",\n            );\n          }\n\n          for await (const event of parseSSEStream(\n            response.body,\n            controller.signal,\n          )) {\n            eventHandler(event as unknown as TEvent, helpers);\n          }\n\n          // Stream finished — notify via callbacks.\n          const finalMessages = messagesRef.current;\n          const lastMessage = finalMessages[finalMessages.length - 1];\n\n          if (lastMessage?.role === \"assistant\") {\n            onMessage?.(lastMessage);\n          }\n\n          onFinish?.(finalMessages);\n        } catch (err) {\n          // AbortError is expected when the user calls `stop()`.\n          if (err instanceof DOMException && err.name === \"AbortError\") {\n            return;\n          }\n\n          const error = err instanceof Error ? err : new Error(String(err));\n\n          setError(error);\n          onError?.(error);\n        } finally {\n          abortRef.current = null;\n          setIsLoading(false);\n        }\n      })();\n    },\n    [api, headers, body, onEvent, onMessage, onError, onFinish, appendText, appendPart],\n  );\n\n  // -----------------------------------------------------------------------\n  // Cleanup — abort any in-flight stream when the component unmounts.\n  // -----------------------------------------------------------------------\n\n  useEffect(() => {\n    return () => {\n      abortRef.current?.abort();\n      abortRef.current = null;\n    };\n  }, []);\n\n  return {\n    messages,\n    isLoading,\n    error,\n    sendMessage,\n    stop,\n    setMessages,\n  };\n}\n"],"mappings":"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","names":["error","import_core"]}

package/dist/index.d.cts

@@ -0,0 +1,67 @@
+import { ContentPart, Message, SSEEvent } from '@deltakit/core';
+export { ContentPart, Message, ReasoningPart, SSEEvent, TextDeltaEvent, TextPart, ToolCallEvent, ToolCallPart, ToolResultEvent, fromOpenAiAgents, parseSSEStream } from '@deltakit/core';
+import { Dispatch, SetStateAction } from 'react';
+
+interface EventHelpers<TPart extends {
+    type: string;
+} = ContentPart> {
+    /** Append a text delta to the last text part of the current assistant message, or create a new text part. */
+    appendText: (delta: string) => void;
+    /** Append a new content part to the current assistant message. */
+    appendPart: (part: TPart) => void;
+    /** Direct access to the messages state setter for advanced use-cases. */
+    setMessages: Dispatch<SetStateAction<Message<TPart>[]>>;
+}
+interface UseStreamChatOptions<TPart extends {
+    type: string;
+} = ContentPart, TEvent extends {
+    type: string;
+} = SSEEvent> {
+    /** SSE endpoint URL. */
+    api: string;
+    /** Initial messages to prepopulate the chat (e.g. from a database or previous session). */
+    initialMessages?: Message<TPart>[];
+    /** Extra headers merged into every fetch request. */
+    headers?: Record<string, string>;
+    /** Extra fields merged into the POST body alongside `message`. */
+    body?: Record<string, unknown>;
+    /**
+     * Custom handler for each SSE event. When provided, this **replaces** the
+     * default `text_delta` handling — giving you full control over how events
+     * are mapped to message state.
+     *
+     * The `event` parameter is typed as `TEvent`, which defaults to `SSEEvent`.
+     * Pass a custom event union as the second generic to handle additional event types.
+     */
+    onEvent?: (event: TEvent, helpers: EventHelpers<TPart>) => void;
+    /** Called when the assistant message is complete (stream ended). */
+    onFinish?: (messages: Message<TPart>[]) => void;
+    /** Called whenever a new complete message (user or assistant) is added. */
+    onMessage?: (message: Message<TPart>) => void;
+    /** Called when a fetch or stream error occurs. */
+    onError?: (error: Error) => void;
+}
+interface UseStreamChatReturn<TPart extends {
+    type: string;
+} = ContentPart> {
+    /** Chronological list of messages in the conversation. */
+    messages: Message<TPart>[];
+    /** `true` while the assistant is streaming a response. */
+    isLoading: boolean;
+    /** The most recent error, or `null`. */
+    error: Error | null;
+    /** Send a user message and begin streaming the assistant response. */
+    sendMessage: (text: string) => void;
+    /** Abort the current stream. */
+    stop: () => void;
+    /** Direct setter for programmatic message manipulation (clear, prepopulate, etc.). */
+    setMessages: Dispatch<SetStateAction<Message<TPart>[]>>;
+}
+
+declare function useStreamChat<TPart extends {
+    type: string;
+} = ContentPart, TEvent extends {
+    type: string;
+} = SSEEvent>(options: UseStreamChatOptions<TPart, TEvent>): UseStreamChatReturn<TPart>;
+
+export { type EventHelpers, type UseStreamChatOptions, type UseStreamChatReturn, useStreamChat };

package/dist/index.d.ts

@@ -0,0 +1,67 @@
+import { ContentPart, Message, SSEEvent } from '@deltakit/core';
+export { ContentPart, Message, ReasoningPart, SSEEvent, TextDeltaEvent, TextPart, ToolCallEvent, ToolCallPart, ToolResultEvent, fromOpenAiAgents, parseSSEStream } from '@deltakit/core';
+import { Dispatch, SetStateAction } from 'react';
+
+interface EventHelpers<TPart extends {
+    type: string;
+} = ContentPart> {
+    /** Append a text delta to the last text part of the current assistant message, or create a new text part. */
+    appendText: (delta: string) => void;
+    /** Append a new content part to the current assistant message. */
+    appendPart: (part: TPart) => void;
+    /** Direct access to the messages state setter for advanced use-cases. */
+    setMessages: Dispatch<SetStateAction<Message<TPart>[]>>;
+}
+interface UseStreamChatOptions<TPart extends {
+    type: string;
+} = ContentPart, TEvent extends {
+    type: string;
+} = SSEEvent> {
+    /** SSE endpoint URL. */
+    api: string;
+    /** Initial messages to prepopulate the chat (e.g. from a database or previous session). */
+    initialMessages?: Message<TPart>[];
+    /** Extra headers merged into every fetch request. */
+    headers?: Record<string, string>;
+    /** Extra fields merged into the POST body alongside `message`. */
+    body?: Record<string, unknown>;
+    /**
+     * Custom handler for each SSE event. When provided, this **replaces** the
+     * default `text_delta` handling — giving you full control over how events
+     * are mapped to message state.
+     *
+     * The `event` parameter is typed as `TEvent`, which defaults to `SSEEvent`.
+     * Pass a custom event union as the second generic to handle additional event types.
+     */
+    onEvent?: (event: TEvent, helpers: EventHelpers<TPart>) => void;
+    /** Called when the assistant message is complete (stream ended). */
+    onFinish?: (messages: Message<TPart>[]) => void;
+    /** Called whenever a new complete message (user or assistant) is added. */
+    onMessage?: (message: Message<TPart>) => void;
+    /** Called when a fetch or stream error occurs. */
+    onError?: (error: Error) => void;
+}
+interface UseStreamChatReturn<TPart extends {
+    type: string;
+} = ContentPart> {
+    /** Chronological list of messages in the conversation. */
+    messages: Message<TPart>[];
+    /** `true` while the assistant is streaming a response. */
+    isLoading: boolean;
+    /** The most recent error, or `null`. */
+    error: Error | null;
+    /** Send a user message and begin streaming the assistant response. */
+    sendMessage: (text: string) => void;
+    /** Abort the current stream. */
+    stop: () => void;
+    /** Direct setter for programmatic message manipulation (clear, prepopulate, etc.). */
+    setMessages: Dispatch<SetStateAction<Message<TPart>[]>>;
+}
+
+declare function useStreamChat<TPart extends {
+    type: string;
+} = ContentPart, TEvent extends {
+    type: string;
+} = SSEEvent>(options: UseStreamChatOptions<TPart, TEvent>): UseStreamChatReturn<TPart>;
+
+export { type EventHelpers, type UseStreamChatOptions, type UseStreamChatReturn, useStreamChat };

package/dist/index.js

@@ -0,0 +1,166 @@
+// src/use-stream-chat.ts
+import { useCallback, useEffect, useRef, useState } from "react";
+import { parseSSEStream } from "@deltakit/core";
+var counter = 0;
+function generateId() {
+  return `msg_${Date.now()}_${++counter}`;
+}
+function createMessage(role, parts) {
+  return { id: generateId(), role, parts };
+}
+function defaultOnEvent(event, helpers) {
+  if (event.type === "text_delta") {
+    helpers.appendText(event.delta);
+  }
+}
+function useStreamChat(options) {
+  const {
+    api,
+    headers,
+    body,
+    initialMessages,
+    onEvent,
+    onMessage,
+    onError,
+    onFinish
+  } = options;
+  const [messages, setMessages] = useState(
+    initialMessages ?? []
+  );
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const abortRef = useRef(null);
+  const messagesRef = useRef(messages);
+  messagesRef.current = messages;
+  const appendText = useCallback((delta) => {
+    setMessages((prev) => {
+      const last = prev[prev.length - 1];
+      if (!last || last.role !== "assistant") return prev;
+      const parts = [...last.parts];
+      const lastPart = parts[parts.length - 1];
+      if (lastPart && lastPart.type === "text" && "text" in lastPart) {
+        const textPart = lastPart;
+        parts[parts.length - 1] = {
+          ...lastPart,
+          text: textPart.text + delta
+        };
+      } else {
+        parts.push({ type: "text", text: delta });
+      }
+      const updated = { ...last, parts };
+      return [...prev.slice(0, -1), updated];
+    });
+  }, []);
+  const appendPart = useCallback((part) => {
+    setMessages((prev) => {
+      const last = prev[prev.length - 1];
+      if (!last || last.role !== "assistant") return prev;
+      const updated = {
+        ...last,
+        parts: [...last.parts, part]
+      };
+      return [...prev.slice(0, -1), updated];
+    });
+  }, []);
+  const stop = useCallback(() => {
+    abortRef.current?.abort();
+    abortRef.current = null;
+    setIsLoading(false);
+  }, []);
+  const sendMessage = useCallback(
+    (text) => {
+      if (abortRef.current) {
+        return;
+      }
+      const userMessage = createMessage("user", [
+        { type: "text", text }
+      ]);
+      const assistantMessage = createMessage("assistant", []);
+      setMessages((prev) => {
+        const next = [...prev, userMessage, assistantMessage];
+        messagesRef.current = next;
+        return next;
+      });
+      onMessage?.(userMessage);
+      setError(null);
+      setIsLoading(true);
+      const controller = new AbortController();
+      abortRef.current = controller;
+      const eventHandler = onEvent ?? defaultOnEvent;
+      const helpers = {
+        appendText,
+        appendPart,
+        setMessages
+      };
+      (async () => {
+        try {
+          const response = await fetch(api, {
+            method: "POST",
+            headers: {
+              "Content-Type": "application/json",
+              ...headers
+            },
+            body: JSON.stringify({ message: text, ...body }),
+            signal: controller.signal
+          });
+          if (!response.ok) {
+            throw new Error(
+              `SSE request failed: ${response.status} ${response.statusText}`
+            );
+          }
+          if (!response.body) {
+            throw new Error(
+              "Response body is null \u2014 SSE streaming not supported"
+            );
+          }
+          for await (const event of parseSSEStream(
+            response.body,
+            controller.signal
+          )) {
+            eventHandler(event, helpers);
+          }
+          const finalMessages = messagesRef.current;
+          const lastMessage = finalMessages[finalMessages.length - 1];
+          if (lastMessage?.role === "assistant") {
+            onMessage?.(lastMessage);
+          }
+          onFinish?.(finalMessages);
+        } catch (err) {
+          if (err instanceof DOMException && err.name === "AbortError") {
+            return;
+          }
+          const error2 = err instanceof Error ? err : new Error(String(err));
+          setError(error2);
+          onError?.(error2);
+        } finally {
+          abortRef.current = null;
+          setIsLoading(false);
+        }
+      })();
+    },
+    [api, headers, body, onEvent, onMessage, onError, onFinish, appendText, appendPart]
+  );
+  useEffect(() => {
+    return () => {
+      abortRef.current?.abort();
+      abortRef.current = null;
+    };
+  }, []);
+  return {
+    messages,
+    isLoading,
+    error,
+    sendMessage,
+    stop,
+    setMessages
+  };
+}
+
+// src/index.ts
+import { parseSSEStream as parseSSEStream2, fromOpenAiAgents } from "@deltakit/core";
+export {
+  fromOpenAiAgents,
+  parseSSEStream2 as parseSSEStream,
+  useStreamChat
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-stream-chat.ts","../src/index.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { parseSSEStream } from \"@deltakit/core\";\nimport type {\n  ContentPart,\n  Message,\n  SSEEvent,\n} from \"@deltakit/core\";\nimport type {\n  EventHelpers,\n  UseStreamChatOptions,\n  UseStreamChatReturn,\n} from \"./types\";\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nlet counter = 0;\n\nfunction generateId(): string {\n  return `msg_${Date.now()}_${++counter}`;\n}\n\nfunction createMessage<TPart extends { type: string }>(\n  role: Message[\"role\"],\n  parts: TPart[],\n): Message<TPart> {\n  return { id: generateId(), role, parts };\n}\n\n// ---------------------------------------------------------------------------\n// Default event handler — accumulates `text_delta` into the last\n// assistant message's parts.\n// ---------------------------------------------------------------------------\n\nfunction defaultOnEvent(\n  event: SSEEvent,\n  helpers: EventHelpers<ContentPart>,\n): void {\n  if (event.type === \"text_delta\") {\n    helpers.appendText(event.delta);\n  }\n  // Other event types (e.g. tool_call) are silently ignored by default.\n  // Users can provide their own `onEvent` to handle them.\n}\n\n// ---------------------------------------------------------------------------\n// useStreamChat\n// ---------------------------------------------------------------------------\n\nexport function useStreamChat<\n  TPart extends { type: string } = ContentPart,\n  TEvent extends { type: string } = SSEEvent,\n>(options: UseStreamChatOptions<TPart, TEvent>): UseStreamChatReturn<TPart> {\n  const {\n    api,\n    headers,\n    body,\n    initialMessages,\n    onEvent,\n    onMessage,\n    onError,\n    onFinish,\n  } = options;\n\n  const [messages, setMessages] = useState<Message<TPart>[]>(\n    initialMessages ?? [],\n  );\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const abortRef = useRef<AbortController | null>(null);\n\n  // We use a ref for the latest messages so that callbacks created inside\n  // `sendMessage` always see the current value without re-creating closures.\n  const messagesRef = useRef<Message<TPart>[]>(messages);\n  messagesRef.current = messages;\n\n  // -----------------------------------------------------------------------\n  // appendText — append a text delta to the last text part of the last\n  // assistant message, or create a new text part if needed.\n  // -----------------------------------------------------------------------\n\n  const appendText = useCallback((delta: string) => {\n    setMessages((prev) => {\n      const last = prev[prev.length - 1];\n      if (!last || last.role !== \"assistant\") return prev;\n\n      const parts = [...last.parts];\n      const lastPart = parts[parts.length - 1];\n\n      if (lastPart && lastPart.type === \"text\" && \"text\" in lastPart) {\n        // Append to existing text part\n        const textPart = lastPart as { type: \"text\"; text: string };\n        parts[parts.length - 1] = {\n          ...lastPart,\n          text: textPart.text + delta,\n        } as unknown as TPart;\n      } else {\n        // Create a new text part\n        parts.push({ type: \"text\", text: delta } as unknown as TPart);\n      }\n\n      const updated: Message<TPart> = { ...last, parts };\n      return [...prev.slice(0, -1), updated];\n    });\n  }, []);\n\n  // -----------------------------------------------------------------------\n  // appendPart — push a new content part to the last assistant message.\n  // -----------------------------------------------------------------------\n\n  const appendPart = useCallback((part: TPart) => {\n    setMessages((prev) => {\n      const last = prev[prev.length - 1];\n      if (!last || last.role !== \"assistant\") return prev;\n\n      const updated: Message<TPart> = {\n        ...last,\n        parts: [...last.parts, part],\n      };\n      return [...prev.slice(0, -1), updated];\n    });\n  }, []);\n\n  // -----------------------------------------------------------------------\n  // stop\n  // -----------------------------------------------------------------------\n\n  const stop = useCallback(() => {\n    abortRef.current?.abort();\n    abortRef.current = null;\n    setIsLoading(false);\n  }, []);\n\n  // -----------------------------------------------------------------------\n  // sendMessage\n  // -----------------------------------------------------------------------\n\n  const sendMessage = useCallback(\n    (text: string) => {\n      // Prevent sending while already streaming.\n      if (abortRef.current) {\n        return;\n      }\n\n      const userMessage = createMessage<TPart>(\"user\", [\n        { type: \"text\", text } as unknown as TPart,\n      ]);\n      const assistantMessage = createMessage<TPart>(\"assistant\", []);\n\n      setMessages((prev) => {\n        const next = [...prev, userMessage, assistantMessage];\n        messagesRef.current = next;\n        return next;\n      });\n\n      onMessage?.(userMessage);\n\n      setError(null);\n      setIsLoading(true);\n\n      const controller = new AbortController();\n      abortRef.current = controller;\n\n      const eventHandler =\n        onEvent ??\n        (defaultOnEvent as unknown as (\n          event: TEvent,\n          helpers: EventHelpers<TPart>,\n        ) => void);\n      const helpers: EventHelpers<TPart> = {\n        appendText,\n        appendPart,\n        setMessages,\n      };\n\n      // Fire-and-forget async IIFE — state is managed via React setState.\n      (async () => {\n        try {\n          const response = await fetch(api, {\n            method: \"POST\",\n            headers: {\n              \"Content-Type\": \"application/json\",\n              ...headers,\n            },\n            body: JSON.stringify({ message: text, ...body }),\n            signal: controller.signal,\n          });\n\n          if (!response.ok) {\n            throw new Error(\n              `SSE request failed: ${response.status} ${response.statusText}`,\n            );\n          }\n\n          if (!response.body) {\n            throw new Error(\n              \"Response body is null — SSE streaming not supported\",\n            );\n          }\n\n          for await (const event of parseSSEStream(\n            response.body,\n            controller.signal,\n          )) {\n            eventHandler(event as unknown as TEvent, helpers);\n          }\n\n          // Stream finished — notify via callbacks.\n          const finalMessages = messagesRef.current;\n          const lastMessage = finalMessages[finalMessages.length - 1];\n\n          if (lastMessage?.role === \"assistant\") {\n            onMessage?.(lastMessage);\n          }\n\n          onFinish?.(finalMessages);\n        } catch (err) {\n          // AbortError is expected when the user calls `stop()`.\n          if (err instanceof DOMException && err.name === \"AbortError\") {\n            return;\n          }\n\n          const error = err instanceof Error ? err : new Error(String(err));\n\n          setError(error);\n          onError?.(error);\n        } finally {\n          abortRef.current = null;\n          setIsLoading(false);\n        }\n      })();\n    },\n    [api, headers, body, onEvent, onMessage, onError, onFinish, appendText, appendPart],\n  );\n\n  // -----------------------------------------------------------------------\n  // Cleanup — abort any in-flight stream when the component unmounts.\n  // -----------------------------------------------------------------------\n\n  useEffect(() => {\n    return () => {\n      abortRef.current?.abort();\n      abortRef.current = null;\n    };\n  }, []);\n\n  return {\n    messages,\n    isLoading,\n    error,\n    sendMessage,\n    stop,\n    setMessages,\n  };\n}\n","export { useStreamChat } from \"./use-stream-chat\";\n\nexport type {\n  EventHelpers,\n  UseStreamChatOptions,\n  UseStreamChatReturn,\n} from \"./types\";\n\n// Re-export core types so consumers only need to import from @deltakit/react\nexport type {\n  TextPart,\n  ToolCallPart,\n  ReasoningPart,\n  ContentPart,\n  Message,\n  TextDeltaEvent,\n  ToolCallEvent,\n  ToolResultEvent,\n  SSEEvent,\n} from \"@deltakit/core\";\n\nexport { parseSSEStream, fromOpenAiAgents } from \"@deltakit/core\";\n"],"mappings":"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","names":["error","parseSSEStream"]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@deltakit/react",
+  "version": "0.1.0",
+  "description": "DeltaKit React bindings",
+  "type": "module",
+  "license": "MIT",
+  "author": "DeltaKit HQ",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deltakithq/deltakit-monorepo",
+    "directory": "packages/react"
+  },
+  "keywords": [
+    "deltakit",
+    "react"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@deltakit/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.18",
+    "react": "^18.3.1",
+    "tsup": "8.5.1",
+    "typescript": "^5.7.2"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "check": "biome check src/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}