@reverbia/sdk 1.0.0-next.20251119170952 → 1.0.0-next.20251120124145

package/dist/react/index.d.ts

@@ -0,0 +1,139 @@
+/**
+ * ExtraFields contains additional metadata
+ */
+type LlmapiChatCompletionExtraFields = {
+    /**
+     * Latency is the request latency in milliseconds
+     */
+    latency?: number;
+    /**
+     * ModelRequested is the model that was requested
+     */
+    model_requested?: string;
+    /**
+     * Provider is the LLM provider used (e.g., "openai", "anthropic")
+     */
+    provider?: string;
+    /**
+     * RequestType is always "chat_completion"
+     */
+    request_type?: string;
+};
+type LlmapiChatCompletionResponse = {
+    /**
+     * Choices contains the completion choices
+     */
+    choices?: Array<LlmapiChoice>;
+    extra_fields?: LlmapiChatCompletionExtraFields;
+    /**
+     * ID is the completion ID
+     */
+    id?: string;
+    /**
+     * Model is the model used
+     */
+    model?: string;
+    usage?: LlmapiChatCompletionUsage;
+};
+/**
+ * Usage contains token usage information
+ */
+type LlmapiChatCompletionUsage = {
+    /**
+     * CompletionTokens is the number of tokens in the completion
+     */
+    completion_tokens?: number;
+    /**
+     * PromptTokens is the number of tokens in the prompt
+     */
+    prompt_tokens?: number;
+    /**
+     * TotalTokens is the total number of tokens used
+     */
+    total_tokens?: number;
+};
+type LlmapiChoice = {
+    /**
+     * FinishReason indicates why the completion stopped
+     */
+    finish_reason?: string;
+    /**
+     * Index is the choice index
+     */
+    index?: number;
+    message?: LlmapiMessage;
+};
+/**
+ * Message is the generated message
+ */
+type LlmapiMessage = {
+    /**
+     * Content is the message content
+     */
+    content?: string;
+    role?: LlmapiRole;
+};
+/**
+ * Role is the message role (system, user, assistant)
+ */
+type LlmapiRole = string;
+
+type SendMessageArgs = {
+    messages: LlmapiMessage[];
+    model: string;
+};
+type SendMessageResult = {
+    data: LlmapiChatCompletionResponse;
+    error: null;
+} | {
+    data: null;
+    error: string;
+};
+type UseChatOptions = {
+    getToken?: () => Promise<string | null>;
+};
+type UseChatResult = {
+    isLoading: boolean;
+    sendMessage: (args: SendMessageArgs) => Promise<SendMessageResult>;
+};
+/**
+ * A React hook for managing chat completions with authentication.
+ *
+ * This hook provides a convenient way to send chat messages to the LLM API
+ * with automatic token management and loading state handling.
+ *
+ * @param options - Optional configuration object
+ * @param options.getToken - An async function that returns an authentication token.
+ *   This token will be used as a Bearer token in the Authorization header.
+ *   If not provided, `sendMessage` will return an error.
+ *
+ * @returns An object containing:
+ *   - `isLoading`: A boolean indicating whether a request is currently in progress
+ *   - `sendMessage`: An async function to send chat messages
+ *
+ * @example
+ * ```tsx
+ * const { isLoading, sendMessage } = useChat({
+ *   getToken: async () => {
+ *     // Get your auth token from your auth provider
+ *     return await getAuthToken();
+ *   }
+ * });
+ *
+ * const handleSend = async () => {
+ *   const result = await sendMessage({
+ *     messages: [{ role: 'user', content: 'Hello!' }],
+ *     model: 'gpt-4o-mini'
+ *   });
+ *
+ *   if (result.error) {
+ *     console.error(result.error);
+ *   } else {
+ *     console.log(result.data);
+ *   }
+ * };
+ * ```
+ */
+declare function useChat(options?: UseChatOptions): UseChatResult;
+
+export { useChat };

package/dist/react/index.mjs

