@starcite/react 0.0.7

package/dist/chunk-QG237Z3K.js

@@ -0,0 +1,171 @@
+// src/chat-protocol.ts
+import { readUIMessageStream } from "ai";
+var chatUserMessageEventType = "chat.user.message";
+var chatAssistantChunkEventType = "chat.assistant.chunk";
+function isChatEventType(type) {
+  return type === chatUserMessageEventType || type === chatAssistantChunkEventType;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function parseUserEnvelope(payload) {
+  const message = payload.message;
+  if (!isRecord(message)) {
+    throw new Error("Invalid chat payload envelope: missing message");
+  }
+  const role = message.role;
+  const parts = message.parts;
+  if (role !== "system" && role !== "user" && role !== "assistant") {
+    throw new Error("Invalid chat payload envelope: invalid message role");
+  }
+  if (!Array.isArray(parts)) {
+    throw new Error("Invalid chat payload envelope: invalid message parts");
+  }
+  return {
+    ...payload,
+    kind: chatUserMessageEventType,
+    message: {
+      ...message,
+      role,
+      parts
+    }
+  };
+}
+function parseAssistantEnvelope(payload) {
+  const chunk = payload.chunk;
+  if (!isRecord(chunk)) {
+    throw new Error("Invalid chat payload envelope: missing chunk");
+  }
+  const type = chunk.type;
+  if (typeof type !== "string" || type.length === 0) {
+    throw new Error("Invalid chat payload envelope: invalid chunk type");
+  }
+  return {
+    ...payload,
+    kind: chatAssistantChunkEventType,
+    chunk: {
+      ...chunk,
+      type
+    }
+  };
+}
+function createUserMessageEnvelope(message) {
+  return {
+    kind: chatUserMessageEventType,
+    message
+  };
+}
+function createAssistantChunkEnvelope(chunk) {
+  return {
+    kind: chatAssistantChunkEventType,
+    chunk
+  };
+}
+function parseChatPayloadEnvelope(payload) {
+  if (!isRecord(payload)) {
+    throw new Error("Invalid chat payload envelope: payload must be an object");
+  }
+  const kind = payload.kind;
+  if (kind === chatUserMessageEventType) {
+    return parseUserEnvelope(payload);
+  }
+  if (kind === chatAssistantChunkEventType) {
+    return parseAssistantEnvelope(payload);
+  }
+  throw new Error("Invalid chat payload envelope: unknown kind");
+}
+function appendUserMessageEvent(session, message, options = {}) {
+  return session.append({
+    type: chatUserMessageEventType,
+    source: options.source ?? "use-chat",
+    payload: createUserMessageEnvelope(message)
+  });
+}
+function appendAssistantChunkEvent(session, chunk, options = {}) {
+  return session.append({
+    type: chatAssistantChunkEventType,
+    source: options.source ?? "openai",
+    payload: createAssistantChunkEnvelope(chunk)
+  });
+}
+async function buildChunkMessages(chunks) {
+  if (chunks.length === 0) {
+    return [];
+  }
+  const messageIds = [];
+  const latestById = /* @__PURE__ */ new Map();
+  let index = 0;
+  const stream = new ReadableStream({
+    pull(controller) {
+      const chunk = chunks[index];
+      if (!chunk) {
+        controller.close();
+        return;
+      }
+      controller.enqueue(chunk);
+      index += 1;
+    }
+  });
+  try {
+    for await (const message of readUIMessageStream({
+      stream,
+      terminateOnError: false
+    })) {
+      if (!latestById.has(message.id)) {
+        messageIds.push(message.id);
+      }
+      latestById.set(message.id, message);
+    }
+  } catch {
+  }
+  const messages = [];
+  for (const messageId of messageIds) {
+    const message = latestById.get(messageId);
+    if (message) {
+      messages.push(message);
+    }
+  }
+  return messages;
+}
+async function toUIMessagesFromEvents(events) {
+  const messages = [];
+  const bufferedChunks = [];
+  const flushBufferedChunks = async () => {
+    if (bufferedChunks.length === 0) {
+      return;
+    }
+    messages.push(...await buildChunkMessages(bufferedChunks));
+    bufferedChunks.length = 0;
+  };
+  for (const event of events) {
+    if (!isChatEventType(event.type)) {
+      continue;
+    }
+    let envelope;
+    try {
+      envelope = parseChatPayloadEnvelope(event.payload);
+    } catch {
+      continue;
+    }
+    if (envelope.kind === chatUserMessageEventType) {
+      await flushBufferedChunks();
+      messages.push(envelope.message);
+      continue;
+    }
+    bufferedChunks.push(envelope.chunk);
+  }
+  await flushBufferedChunks();
+  return messages;
+}
+
+export {
+  chatUserMessageEventType,
+  chatAssistantChunkEventType,
+  createUserMessageEnvelope,
+  createAssistantChunkEnvelope,
+  parseChatPayloadEnvelope,
+  appendUserMessageEvent,
+  appendAssistantChunkEvent,
+  toUIMessagesFromEvents
+};
+//# sourceMappingURL=chunk-QG237Z3K.js.map

package/dist/chunk-QG237Z3K.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chat-protocol.ts"],"sourcesContent":["import type { AppendResult, SessionAppendInput } from \"@starcite/sdk\";\nimport { readUIMessageStream, type UIMessage, type UIMessageChunk } from \"ai\";\n\nexport const chatUserMessageEventType = \"chat.user.message\";\nexport const chatAssistantChunkEventType = \"chat.assistant.chunk\";\n\ntype ChatRole = \"system\" | \"user\" | \"assistant\";\n\ninterface ChatUserMessagePayload {\n  role: ChatRole;\n  parts: unknown[];\n  [key: string]: unknown;\n}\n\ninterface ChatAssistantChunkPayload {\n  type: string;\n  [key: string]: unknown;\n}\n\nexport type ChatPayloadEnvelope =\n  | {\n      kind: typeof chatUserMessageEventType;\n      message: ChatUserMessagePayload;\n      [key: string]: unknown;\n    }\n  | {\n      kind: typeof chatAssistantChunkEventType;\n      chunk: ChatAssistantChunkPayload;\n      [key: string]: unknown;\n    };\n\ninterface SessionAppender {\n  append: (input: SessionAppendInput) => Promise<AppendResult>;\n}\n\nfunction isChatEventType(type: string): boolean {\n  return (\n    type === chatUserMessageEventType || type === chatAssistantChunkEventType\n  );\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction parseUserEnvelope(\n  payload: Record<string, unknown>\n): ChatPayloadEnvelope {\n  const message = payload.message;\n  if (!isRecord(message)) {\n    throw new Error(\"Invalid chat payload envelope: missing message\");\n  }\n\n  const role = message.role;\n  const parts = message.parts;\n\n  if (role !== \"system\" && role !== \"user\" && role !== \"assistant\") {\n    throw new Error(\"Invalid chat payload envelope: invalid message role\");\n  }\n\n  if (!Array.isArray(parts)) {\n    throw new Error(\"Invalid chat payload envelope: invalid message parts\");\n  }\n\n  return {\n    ...payload,\n    kind: chatUserMessageEventType,\n    message: {\n      ...message,\n      role,\n      parts,\n    },\n  };\n}\n\nfunction parseAssistantEnvelope(\n  payload: Record<string, unknown>\n): ChatPayloadEnvelope {\n  const chunk = payload.chunk;\n  if (!isRecord(chunk)) {\n    throw new Error(\"Invalid chat payload envelope: missing chunk\");\n  }\n\n  const type = chunk.type;\n  if (typeof type !== \"string\" || type.length === 0) {\n    throw new Error(\"Invalid chat payload envelope: invalid chunk type\");\n  }\n\n  return {\n    ...payload,\n    kind: chatAssistantChunkEventType,\n    chunk: {\n      ...chunk,\n      type,\n    },\n  };\n}\n\nexport function createUserMessageEnvelope<\n  TMessage extends Record<string, unknown>,\n>(\n  message: TMessage\n): {\n  kind: typeof chatUserMessageEventType;\n  message: TMessage;\n} {\n  return {\n    kind: chatUserMessageEventType,\n    message,\n  };\n}\n\nexport function createAssistantChunkEnvelope<\n  TChunk extends Record<string, unknown>,\n>(\n  chunk: TChunk\n): {\n  kind: typeof chatAssistantChunkEventType;\n  chunk: TChunk;\n} {\n  return {\n    kind: chatAssistantChunkEventType,\n    chunk,\n  };\n}\n\nexport function parseChatPayloadEnvelope(\n  payload: unknown\n): ChatPayloadEnvelope {\n  if (!isRecord(payload)) {\n    throw new Error(\"Invalid chat payload envelope: payload must be an object\");\n  }\n\n  const kind = payload.kind;\n  if (kind === chatUserMessageEventType) {\n    return parseUserEnvelope(payload);\n  }\n\n  if (kind === chatAssistantChunkEventType) {\n    return parseAssistantEnvelope(payload);\n  }\n\n  throw new Error(\"Invalid chat payload envelope: unknown kind\");\n}\n\nexport function appendUserMessageEvent(\n  session: SessionAppender,\n  message: Record<string, unknown>,\n  options: { source?: string } = {}\n): Promise<AppendResult> {\n  return session.append({\n    type: chatUserMessageEventType,\n    source: options.source ?? \"use-chat\",\n    payload: createUserMessageEnvelope(message),\n  });\n}\n\nexport function appendAssistantChunkEvent(\n  session: SessionAppender,\n  chunk: Record<string, unknown>,\n  options: { source?: string } = {}\n): Promise<AppendResult> {\n  return session.append({\n    type: chatAssistantChunkEventType,\n    source: options.source ?? \"openai\",\n    payload: createAssistantChunkEnvelope(chunk),\n  });\n}\n\nasync function buildChunkMessages(\n  chunks: readonly UIMessageChunk[]\n): Promise<UIMessage[]> {\n  if (chunks.length === 0) {\n    return [];\n  }\n\n  const messageIds: string[] = [];\n  const latestById = new Map<string, UIMessage>();\n  let index = 0;\n\n  const stream = new ReadableStream<UIMessageChunk>({\n    pull(controller) {\n      const chunk = chunks[index];\n      if (!chunk) {\n        controller.close();\n        return;\n      }\n\n      controller.enqueue(chunk);\n      index += 1;\n    },\n  });\n\n  try {\n    for await (const message of readUIMessageStream({\n      stream,\n      terminateOnError: false,\n    })) {\n      if (!latestById.has(message.id)) {\n        messageIds.push(message.id);\n      }\n\n      latestById.set(message.id, message);\n    }\n  } catch {\n    // Best effort: keep messages emitted before malformed chunk sequences.\n  }\n\n  const messages: UIMessage[] = [];\n  for (const messageId of messageIds) {\n    const message = latestById.get(messageId);\n    if (message) {\n      messages.push(message);\n    }\n  }\n\n  return messages;\n}\n\nexport async function toUIMessagesFromEvents(\n  events: readonly { type: string; payload: unknown }[]\n): Promise<UIMessage[]> {\n  const messages: UIMessage[] = [];\n  const bufferedChunks: UIMessageChunk[] = [];\n\n  const flushBufferedChunks = async (): Promise<void> => {\n    if (bufferedChunks.length === 0) {\n      return;\n    }\n\n    messages.push(...(await buildChunkMessages(bufferedChunks)));\n    bufferedChunks.length = 0;\n  };\n\n  for (const event of events) {\n    if (!isChatEventType(event.type)) {\n      continue;\n    }\n\n    let envelope: ChatPayloadEnvelope;\n    try {\n      envelope = parseChatPayloadEnvelope(event.payload);\n    } catch {\n      // Skip malformed chat payloads and continue projecting the rest.\n      continue;\n    }\n\n    if (envelope.kind === chatUserMessageEventType) {\n      await flushBufferedChunks();\n      messages.push(envelope.message as unknown as UIMessage);\n      continue;\n    }\n\n    bufferedChunks.push(envelope.chunk as unknown as UIMessageChunk);\n  }\n\n  await flushBufferedChunks();\n  return messages;\n}\n"],"mappings":"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","names":[]}

