@usagetap/sdk 0.1.0

package/dist/react/index.d.cts

@@ -0,0 +1,147 @@
+interface Message {
+    role: "user" | "assistant" | "system";
+    content: string;
+    id?: string;
+}
+interface UseChatWithUsageOptions {
+    /**
+     * API endpoint that handles the chat completion.
+     * Should be a server-side route that uses UsageTap.
+     */
+    api: string;
+    /**
+     * Customer ID to track usage for.
+     * This will be sent to the API endpoint.
+     */
+    customerId: string;
+    /**
+     * Optional feature name for usage tracking.
+     */
+    feature?: string;
+    /**
+     * Optional tags for usage tracking.
+     */
+    tags?: string[];
+    /**
+     * Initial messages to populate the chat.
+     */
+    initialMessages?: Message[];
+    /**
+     * Called when an error occurs.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Called when a response is finished.
+     */
+    onFinish?: (message: Message) => void;
+    /**
+     * Additional headers to send with requests.
+     */
+    headers?: Record<string, string>;
+}
+interface UseChatWithUsageReturn {
+    /**
+     * Current messages in the chat.
+     */
+    messages: Message[];
+    /**
+     * Current input value.
+     */
+    input: string;
+    /**
+     * Set the input value.
+     */
+    setInput: (input: string) => void;
+    /**
+     * Whether a request is in progress.
+     */
+    isLoading: boolean;
+    /**
+     * Current error, if any.
+     */
+    error: Error | null;
+    /**
+     * Append a user message and get a response.
+     */
+    append: (message: Message) => Promise<void>;
+    /**
+     * Submit the current input as a user message.
+     */
+    handleSubmit: (e?: React.FormEvent<HTMLFormElement>) => Promise<void>;
+    /**
+     * Reload the last assistant response.
+     */
+    reload: () => Promise<void>;
+    /**
+     * Stop the current streaming response.
+     */
+    stop: () => void;
+    /**
+     * Clear all messages.
+     */
+    clear: () => void;
+}
+/**
+ * React hook for chat interfaces with UsageTap integration.
+ *
+ * The API endpoint should be a server-side route that:
+ * 1. Receives messages, customerId, feature, and tags
+ * 2. Uses UsageTap SDK to wrap OpenAI calls
+ * 3. Returns streaming or non-streaming responses
+ *
+ * @example
+ * ```tsx
+ * import { useChatWithUsage } from "@usagetap/sdk/react";
+ *
+ * function ChatComponent({ userId }) {
+ *   const { messages, input, setInput, handleSubmit, isLoading } = useChatWithUsage({
+ *     api: "/api/chat",
+ *     customerId: userId,
+ *     feature: "chat.assistant",
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {messages.map((m) => (
+ *         <div key={m.id}>
+ *           <strong>{m.role}:</strong> {m.content}
+ *         </div>
+ *       ))}
+ *       <form onSubmit={handleSubmit}>
+ *         <input
+ *           value={input}
+ *           onChange={(e) => setInput(e.target.value)}
+ *           disabled={isLoading}
+ *         />
+ *         <button type="submit" disabled={isLoading}>
+ *           Send
+ *         </button>
+ *       </form>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * Server route example:
+ * ```ts
+ * // app/api/chat/route.ts
+ * import { streamOpenAIRoute } from "@usagetap/sdk";
+ *
+ * export const POST = streamOpenAIRoute(usageTap, openai, {
+ *   getRequest: async (req) => {
+ *     const body = await req.json();
+ *     return {
+ *       params: { model: "gpt-4o-mini", messages: body.messages },
+ *       context: {
+ *         customerId: body.customerId,
+ *         feature: body.feature,
+ *         tags: body.tags,
+ *       },
+ *     };
+ *   },
+ * });
+ * ```
+ */
+declare function useChatWithUsage(options: UseChatWithUsageOptions): UseChatWithUsageReturn;
+
+export { type Message, type UseChatWithUsageOptions, type UseChatWithUsageReturn, useChatWithUsage };

package/dist/react/index.d.ts