@@ -0,0 +1,65 @@
+// src/react/useChat.ts
+import { useCallback, useState } from "react";
+import {
+  postApiV1ChatCompletions
+} from "@reverbia/sdk";
+function useChat(options) {
+  const { getToken } = options || {};
+  const [isLoading, setIsLoading] = useState(false);
+  const sendMessage = useCallback(
+    async ({
+      messages,
+      model
+    }) => {
+      if (!messages?.length) {
+        const error = "messages are required to call sendMessage.";
+        return { data: null, error };
+      }
+      if (!model) {
+        const error = "model is required to call sendMessage.";
+        return { data: null, error };
+      }
+      if (!getToken) {
+        const error = "Token getter function is required.";
+        return { data: null, error };
+      }
+      setIsLoading(true);
+      try {
+        const token = await getToken();
+        if (!token) {
+          const error = "No access token available.";
+          setIsLoading(false);
+          return { data: null, error };
+        }
+        const completion = await postApiV1ChatCompletions({
+          body: {
+            messages,
+            model
+          },
+          headers: {
+            Authorization: `Bearer ${token}`
+          }
+        });
+        if (!completion.data) {
+          const error = completion.error?.error ?? "API did not return a completion response.";
+          setIsLoading(false);
+          return { data: null, error };
+        }
+        setIsLoading(false);
+        return { data: completion.data, error: null };
+      } catch (err) {
+        const error = err instanceof Error ? err.message : "Failed to send message.";
+        setIsLoading(false);
+        return { data: null, error };
+      }
+    },
+    [getToken]
+  );
+  return {
+    isLoading,
+    sendMessage
+  };
+}
+export {
+  useChat
+};

package/dist/vercel/index.cjs

@@ -18,13 +18,13 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/vercel/index.ts
-var vercel_exports = {};
-__export(vercel_exports, {
+var index_exports = {};
+__export(index_exports, {
   createAssistantStream: () => createAssistantStream,
   createErrorStream: () => createErrorStream,
   mapMessagesToCompletionPayload: () => mapMessagesToCompletionPayload
 });
-module.exports = __toCommonJS(vercel_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/vercel/messages.ts
 function mapMessagesToCompletionPayload(messages) {

package/dist/vercel/index.d.mts

@@ -1,5 +1,19 @@
 import { UIMessage } from 'ai';
-import { t as LlmapiMessage } from '../types.gen-Ar4CxyYC.mjs';
+
+/**
+ * Message is the generated message
+ */
+type LlmapiMessage = {
+    /**
+     * Content is the message content
+     */
+    content?: string;
+    role?: LlmapiRole;
+};
+/**
+ * Role is the message role (system, user, assistant)
+ */
+type LlmapiRole = string;
 
 /**
  * Converts an array of Vercel AI {@link UIMessage} objects into the

package/dist/vercel/index.d.ts

@@ -1,5 +1,19 @@
 import { UIMessage } from 'ai';
-import { t as LlmapiMessage } from '../types.gen-Ar4CxyYC.js';
+
+/**
+ * Message is the generated message
+ */
+type LlmapiMessage = {
+    /**
+     * Content is the message content
+     */
+    content?: string;
+    role?: LlmapiRole;
+};
+/**
+ * Role is the message role (system, user, assistant)
+ */
+type LlmapiRole = string;
 
 /**
  * Converts an array of Vercel AI {@link UIMessage} objects into the

package/package.json

@@ -1,19 +1,27 @@
 {
   "name": "@reverbia/sdk",
-  "version": "1.0.0-next.20251119170952",
+  "version": "1.0.0-next.20251120124145",
   "description": "",
-  "main": "./dist/client/index.cjs",
-  "module": "./dist/client/index.mjs",
-  "types": "./dist/client/index.d.ts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/client/index.d.ts",
-      "import": "./dist/client/index.mjs",
-      "require": "./dist/client/index.cjs",
-      "default": "./dist/client/index.cjs"
+      "types": "./dist/index.d.ts",
+      "react-server": "./dist/index.mjs",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.mjs",
+      "require": "./dist/react/index.cjs",
+      "default": "./dist/react/index.cjs"
     },
     "./vercel": {
       "types": "./dist/vercel/index.d.ts",
+      "react-server": "./dist/vercel/index.mjs",
       "import": "./dist/vercel/index.mjs",
       "require": "./dist/vercel/index.cjs",
       "default": "./dist/vercel/index.cjs"
@@ -46,10 +54,14 @@
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "0.87.2",
+    "@types/react": "^19.2.6",
     "tsup": "^8.5.1",
     "typedoc": "^0.28.14",
     "typedoc-plugin-frontmatter": "^1.3.0",
     "typedoc-plugin-markdown": "^4.9.0",
     "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
   }
 }