package/dist/index.cjs

@@ -0,0 +1,383 @@
+"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, {
+  useStarciteChat: () => useStarciteChat
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/use-starcite-chat.ts
+var import_react = require("react");
+
+// src/chat-protocol.ts
+var import_ai = require("ai");
+var chatUserMessageEventType = "chat.user.message";
+var chatAssistantChunkEventType = "chat.assistant.chunk";
+function isChatEventType(type) {
+  return type === chatUserMessageEventType || type === chatAssistantChunkEventType;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function parseUserEnvelope(payload) {
+  const message = payload.message;
+  if (!isRecord(message)) {
+    throw new Error("Invalid chat payload envelope: missing message");
+  }
+  const role = message.role;
+  const parts = message.parts;
+  if (role !== "system" && role !== "user" && role !== "assistant") {
+    throw new Error("Invalid chat payload envelope: invalid message role");
+  }
+  if (!Array.isArray(parts)) {
+    throw new Error("Invalid chat payload envelope: invalid message parts");
+  }
+  return {
+    ...payload,
+    kind: chatUserMessageEventType,
+    message: {
+      ...message,
+      role,
+      parts
+    }
+  };
+}
+function parseAssistantEnvelope(payload) {
+  const chunk = payload.chunk;
+  if (!isRecord(chunk)) {
+    throw new Error("Invalid chat payload envelope: missing chunk");
+  }
+  const type = chunk.type;
+  if (typeof type !== "string" || type.length === 0) {
+    throw new Error("Invalid chat payload envelope: invalid chunk type");
+  }
+  return {
+    ...payload,
+    kind: chatAssistantChunkEventType,
+    chunk: {
+      ...chunk,
+      type
+    }
+  };
+}
+function createUserMessageEnvelope(message) {
+  return {
+    kind: chatUserMessageEventType,
+    message
+  };
+}
+function parseChatPayloadEnvelope(payload) {
+  if (!isRecord(payload)) {
+    throw new Error("Invalid chat payload envelope: payload must be an object");
+  }
+  const kind = payload.kind;
+  if (kind === chatUserMessageEventType) {
+    return parseUserEnvelope(payload);
+  }
+  if (kind === chatAssistantChunkEventType) {
+    return parseAssistantEnvelope(payload);
+  }
+  throw new Error("Invalid chat payload envelope: unknown kind");
+}
+function appendUserMessageEvent(session, message, options = {}) {
+  return session.append({
+    type: chatUserMessageEventType,
+    source: options.source ?? "use-chat",
+    payload: createUserMessageEnvelope(message)
+  });
+}
+async function buildChunkMessages(chunks) {
+  if (chunks.length === 0) {
+    return [];
+  }
+  const messageIds = [];
+  const latestById = /* @__PURE__ */ new Map();
+  let index = 0;
+  const stream = new ReadableStream({
+    pull(controller) {
+      const chunk = chunks[index];
+      if (!chunk) {
+        controller.close();
+        return;
+      }
+      controller.enqueue(chunk);
+      index += 1;
+    }
+  });
+  try {
+    for await (const message of (0, import_ai.readUIMessageStream)({
+      stream,
+      terminateOnError: false
+    })) {
+      if (!latestById.has(message.id)) {
+        messageIds.push(message.id);
+      }
+      latestById.set(message.id, message);
+    }
+  } catch {
+  }
+  const messages = [];
+  for (const messageId of messageIds) {
+    const message = latestById.get(messageId);
+    if (message) {
+      messages.push(message);
+    }
+  }
+  return messages;
+}
+async function toUIMessagesFromEvents(events) {
+  const messages = [];
+  const bufferedChunks = [];
+  const flushBufferedChunks = async () => {
+    if (bufferedChunks.length === 0) {
+      return;
+    }
+    messages.push(...await buildChunkMessages(bufferedChunks));
+    bufferedChunks.length = 0;
+  };
+  for (const event of events) {
+    if (!isChatEventType(event.type)) {
+      continue;
+    }
+    let envelope;
+    try {
+      envelope = parseChatPayloadEnvelope(event.payload);
+    } catch {
+      continue;
+    }
+    if (envelope.kind === chatUserMessageEventType) {
+      await flushBufferedChunks();
+      messages.push(envelope.message);
+      continue;
+    }
+    bufferedChunks.push(envelope.chunk);
+  }
+  await flushBufferedChunks();
+  return messages;
+}
+
+// src/use-starcite-chat.ts
+function createMessageId() {
+  if (typeof crypto !== "undefined" && "randomUUID" in crypto) {
+    return crypto.randomUUID();
+  }
+  return `msg_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+}
+function isChatEventType2(type) {
+  return type === chatUserMessageEventType || type === chatAssistantChunkEventType;
+}
+function isTerminalAssistantChunkType(type) {
+  return type === "finish" || type === "abort";
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null;
+}
+function readAssistantChunkType(payload) {
+  if (!isRecord2(payload) || payload.kind !== chatAssistantChunkEventType) {
+    return void 0;
+  }
+  const chunk = payload.chunk;
+  if (!isRecord2(chunk)) {
+    return void 0;
+  }
+  return typeof chunk.type === "string" ? chunk.type : void 0;
+}
+function hasTextInput(message) {
+  return "text" in message && !("parts" in message);
+}
+function normalizeOutgoingMessage(input) {
+  if (hasTextInput(input)) {
+    return {
+      id: createMessageId(),
+      role: "user",
+      parts: [{ type: "text", text: input.text }]
+    };
+  }
+  return {
+    ...input,
+    id: input.id ?? createMessageId()
+  };
+}
+function normalizeError(error) {
+  if (error instanceof Error) {
+    return error;
+  }
+  return new Error(String(error));
+}
+async function readChatState(events) {
+  const messages = await toUIMessagesFromEvents(events);
+  let assistantOpen = false;
+  for (let index = events.length - 1; index >= 0; index -= 1) {
+    const event = events[index];
+    if (!event || event.type !== chatAssistantChunkEventType) {
+      continue;
+    }
+    const chunkType = readAssistantChunkType(event.payload);
+    if (!chunkType) {
+      break;
+    }
+    assistantOpen = !isTerminalAssistantChunkType(chunkType);
+    break;
+  }
+  return {
+    messages,
+    assistantOpen
+  };
+}
+function useStarciteChat(options) {
+  const { session, id, userMessageSource = "use-chat", onError } = options;
+  const sessionResetKey = id ?? session.id;
+  const [messages, setMessages] = (0, import_react.useState)([]);
+  const [status, setStatus] = (0, import_react.useState)("ready");
+  const refreshVersionRef = (0, import_react.useRef)(0);
+  const sessionKeyRef = (0, import_react.useRef)(sessionResetKey);
+  const onErrorRef = (0, import_react.useRef)(onError);
+  const liveRefreshScheduledRef = (0, import_react.useRef)(false);
+  const replayRefreshTimeoutRef = (0, import_react.useRef)(
+    null
+  );
+  (0, import_react.useEffect)(() => {
+    onErrorRef.current = onError;
+  }, [onError]);
+  const reportError = (0, import_react.useCallback)((error) => {
+    const normalized = normalizeError(error);
+    setStatus("error");
+    onErrorRef.current?.(normalized);
+    return normalized;
+  }, []);
+  const refreshFromSession = (0, import_react.useCallback)(() => {
+    const version = refreshVersionRef.current + 1;
+    refreshVersionRef.current = version;
+    const snapshot = [...session.events()];
+    readChatState(snapshot).then((chatState) => {
+      if (refreshVersionRef.current !== version) {
+        return;
+      }
+      setMessages(chatState.messages);
+      setStatus((current) => {
+        if (chatState.assistantOpen) {
+          return "streaming";
+        }
+        return current === "submitted" ? "submitted" : "ready";
+      });
+    }).catch((error) => {
+      reportError(error);
+    });
+  }, [reportError, session]);
+  const scheduleLiveRefreshFromSession = (0, import_react.useCallback)(() => {
+    if (liveRefreshScheduledRef.current) {
+      return;
+    }
+    liveRefreshScheduledRef.current = true;
+    setTimeout(() => {
+      liveRefreshScheduledRef.current = false;
+      refreshFromSession();
+    }, 16);
+  }, [refreshFromSession]);
+  const scheduleReplayRefreshFromSession = (0, import_react.useCallback)(() => {
+    if (replayRefreshTimeoutRef.current !== null) {
+      clearTimeout(replayRefreshTimeoutRef.current);
+    }
+    replayRefreshTimeoutRef.current = setTimeout(() => {
+      replayRefreshTimeoutRef.current = null;
+      refreshFromSession();
+    }, 120);
+  }, [refreshFromSession]);
+  const sendMessage = (0, import_react.useCallback)(
+    async (message) => {
+      const requestSessionKey = sessionKeyRef.current;
+      const outgoingMessage = normalizeOutgoingMessage(message);
+      setStatus("submitted");
+      try {
+        await appendUserMessageEvent(
+          session,
+          outgoingMessage,
+          {
+            source: userMessageSource
+          }
+        );
+        if (sessionKeyRef.current !== requestSessionKey) {
+          return;
+        }
+        refreshFromSession();
+      } catch (error) {
+        refreshVersionRef.current += 1;
+        throw reportError(error);
+      }
+    },
+    [refreshFromSession, reportError, session, userMessageSource]
+  );
+  const onSessionEvent = (0, import_react.useCallback)(
+    (event, context) => {
+      if (!isChatEventType2(event.type)) {
+        return;
+      }
+      if (!context?.replayed && event.type === chatAssistantChunkEventType) {
+        const chunkType = readAssistantChunkType(event.payload);
+        if (chunkType && isTerminalAssistantChunkType(chunkType)) {
+          setStatus("ready");
+        } else {
+          setStatus("streaming");
+        }
+      }
+      if (context?.replayed) {
+        scheduleReplayRefreshFromSession();
+      } else {
+        scheduleLiveRefreshFromSession();
+      }
+    },
+    [scheduleLiveRefreshFromSession, scheduleReplayRefreshFromSession]
+  );
+  (0, import_react.useEffect)(() => {
+    sessionKeyRef.current = sessionResetKey;
+    refreshVersionRef.current += 1;
+    setMessages([]);
+    setStatus("ready");
+    refreshFromSession();
+    const offEvent = session.on("event", onSessionEvent, { replay: false });
+    const offError = session.on("error", (error) => {
+      onErrorRef.current?.(normalizeError(error));
+    });
+    return () => {
+      refreshVersionRef.current += 1;
+      liveRefreshScheduledRef.current = false;
+      if (replayRefreshTimeoutRef.current !== null) {
+        clearTimeout(replayRefreshTimeoutRef.current);
+        replayRefreshTimeoutRef.current = null;
+      }
+      offEvent();
+      offError();
+    };
+  }, [onSessionEvent, refreshFromSession, session, sessionResetKey]);
+  return (0, import_react.useMemo)(
+    () => ({
+      messages,
+      sendMessage,
+      status
+    }),
+    [messages, sendMessage, status]
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useStarciteChat
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/use-starcite-chat.ts","../src/chat-protocol.ts"],"sourcesContent":["/* biome-ignore-all lint/performance/noBarrelFile: package entrypoint intentionally re-exports public API. */\nexport type {\n  SendMessageInput,\n  StarciteChatSession,\n  UseStarciteChatOptions,\n  UseStarciteChatResult,\n} from \"./use-starcite-chat\";\nexport { useStarciteChat } from \"./use-starcite-chat\";\n","import type {\n  AppendResult,\n  SessionAppendInput,\n  SessionEvent,\n  SessionEventListener,\n  SessionOnEventOptions,\n} from \"@starcite/sdk\";\nimport type { ChatStatus, UIMessage } from \"ai\";\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport {\n  appendUserMessageEvent,\n  chatAssistantChunkEventType,\n  chatUserMessageEventType,\n  toUIMessagesFromEvents,\n} from \"./chat-protocol\";\n\nexport interface StarciteChatSession {\n  readonly id: string;\n  append(input: SessionAppendInput): Promise<AppendResult>;\n  events(): readonly SessionEvent[];\n  on(\n    eventName: \"event\",\n    listener: SessionEventListener,\n    options?: SessionOnEventOptions<SessionEvent>\n  ): () => void;\n  on(eventName: \"error\", listener: (error: Error) => void): () => void;\n}\n\nexport type SendMessageInput =\n  | {\n      text: string;\n    }\n  | (Omit<UIMessage, \"id\"> & { id?: string });\n\nexport interface UseStarciteChatOptions {\n  session: StarciteChatSession;\n  id?: string;\n  userMessageSource?: string;\n  onError?: (error: Error) => void;\n}\n\nexport interface UseStarciteChatResult {\n  messages: UIMessage[];\n  sendMessage: (message: SendMessageInput) => Promise<void>;\n  status: ChatStatus;\n}\n\ninterface ChatStateSnapshot {\n  messages: UIMessage[];\n  assistantOpen: boolean;\n}\n\nfunction createMessageId(): string {\n  if (typeof crypto !== \"undefined\" && \"randomUUID\" in crypto) {\n    return crypto.randomUUID();\n  }\n\n  return `msg_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction isChatEventType(type: string): boolean {\n  return (\n    type === chatUserMessageEventType || type === chatAssistantChunkEventType\n  );\n}\n\nfunction isTerminalAssistantChunkType(type: string): boolean {\n  return type === \"finish\" || type === \"abort\";\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction readAssistantChunkType(payload: unknown): string | undefined {\n  if (!isRecord(payload) || payload.kind !== chatAssistantChunkEventType) {\n    return undefined;\n  }\n\n  const chunk = payload.chunk;\n  if (!isRecord(chunk)) {\n    return undefined;\n  }\n\n  return typeof chunk.type === \"string\" ? chunk.type : undefined;\n}\n\nfunction hasTextInput(message: SendMessageInput): message is { text: string } {\n  return \"text\" in message && !(\"parts\" in message);\n}\n\nfunction normalizeOutgoingMessage(input: SendMessageInput): UIMessage {\n  if (hasTextInput(input)) {\n    return {\n      id: createMessageId(),\n      role: \"user\",\n      parts: [{ type: \"text\", text: input.text }],\n    };\n  }\n\n  return {\n    ...input,\n    id: input.id ?? createMessageId(),\n  };\n}\n\nfunction normalizeError(error: unknown): Error {\n  if (error instanceof Error) {\n    return error;\n  }\n\n  return new Error(String(error));\n}\n\nasync function readChatState(\n  events: readonly SessionEvent[]\n): Promise<ChatStateSnapshot> {\n  const messages = await toUIMessagesFromEvents(events);\n  let assistantOpen = false;\n  for (let index = events.length - 1; index >= 0; index -= 1) {\n    const event = events[index];\n    if (!event || event.type !== chatAssistantChunkEventType) {\n      continue;\n    }\n\n    const chunkType = readAssistantChunkType(event.payload);\n    if (!chunkType) {\n      break;\n    }\n\n    assistantOpen = !isTerminalAssistantChunkType(chunkType);\n    break;\n  }\n\n  return {\n    messages,\n    assistantOpen,\n  };\n}\n\nexport function useStarciteChat(\n  options: UseStarciteChatOptions\n): UseStarciteChatResult {\n  const { session, id, userMessageSource = \"use-chat\", onError } = options;\n\n  const sessionResetKey = id ?? session.id;\n\n  const [messages, setMessages] = useState<UIMessage[]>([]);\n  const [status, setStatus] = useState<ChatStatus>(\"ready\");\n\n  const refreshVersionRef = useRef(0);\n  const sessionKeyRef = useRef(sessionResetKey);\n  const onErrorRef = useRef(onError);\n  const liveRefreshScheduledRef = useRef(false);\n  const replayRefreshTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(\n    null\n  );\n\n  useEffect(() => {\n    onErrorRef.current = onError;\n  }, [onError]);\n\n  const reportError = useCallback((error: unknown): Error => {\n    const normalized = normalizeError(error);\n    setStatus(\"error\");\n    onErrorRef.current?.(normalized);\n    return normalized;\n  }, []);\n\n  const refreshFromSession = useCallback(() => {\n    const version = refreshVersionRef.current + 1;\n    refreshVersionRef.current = version;\n\n    const snapshot = [...session.events()];\n\n    readChatState(snapshot)\n      .then((chatState) => {\n        if (refreshVersionRef.current !== version) {\n          return;\n        }\n\n        setMessages(chatState.messages);\n        setStatus((current) => {\n          if (chatState.assistantOpen) {\n            return \"streaming\";\n          }\n\n          return current === \"submitted\" ? \"submitted\" : \"ready\";\n        });\n      })\n      .catch((error) => {\n        reportError(error);\n      });\n  }, [reportError, session]);\n\n  const scheduleLiveRefreshFromSession = useCallback(() => {\n    if (liveRefreshScheduledRef.current) {\n      return;\n    }\n\n    liveRefreshScheduledRef.current = true;\n    setTimeout(() => {\n      liveRefreshScheduledRef.current = false;\n      refreshFromSession();\n    }, 16);\n  }, [refreshFromSession]);\n\n  const scheduleReplayRefreshFromSession = useCallback(() => {\n    if (replayRefreshTimeoutRef.current !== null) {\n      clearTimeout(replayRefreshTimeoutRef.current);\n    }\n\n    replayRefreshTimeoutRef.current = setTimeout(() => {\n      replayRefreshTimeoutRef.current = null;\n      refreshFromSession();\n    }, 120);\n  }, [refreshFromSession]);\n\n  const sendMessage = useCallback(\n    async (message: SendMessageInput): Promise<void> => {\n      const requestSessionKey = sessionKeyRef.current;\n      const outgoingMessage = normalizeOutgoingMessage(message);\n\n      setStatus(\"submitted\");\n\n      try {\n        await appendUserMessageEvent(\n          session,\n          outgoingMessage as unknown as Record<string, unknown>,\n          {\n            source: userMessageSource,\n          }\n        );\n\n        if (sessionKeyRef.current !== requestSessionKey) {\n          return;\n        }\n\n        refreshFromSession();\n      } catch (error) {\n        refreshVersionRef.current += 1;\n        throw reportError(error);\n      }\n    },\n    [refreshFromSession, reportError, session, userMessageSource]\n  );\n\n  const onSessionEvent = useCallback(\n    (event: SessionEvent, context?: { replayed: boolean }): void => {\n      if (!isChatEventType(event.type)) {\n        return;\n      }\n\n      if (!context?.replayed && event.type === chatAssistantChunkEventType) {\n        const chunkType = readAssistantChunkType(event.payload);\n        if (chunkType && isTerminalAssistantChunkType(chunkType)) {\n          setStatus(\"ready\");\n        } else {\n          setStatus(\"streaming\");\n        }\n      }\n\n      if (context?.replayed) {\n        scheduleReplayRefreshFromSession();\n      } else {\n        scheduleLiveRefreshFromSession();\n      }\n    },\n    [scheduleLiveRefreshFromSession, scheduleReplayRefreshFromSession]\n  );\n\n  useEffect(() => {\n    sessionKeyRef.current = sessionResetKey;\n    refreshVersionRef.current += 1;\n    setMessages([]);\n    setStatus(\"ready\");\n\n    refreshFromSession();\n\n    const offEvent = session.on(\"event\", onSessionEvent, { replay: false });\n    const offError = session.on(\"error\", (error) => {\n      onErrorRef.current?.(normalizeError(error));\n    });\n\n    return () => {\n      refreshVersionRef.current += 1;\n\n      liveRefreshScheduledRef.current = false;\n      if (replayRefreshTimeoutRef.current !== null) {\n        clearTimeout(replayRefreshTimeoutRef.current);\n        replayRefreshTimeoutRef.current = null;\n      }\n\n      offEvent();\n      offError();\n    };\n  }, [onSessionEvent, refreshFromSession, session, sessionResetKey]);\n\n  return useMemo(\n    () => ({\n      messages,\n      sendMessage,\n      status,\n    }),\n    [messages, sendMessage, status]\n  );\n}\n","import type { AppendResult, SessionAppendInput } from \"@starcite/sdk\";\nimport { readUIMessageStream, type UIMessage, type UIMessageChunk } from \"ai\";\n\nexport const chatUserMessageEventType = \"chat.user.message\";\nexport const chatAssistantChunkEventType = \"chat.assistant.chunk\";\n\ntype ChatRole = \"system\" | \"user\" | \"assistant\";\n\ninterface ChatUserMessagePayload {\n  role: ChatRole;\n  parts: unknown[];\n  [key: string]: unknown;\n}\n\ninterface ChatAssistantChunkPayload {\n  type: string;\n  [key: string]: unknown;\n}\n\nexport type ChatPayloadEnvelope =\n  | {\n      kind: typeof chatUserMessageEventType;\n      message: ChatUserMessagePayload;\n      [key: string]: unknown;\n    }\n  | {\n      kind: typeof chatAssistantChunkEventType;\n      chunk: ChatAssistantChunkPayload;\n      [key: string]: unknown;\n    };\n\ninterface SessionAppender {\n  append: (input: SessionAppendInput) => Promise<AppendResult>;\n}\n\nfunction isChatEventType(type: string): boolean {\n  return (\n    type === chatUserMessageEventType || type === chatAssistantChunkEventType\n  );\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction parseUserEnvelope(\n  payload: Record<string, unknown>\n): ChatPayloadEnvelope {\n  const message = payload.message;\n  if (!isRecord(message)) {\n    throw new Error(\"Invalid chat payload envelope: missing message\");\n  }\n\n  const role = message.role;\n  const parts = message.parts;\n\n  if (role !== \"system\" && role !== \"user\" && role !== \"assistant\") {\n    throw new Error(\"Invalid chat payload envelope: invalid message role\");\n  }\n\n  if (!Array.isArray(parts)) {\n    throw new Error(\"Invalid chat payload envelope: invalid message parts\");\n  }\n\n  return {\n    ...payload,\n    kind: chatUserMessageEventType,\n    message: {\n      ...message,\n      role,\n      parts,\n    },\n  };\n}\n\nfunction parseAssistantEnvelope(\n  payload: Record<string, unknown>\n): ChatPayloadEnvelope {\n  const chunk = payload.chunk;\n  if (!isRecord(chunk)) {\n    throw new Error(\"Invalid chat payload envelope: missing chunk\");\n  }\n\n  const type = chunk.type;\n  if (typeof type !== \"string\" || type.length === 0) {\n    throw new Error(\"Invalid chat payload envelope: invalid chunk type\");\n  }\n\n  return {\n    ...payload,\n    kind: chatAssistantChunkEventType,\n    chunk: {\n      ...chunk,\n      type,\n    },\n  };\n}\n\nexport function createUserMessageEnvelope<\n  TMessage extends Record<string, unknown>,\n>(\n  message: TMessage\n): {\n  kind: typeof chatUserMessageEventType;\n  message: TMessage;\n} {\n  return {\n    kind: chatUserMessageEventType,\n    message,\n  };\n}\n\nexport function createAssistantChunkEnvelope<\n  TChunk extends Record<string, unknown>,\n>(\n  chunk: TChunk\n): {\n  kind: typeof chatAssistantChunkEventType;\n  chunk: TChunk;\n} {\n  return {\n    kind: chatAssistantChunkEventType,\n    chunk,\n  };\n}\n\nexport function parseChatPayloadEnvelope(\n  payload: unknown\n): ChatPayloadEnvelope {\n  if (!isRecord(payload)) {\n    throw new Error(\"Invalid chat payload envelope: payload must be an object\");\n  }\n\n  const kind = payload.kind;\n  if (kind === chatUserMessageEventType) {\n    return parseUserEnvelope(payload);\n  }\n\n  if (kind === chatAssistantChunkEventType) {\n    return parseAssistantEnvelope(payload);\n  }\n\n  throw new Error(\"Invalid chat payload envelope: unknown kind\");\n}\n\nexport function appendUserMessageEvent(\n  session: SessionAppender,\n  message: Record<string, unknown>,\n  options: { source?: string } = {}\n): Promise<AppendResult> {\n  return session.append({\n    type: chatUserMessageEventType,\n    source: options.source ?? \"use-chat\",\n    payload: createUserMessageEnvelope(message),\n  });\n}\n\nexport function appendAssistantChunkEvent(\n  session: SessionAppender,\n  chunk: Record<string, unknown>,\n  options: { source?: string } = {}\n): Promise<AppendResult> {\n  return session.append({\n    type: chatAssistantChunkEventType,\n    source: options.source ?? \"openai\",\n    payload: createAssistantChunkEnvelope(chunk),\n  });\n}\n\nasync function buildChunkMessages(\n  chunks: readonly UIMessageChunk[]\n): Promise<UIMessage[]> {\n  if (chunks.length === 0) {\n    return [];\n  }\n\n  const messageIds: string[] = [];\n  const latestById = new Map<string, UIMessage>();\n  let index = 0;\n\n  const stream = new ReadableStream<UIMessageChunk>({\n    pull(controller) {\n      const chunk = chunks[index];\n      if (!chunk) {\n        controller.close();\n        return;\n      }\n\n      controller.enqueue(chunk);\n      index += 1;\n    },\n  });\n\n  try {\n    for await (const message of readUIMessageStream({\n      stream,\n      terminateOnError: false,\n    })) {\n      if (!latestById.has(message.id)) {\n        messageIds.push(message.id);\n      }\n\n      latestById.set(message.id, message);\n    }\n  } catch {\n    // Best effort: keep messages emitted before malformed chunk sequences.\n  }\n\n  const messages: UIMessage[] = [];\n  for (const messageId of messageIds) {\n    const message = latestById.get(messageId);\n    if (message) {\n      messages.push(message);\n    }\n  }\n\n  return messages;\n}\n\nexport async function toUIMessagesFromEvents(\n  events: readonly { type: string; payload: unknown }[]\n): Promise<UIMessage[]> {\n  const messages: UIMessage[] = [];\n  const bufferedChunks: UIMessageChunk[] = [];\n\n  const flushBufferedChunks = async (): Promise<void> => {\n    if (bufferedChunks.length === 0) {\n      return;\n    }\n\n    messages.push(...(await buildChunkMessages(bufferedChunks)));\n    bufferedChunks.length = 0;\n  };\n\n  for (const event of events) {\n    if (!isChatEventType(event.type)) {\n      continue;\n    }\n\n    let envelope: ChatPayloadEnvelope;\n    try {\n      envelope = parseChatPayloadEnvelope(event.payload);\n    } catch {\n      // Skip malformed chat payloads and continue projecting the rest.\n      continue;\n    }\n\n    if (envelope.kind === chatUserMessageEventType) {\n      await flushBufferedChunks();\n      messages.push(envelope.message as unknown as UIMessage);\n      continue;\n    }\n\n    bufferedChunks.push(envelope.chunk as unknown as UIMessageChunk);\n  }\n\n  await flushBufferedChunks();\n  return messages;\n}\n"],"mappings":"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","names":["isChatEventType","isRecord"]}

package/dist/index.d.cts

@@ -0,0 +1,29 @@
+import { SessionAppendInput, AppendResult, SessionEvent, SessionEventListener, SessionOnEventOptions } from '@starcite/sdk';
+import { UIMessage, ChatStatus } from 'ai';
+
+interface StarciteChatSession {
+    readonly id: string;
+    append(input: SessionAppendInput): Promise<AppendResult>;
+    events(): readonly SessionEvent[];
+    on(eventName: "event", listener: SessionEventListener, options?: SessionOnEventOptions<SessionEvent>): () => void;
+    on(eventName: "error", listener: (error: Error) => void): () => void;
+}
+type SendMessageInput = {
+    text: string;
+} | (Omit<UIMessage, "id"> & {
+    id?: string;
+});
+interface UseStarciteChatOptions {
+    session: StarciteChatSession;
+    id?: string;
+    userMessageSource?: string;
+    onError?: (error: Error) => void;
+}
+interface UseStarciteChatResult {
+    messages: UIMessage[];
+    sendMessage: (message: SendMessageInput) => Promise<void>;
+    status: ChatStatus;
+}
+declare function useStarciteChat(options: UseStarciteChatOptions): UseStarciteChatResult;
+
+export { type SendMessageInput, type StarciteChatSession, type UseStarciteChatOptions, type UseStarciteChatResult, useStarciteChat };

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import { SessionAppendInput, AppendResult, SessionEvent, SessionEventListener, SessionOnEventOptions } from '@starcite/sdk';
+import { UIMessage, ChatStatus } from 'ai';
+
+interface StarciteChatSession {
+    readonly id: string;
+    append(input: SessionAppendInput): Promise<AppendResult>;
+    events(): readonly SessionEvent[];
+    on(eventName: "event", listener: SessionEventListener, options?: SessionOnEventOptions<SessionEvent>): () => void;
+    on(eventName: "error", listener: (error: Error) => void): () => void;
+}
+type SendMessageInput = {
+    text: string;
+} | (Omit<UIMessage, "id"> & {
+    id?: string;
+});
+interface UseStarciteChatOptions {
+    session: StarciteChatSession;
+    id?: string;
+    userMessageSource?: string;
+    onError?: (error: Error) => void;
+}
+interface UseStarciteChatResult {
+    messages: UIMessage[];
+    sendMessage: (message: SendMessageInput) => Promise<void>;
+    status: ChatStatus;
+}
+declare function useStarciteChat(options: UseStarciteChatOptions): UseStarciteChatResult;
+
+export { type SendMessageInput, type StarciteChatSession, type UseStarciteChatOptions, type UseStarciteChatResult, useStarciteChat };