@@ -0,0 +1,147 @@
+interface Message {
+    role: "user" | "assistant" | "system";
+    content: string;
+    id?: string;
+}
+interface UseChatWithUsageOptions {
+    /**
+     * API endpoint that handles the chat completion.
+     * Should be a server-side route that uses UsageTap.
+     */
+    api: string;
+    /**
+     * Customer ID to track usage for.
+     * This will be sent to the API endpoint.
+     */
+    customerId: string;
+    /**
+     * Optional feature name for usage tracking.
+     */
+    feature?: string;
+    /**
+     * Optional tags for usage tracking.
+     */
+    tags?: string[];
+    /**
+     * Initial messages to populate the chat.
+     */
+    initialMessages?: Message[];
+    /**
+     * Called when an error occurs.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Called when a response is finished.
+     */
+    onFinish?: (message: Message) => void;
+    /**
+     * Additional headers to send with requests.
+     */
+    headers?: Record<string, string>;
+}
+interface UseChatWithUsageReturn {
+    /**
+     * Current messages in the chat.
+     */
+    messages: Message[];
+    /**
+     * Current input value.
+     */
+    input: string;
+    /**
+     * Set the input value.
+     */
+    setInput: (input: string) => void;
+    /**
+     * Whether a request is in progress.
+     */
+    isLoading: boolean;
+    /**
+     * Current error, if any.
+     */
+    error: Error | null;
+    /**
+     * Append a user message and get a response.
+     */
+    append: (message: Message) => Promise<void>;
+    /**
+     * Submit the current input as a user message.
+     */
+    handleSubmit: (e?: React.FormEvent<HTMLFormElement>) => Promise<void>;
+    /**
+     * Reload the last assistant response.
+     */
+    reload: () => Promise<void>;
+    /**
+     * Stop the current streaming response.
+     */
+    stop: () => void;
+    /**
+     * Clear all messages.
+     */
+    clear: () => void;
+}
+/**
+ * React hook for chat interfaces with UsageTap integration.
+ *
+ * The API endpoint should be a server-side route that:
+ * 1. Receives messages, customerId, feature, and tags
+ * 2. Uses UsageTap SDK to wrap OpenAI calls
+ * 3. Returns streaming or non-streaming responses
+ *
+ * @example
+ * ```tsx
+ * import { useChatWithUsage } from "@usagetap/sdk/react";
+ *
+ * function ChatComponent({ userId }) {
+ *   const { messages, input, setInput, handleSubmit, isLoading } = useChatWithUsage({
+ *     api: "/api/chat",
+ *     customerId: userId,
+ *     feature: "chat.assistant",
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {messages.map((m) => (
+ *         <div key={m.id}>
+ *           <strong>{m.role}:</strong> {m.content}
+ *         </div>
+ *       ))}
+ *       <form onSubmit={handleSubmit}>
+ *         <input
+ *           value={input}
+ *           onChange={(e) => setInput(e.target.value)}
+ *           disabled={isLoading}
+ *         />
+ *         <button type="submit" disabled={isLoading}>
+ *           Send
+ *         </button>
+ *       </form>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * Server route example:
+ * ```ts
+ * // app/api/chat/route.ts
+ * import { streamOpenAIRoute } from "@usagetap/sdk";
+ *
+ * export const POST = streamOpenAIRoute(usageTap, openai, {
+ *   getRequest: async (req) => {
+ *     const body = await req.json();
+ *     return {
+ *       params: { model: "gpt-4o-mini", messages: body.messages },
+ *       context: {
+ *         customerId: body.customerId,
+ *         feature: body.feature,
+ *         tags: body.tags,
+ *       },
+ *     };
+ *   },
+ * });
+ * ```
+ */
+declare function useChatWithUsage(options: UseChatWithUsageOptions): UseChatWithUsageReturn;
+
+export { type Message, type UseChatWithUsageOptions, type UseChatWithUsageReturn, useChatWithUsage };

package/dist/react/index.js

@@ -0,0 +1,237 @@
+import { useState, useRef, useCallback, useEffect } from 'react';
+
+// src/react/useChatWithUsage.ts
+function isJsonRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function extractAssistantContent(payload) {
+  if (!isJsonRecord(payload)) {
+    return "";
+  }
+  const choices = payload.choices;
+  if (Array.isArray(choices)) {
+    for (const choice of choices) {
+      if (!isJsonRecord(choice)) continue;
+      const message = choice.message;
+      if (!isJsonRecord(message)) continue;
+      const content = message.content;
+      if (typeof content === "string") {
+        return content;
+      }
+    }
+  }
+  const directContent = payload.content;
+  return typeof directContent === "string" ? directContent : "";
+}
+function extractStreamingContent(payload) {
+  if (!isJsonRecord(payload)) {
+    return "";
+  }
+  const choices = payload.choices;
+  if (Array.isArray(choices)) {
+    for (const choice of choices) {
+      if (!isJsonRecord(choice)) continue;
+      const delta = choice.delta;
+      if (!isJsonRecord(delta)) continue;
+      const content = delta.content;
+      if (typeof content === "string") {
+        return content;
+      }
+      if (Array.isArray(content)) {
+        return content.map((entry) => {
+          if (!entry) return "";
+          if (typeof entry === "string") return entry;
+          if (isJsonRecord(entry) && typeof entry.text === "string") return entry.text;
+          return "";
+        }).join("");
+      }
+    }
+  }
+  const directContent = payload.content;
+  return typeof directContent === "string" ? directContent : "";
+}
+function tryParseJson(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return void 0;
+  }
+}
+function isAbortError(error) {
+  if (typeof DOMException !== "undefined" && error instanceof DOMException) {
+    return error.name === "AbortError";
+  }
+  if (isJsonRecord(error) && typeof error.name === "string") {
+    return error.name === "AbortError";
+  }
+  return false;
+}
+function useChatWithUsage(options) {
+  const {
+    api,
+    customerId,
+    feature,
+    tags,
+    initialMessages = [],
+    onError,
+    onFinish,
+    headers: customHeaders = {}
+  } = options;
+  const [messages, setMessages] = useState(initialMessages);
+  const [input, setInput] = useState("");
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const abortControllerRef = useRef(null);
+  const generateId = () => `msg_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+  const append = useCallback(
+    async (message) => {
+      setIsLoading(true);
+      setError(null);
+      const messageWithId = { ...message, id: message.id || generateId() };
+      const newMessages = [...messages, messageWithId];
+      setMessages(newMessages);
+      abortControllerRef.current = new AbortController();
+      try {
+        const response = await fetch(api, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            ...customHeaders
+          },
+          body: JSON.stringify({
+            messages: newMessages,
+            customerId,
+            feature,
+            tags
+          }),
+          signal: abortControllerRef.current.signal
+        });
+        if (!response.ok) {
+          throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        const contentType = response.headers.get("content-type");
+        const isStream = contentType?.includes("text/event-stream") || contentType?.includes("text/plain");
+        if (isStream && response.body) {
+          const reader = response.body.getReader();
+          const decoder = new TextDecoder();
+          let assistantMessage = "";
+          const assistantId = generateId();
+          while (true) {
+            const readResult = await reader.read();
+            if (readResult.done) break;
+            const chunkValue = readResult.value instanceof Uint8Array ? readResult.value : new Uint8Array();
+            const chunk = decoder.decode(chunkValue, { stream: true });
+            const lines = chunk.split("\n");
+            for (const line of lines) {
+              if (line.startsWith("data: ")) {
+                const data = line.slice(6);
+                if (data === "[DONE]") continue;
+                const parsed = tryParseJson(data);
+                if (parsed) {
+                  const content = extractStreamingContent(parsed);
+                  if (content) {
+                    assistantMessage += content;
+                    setMessages([
+                      ...newMessages,
+                      { role: "assistant", content: assistantMessage, id: assistantId }
+                    ]);
+                  }
+                } else {
+                  assistantMessage += data;
+                  setMessages([
+                    ...newMessages,
+                    { role: "assistant", content: assistantMessage, id: assistantId }
+                  ]);
+                }
+              }
+            }
+          }
+          const finalMessage = {
+            role: "assistant",
+            content: assistantMessage,
+            id: assistantId
+          };
+          setMessages([...newMessages, finalMessage]);
+          onFinish?.(finalMessage);
+        } else {
+          const payload = await response.json();
+          const assistantMessage = {
+            role: "assistant",
+            content: extractAssistantContent(payload),
+            id: generateId()
+          };
+          setMessages([...newMessages, assistantMessage]);
+          onFinish?.(assistantMessage);
+        }
+      } catch (err) {
+        if (isAbortError(err)) {
+          return;
+        }
+        const error2 = err instanceof Error ? err : new Error(String(err));
+        setError(error2);
+        onError?.(error2);
+      } finally {
+        setIsLoading(false);
+        abortControllerRef.current = null;
+      }
+    },
+    [messages, api, customerId, feature, tags, customHeaders, onError, onFinish]
+  );
+  const handleSubmit = useCallback(
+    async (e) => {
+      e?.preventDefault();
+      if (!input.trim() || isLoading) return;
+      const userMessage = {
+        role: "user",
+        content: input
+      };
+      setInput("");
+      await append(userMessage);
+    },
+    [input, isLoading, append]
+  );
+  const reload = useCallback(async () => {
+    if (messages.length === 0 || isLoading) return;
+    const messagesWithoutLast = messages.slice(0, -1);
+    const lastUserMessage = [...messagesWithoutLast].reverse().find((m) => m.role === "user");
+    if (lastUserMessage) {
+      setMessages(messagesWithoutLast);
+      await append(lastUserMessage);
+    }
+  }, [messages, isLoading, append]);
+  const stop = useCallback(() => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+      abortControllerRef.current = null;
+      setIsLoading(false);
+    }
+  }, []);
+  const clear = useCallback(() => {
+    setMessages([]);
+    setInput("");
+    setError(null);
+  }, []);
+  useEffect(() => {
+    return () => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+      }
+    };
+  }, []);
+  return {
+    messages,
+    input,
+    setInput,
+    isLoading,
+    error,
+    append,
+    handleSubmit,
+    reload,
+    stop,
+    clear
+  };
+}
+
+export { useChatWithUsage };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/useChatWithUsage.ts"],"names":["error"],"mappings":"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","file":"index.js","sourcesContent":["import { useState, useCallback, useRef, useEffect } from \"react\";\r\nimport type { FormEvent } from \"react\";\r\n\r\ntype JsonRecord = Record<string, unknown>;\r\n\r\nfunction isJsonRecord(value: unknown): value is JsonRecord {\r\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\r\n}\r\n\r\nfunction extractAssistantContent(payload: unknown): string {\r\n  if (!isJsonRecord(payload)) {\r\n    return \"\";\r\n  }\r\n\r\n  const choices = payload.choices;\r\n  if (Array.isArray(choices)) {\r\n    for (const choice of choices) {\r\n      if (!isJsonRecord(choice)) continue;\r\n      const message = choice.message;\r\n      if (!isJsonRecord(message)) continue;\r\n      const content = message.content;\r\n      if (typeof content === \"string\") {\r\n        return content;\r\n      }\r\n    }\r\n  }\r\n\r\n  const directContent = payload.content;\r\n  return typeof directContent === \"string\" ? directContent : \"\";\r\n}\r\n\r\nfunction extractStreamingContent(payload: unknown): string {\r\n  if (!isJsonRecord(payload)) {\r\n    return \"\";\r\n  }\r\n\r\n  const choices = payload.choices;\r\n  if (Array.isArray(choices)) {\r\n    for (const choice of choices) {\r\n      if (!isJsonRecord(choice)) continue;\r\n      const delta = choice.delta;\r\n      if (!isJsonRecord(delta)) continue;\r\n      const content = delta.content;\r\n      if (typeof content === \"string\") {\r\n        return content;\r\n      }\r\n\r\n      if (Array.isArray(content)) {\r\n        return content\r\n          .map((entry) => {\r\n            if (!entry) return \"\";\r\n            if (typeof entry === \"string\") return entry;\r\n            if (isJsonRecord(entry) && typeof entry.text === \"string\") return entry.text;\r\n            return \"\";\r\n          })\r\n          .join(\"\");\r\n      }\r\n    }\r\n  }\r\n\r\n  const directContent = payload.content;\r\n  return typeof directContent === \"string\" ? directContent : \"\";\r\n}\r\n\r\nfunction tryParseJson(text: string): unknown {\r\n  try {\r\n    return JSON.parse(text) as unknown;\r\n  } catch {\r\n    return undefined;\r\n  }\r\n}\r\n\r\nfunction isAbortError(error: unknown): boolean {\r\n  if (typeof DOMException !== \"undefined\" && error instanceof DOMException) {\r\n    return error.name === \"AbortError\";\r\n  }\r\n\r\n  if (isJsonRecord(error) && typeof error.name === \"string\") {\r\n    return error.name === \"AbortError\";\r\n  }\r\n\r\n  return false;\r\n}\r\n\r\nexport interface Message {\r\n  role: \"user\" | \"assistant\" | \"system\";\r\n  content: string;\r\n  id?: string;\r\n}\r\n\r\nexport interface UseChatWithUsageOptions {\r\n  /**\r\n   * API endpoint that handles the chat completion.\r\n   * Should be a server-side route that uses UsageTap.\r\n   */\r\n  api: string;\r\n  \r\n  /**\r\n   * Customer ID to track usage for.\r\n   * This will be sent to the API endpoint.\r\n   */\r\n  customerId: string;\r\n  \r\n  /**\r\n   * Optional feature name for usage tracking.\r\n   */\r\n  feature?: string;\r\n  \r\n  /**\r\n   * Optional tags for usage tracking.\r\n   */\r\n  tags?: string[];\r\n  \r\n  /**\r\n   * Initial messages to populate the chat.\r\n   */\r\n  initialMessages?: Message[];\r\n  \r\n  /**\r\n   * Called when an error occurs.\r\n   */\r\n  onError?: (error: Error) => void;\r\n  \r\n  /**\r\n   * Called when a response is finished.\r\n   */\r\n  onFinish?: (message: Message) => void;\r\n  \r\n  /**\r\n   * Additional headers to send with requests.\r\n   */\r\n  headers?: Record<string, string>;\r\n}\r\n\r\nexport interface UseChatWithUsageReturn {\r\n  /**\r\n   * Current messages in the chat.\r\n   */\r\n  messages: Message[];\r\n  \r\n  /**\r\n   * Current input value.\r\n   */\r\n  input: string;\r\n  \r\n  /**\r\n   * Set the input value.\r\n   */\r\n  setInput: (input: string) => void;\r\n  \r\n  /**\r\n   * Whether a request is in progress.\r\n   */\r\n  isLoading: boolean;\r\n  \r\n  /**\r\n   * Current error, if any.\r\n   */\r\n  error: Error | null;\r\n  \r\n  /**\r\n   * Append a user message and get a response.\r\n   */\r\n  append: (message: Message) => Promise<void>;\r\n  \r\n  /**\r\n   * Submit the current input as a user message.\r\n   */\r\n  handleSubmit: (e?: React.FormEvent<HTMLFormElement>) => Promise<void>;\r\n  \r\n  /**\r\n   * Reload the last assistant response.\r\n   */\r\n  reload: () => Promise<void>;\r\n  \r\n  /**\r\n   * Stop the current streaming response.\r\n   */\r\n  stop: () => void;\r\n  \r\n  /**\r\n   * Clear all messages.\r\n   */\r\n  clear: () => void;\r\n}\r\n\r\n/**\r\n * React hook for chat interfaces with UsageTap integration.\r\n * \r\n * The API endpoint should be a server-side route that:\r\n * 1. Receives messages, customerId, feature, and tags\r\n * 2. Uses UsageTap SDK to wrap OpenAI calls\r\n * 3. Returns streaming or non-streaming responses\r\n * \r\n * @example\r\n * ```tsx\r\n * import { useChatWithUsage } from \"@usagetap/sdk/react\";\r\n *\r\n * function ChatComponent({ userId }) {\r\n *   const { messages, input, setInput, handleSubmit, isLoading } = useChatWithUsage({\r\n *     api: \"/api/chat\",\r\n *     customerId: userId,\r\n *     feature: \"chat.assistant\",\r\n *   });\r\n * \r\n *   return (\r\n *     <div>\r\n *       {messages.map((m) => (\r\n *         <div key={m.id}>\r\n *           <strong>{m.role}:</strong> {m.content}\r\n *         </div>\r\n *       ))}\r\n *       <form onSubmit={handleSubmit}>\r\n *         <input\r\n *           value={input}\r\n *           onChange={(e) => setInput(e.target.value)}\r\n *           disabled={isLoading}\r\n *         />\r\n *         <button type=\"submit\" disabled={isLoading}>\r\n *           Send\r\n *         </button>\r\n *       </form>\r\n *     </div>\r\n *   );\r\n * }\r\n * ```\r\n * \r\n * Server route example:\r\n * ```ts\r\n * // app/api/chat/route.ts\r\n * import { streamOpenAIRoute } from \"@usagetap/sdk\";\r\n * \r\n * export const POST = streamOpenAIRoute(usageTap, openai, {\r\n *   getRequest: async (req) => {\r\n *     const body = await req.json();\r\n *     return {\r\n *       params: { model: \"gpt-4o-mini\", messages: body.messages },\r\n *       context: {\r\n *         customerId: body.customerId,\r\n *         feature: body.feature,\r\n *         tags: body.tags,\r\n *       },\r\n *     };\r\n *   },\r\n * });\r\n * ```\r\n */\r\nexport function useChatWithUsage(options: UseChatWithUsageOptions): UseChatWithUsageReturn {\r\n  const {\r\n    api,\r\n    customerId,\r\n    feature,\r\n    tags,\r\n    initialMessages = [],\r\n    onError,\r\n    onFinish,\r\n    headers: customHeaders = {},\r\n  } = options;\r\n\r\n  const [messages, setMessages] = useState<Message[]>(initialMessages);\r\n  const [input, setInput] = useState(\"\");\r\n  const [isLoading, setIsLoading] = useState(false);\r\n  const [error, setError] = useState<Error | null>(null);\r\n  const abortControllerRef = useRef<AbortController | null>(null);\r\n\r\n  const generateId = (): string => `msg_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;\r\n\r\n  const append = useCallback(\r\n    async (message: Message): Promise<void> => {\r\n      setIsLoading(true);\r\n      setError(null);\r\n\r\n      const messageWithId = { ...message, id: message.id || generateId() };\r\n      const newMessages = [...messages, messageWithId];\r\n      setMessages(newMessages);\r\n\r\n      abortControllerRef.current = new AbortController();\r\n\r\n      try {\r\n        const response = await fetch(api, {\r\n          method: \"POST\",\r\n          headers: {\r\n            \"Content-Type\": \"application/json\",\r\n            ...customHeaders,\r\n          },\r\n          body: JSON.stringify({\r\n            messages: newMessages,\r\n            customerId,\r\n            feature,\r\n            tags,\r\n          }),\r\n          signal: abortControllerRef.current.signal,\r\n        });\r\n\r\n        if (!response.ok) {\r\n          throw new Error(`HTTP error! status: ${response.status}`);\r\n        }\r\n\r\n        const contentType = response.headers.get(\"content-type\");\r\n        const isStream = contentType?.includes(\"text/event-stream\") || contentType?.includes(\"text/plain\");\r\n\r\n        if (isStream && response.body) {\r\n          // Handle streaming response\r\n          const reader = response.body.getReader();\r\n          const decoder = new TextDecoder();\r\n          let assistantMessage = \"\";\r\n          const assistantId = generateId();\r\n\r\n          while (true) {\r\n            const readResult = await reader.read();\r\n            if (readResult.done) break;\r\n\r\n            const chunkValue: Uint8Array = readResult.value instanceof Uint8Array\r\n              ? readResult.value\r\n              : new Uint8Array();\r\n\r\n            const chunk = decoder.decode(chunkValue, { stream: true });\r\n            const lines = chunk.split(\"\\n\");\r\n\r\n            for (const line of lines) {\r\n              if (line.startsWith(\"data: \")) {\r\n                const data = line.slice(6);\r\n                if (data === \"[DONE]\") continue;\r\n\r\n                const parsed = tryParseJson(data);\r\n                if (parsed) {\r\n                  const content = extractStreamingContent(parsed);\r\n                  if (content) {\r\n                    assistantMessage += content;\r\n                    setMessages([\r\n                      ...newMessages,\r\n                      { role: \"assistant\", content: assistantMessage, id: assistantId },\r\n                    ]);\r\n                  }\r\n                } else {\r\n                  // Plain text streaming\r\n                  assistantMessage += data;\r\n                  setMessages([\r\n                    ...newMessages,\r\n                    { role: \"assistant\", content: assistantMessage, id: assistantId },\r\n                  ]);\r\n                }\r\n              }\r\n            }\r\n          }\r\n\r\n          const finalMessage: Message = {\r\n            role: \"assistant\",\r\n            content: assistantMessage,\r\n            id: assistantId,\r\n          };\r\n          \r\n          setMessages([...newMessages, finalMessage]);\r\n          onFinish?.(finalMessage);\r\n        } else {\r\n          // Handle non-streaming response\r\n          const payload = (await response.json()) as unknown;\r\n          const assistantMessage: Message = {\r\n            role: \"assistant\",\r\n            content: extractAssistantContent(payload),\r\n            id: generateId(),\r\n          };\r\n          \r\n          setMessages([...newMessages, assistantMessage]);\r\n          onFinish?.(assistantMessage);\r\n        }\r\n      } catch (err) {\r\n        if (isAbortError(err)) {\r\n          // Request was aborted, don't treat as error\r\n          return;\r\n        }\r\n        \r\n        const error = err instanceof Error ? err : new Error(String(err));\r\n        setError(error);\r\n        onError?.(error);\r\n      } finally {\r\n        setIsLoading(false);\r\n        abortControllerRef.current = null;\r\n      }\r\n    },\r\n    [messages, api, customerId, feature, tags, customHeaders, onError, onFinish],\r\n  );\r\n\r\n  const handleSubmit = useCallback(\r\n  async (e?: FormEvent<HTMLFormElement>): Promise<void> => {\r\n      e?.preventDefault();\r\n      if (!input.trim() || isLoading) return;\r\n\r\n      const userMessage: Message = {\r\n        role: \"user\",\r\n        content: input,\r\n      };\r\n\r\n      setInput(\"\");\r\n      await append(userMessage);\r\n    },\r\n    [input, isLoading, append],\r\n  );\r\n\r\n  const reload = useCallback(async (): Promise<void> => {\r\n    if (messages.length === 0 || isLoading) return;\r\n\r\n    // Remove last assistant message and resend last user message\r\n    const messagesWithoutLast = messages.slice(0, -1);\r\n    const lastUserMessage = [...messagesWithoutLast].reverse().find((m) => m.role === \"user\");\r\n\r\n    if (lastUserMessage) {\r\n      setMessages(messagesWithoutLast);\r\n      await append(lastUserMessage);\r\n    }\r\n  }, [messages, isLoading, append]);\r\n\r\n  const stop = useCallback((): void => {\r\n    if (abortControllerRef.current) {\r\n      abortControllerRef.current.abort();\r\n      abortControllerRef.current = null;\r\n      setIsLoading(false);\r\n    }\r\n  }, []);\r\n\r\n  const clear = useCallback((): void => {\r\n    setMessages([]);\r\n    setInput(\"\");\r\n    setError(null);\r\n  }, []);\r\n\r\n  // Cleanup on unmount\r\n  useEffect(() => {\r\n    return () => {\r\n      if (abortControllerRef.current) {\r\n        abortControllerRef.current.abort();\r\n      }\r\n    };\r\n  }, []);\r\n\r\n  return {\r\n    messages,\r\n    input,\r\n    setInput,\r\n    isLoading,\r\n    error,\r\n    append,\r\n    handleSubmit,\r\n    reload,\r\n    stop,\r\n    clear,\r\n  };\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@usagetap/sdk",
+  "version": "0.1.0",
+  "description": "UsageTap SDK core client plus optional React helpers.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "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"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.mjs",
+      "require": "./dist/react/index.cjs"
+    },
+    "./adapters/openai": {
+      "types": "./dist/adapters/openai.d.ts",
+      "import": "./dist/adapters/openai.mjs",
+      "require": "./dist/adapters/openai.cjs"
+    },
+    "./adapters/openrouter": {
+      "types": "./dist/adapters/openrouter.d.ts",
+      "import": "./dist/adapters/openrouter.mjs",
+      "require": "./dist/adapters/openrouter.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "react": ["dist/react/index.d.ts"]
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "clean": "rimraf dist",
+    "test": "vitest run --coverage",
+    "test:watch": "vitest",
+  "lint": "eslint --config ../../libraries.config.mjs --max-warnings=0 --ignore-pattern \"src/**/*.test.ts\" --ignore-pattern \"src/**/*.test.tsx\" --ignore-pattern \"src/**/*.spec.ts\" --ignore-pattern \"src/**/*.spec.tsx\" \"src/**/*.{ts,tsx}\"",
+  "lint:fix": "eslint --config ../../libraries.config.mjs --fix --ignore-pattern \"src/**/*.test.ts\" --ignore-pattern \"src/**/*.test.tsx\" --ignore-pattern \"src/**/*.spec.ts\" --ignore-pattern \"src/**/*.spec.tsx\" \"src/**/*.{ts,tsx}\"",
+    "docs": "npm run build && api-extractor run --local --verbose && api-documenter markdown --input-folder temp --output-folder docs",
+    "prepare": "npm run build"
+  },
+  "engines": {
+    "node": ">=18.17"
+  },
+  "peerDependencies": {
+    "express": ">=4.0.0",
+    "openai": ">=4.0.0",
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "openai": {
+      "optional": true
+    },
+    "express": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.3",
+    "@types/react": "^19.2.0",
+    "openai": "^4.76.0"
+  },
+  "dependencies": {
+    "lucide-react": "^0.544.0"
+  }
+}