@reverbia/sdk 1.0.0-next.20251208111334 → 1.0.0-next.20251208162906

package/README.md

@@ -177,6 +177,110 @@ if (response.data) {
 }
 ```
 
+## React Native (Expo)
+
+The SDK supports React Native via Expo with streaming support. For a complete
+example, see
+[ai-example-expo](https://github.com/zeta-chain/ai-example-expo).
+
+### Installation
+
+```bash
+pnpm install @reverbia/sdk@next web-streams-polyfill react-native-get-random-values @ethersproject/shims buffer
+```
+
+### Polyfill Setup
+
+Create a custom entry point file (e.g., `entrypoint.js`) and update
+`package.json` to use it:
+
+```json
+{
+  "main": "entrypoint.js"
+}
+```
+
+```javascript
+// entrypoint.js
+
+// Import polyfills in this exact order
+import "react-native-get-random-values";
+import "@ethersproject/shims";
+import { Buffer } from "buffer";
+global.Buffer = Buffer;
+
+// Web Streams polyfill for SSE streaming
+import { ReadableStream, TransformStream } from "web-streams-polyfill";
+if (typeof globalThis.ReadableStream === "undefined") {
+  globalThis.ReadableStream = ReadableStream;
+}
+if (typeof globalThis.TransformStream === "undefined") {
+  globalThis.TransformStream = TransformStream;
+}
+
+// SDK polyfills (TextDecoderStream for streaming)
+import "@reverbia/sdk/polyfills";
+
+// Then import expo router
+import "expo-router/entry";
+```
+
+### Usage
+
+Import from `@reverbia/sdk/expo` instead of `@reverbia/sdk/react`:
+
+```typescript
+import { useIdentityToken } from "@privy-io/expo";
+import { useChat } from "@reverbia/sdk/expo";
+
+function ChatComponent() {
+  const { getIdentityToken } = useIdentityToken();
+
+  const { isLoading, sendMessage } = useChat({
+    getToken: getIdentityToken,
+    baseUrl: "https://ai-portal-dev.zetachain.com",
+    onData: (chunk) => {
+      // Handle streaming chunks
+      const content =
+        typeof chunk === "string"
+          ? chunk
+          : chunk.choices?.[0]?.delta?.content || "";
+      console.log("Received:", content);
+    },
+    onFinish: () => {
+      console.log("Stream finished");
+    },
+    onError: (error) => {
+      console.error("Error:", error);
+    },
+  });
+
+  const handleSend = async () => {
+    await sendMessage({
+      messages: [{ role: "user", content: "Hello!" }],
+      model: "openai/gpt-4o",
+    });
+  };
+}
+```
+
+### Authentication
+
+Use `@privy-io/expo` for authentication in React Native:
+
+```typescript
+import { PrivyProvider, usePrivy } from "@privy-io/expo";
+import { useIdentityToken } from "@privy-io/expo";
+
+// Wrap your app with PrivyProvider
+<PrivyProvider appId="your-app-id" clientId="your-client-id">
+  <App />
+</PrivyProvider>;
+
+// Get identity token for API calls
+const { getIdentityToken } = useIdentityToken();
+```
+
 ## Contributing
 
 Contributions are welcome! Please feel free to submit a pull request.

package/dist/expo/index.cjs

@@ -30,7 +30,136 @@ var import_react = require("react");
 // src/clientConfig.ts
 var BASE_URL = "https://ai-portal-dev.zetachain.com";
 
+// src/lib/chat/useChat/utils.ts
+var VALIDATION_ERROR_MESSAGES = {
+  messages_required: "messages are required to call sendMessage.",
+  model_required: "model is required to call sendMessage.",
+  token_getter_required: "Token getter function is required.",
+  token_unavailable: "No access token available."
+};
+function validateMessages(messages) {
+  if (!messages?.length) {
+    return {
+      valid: false,
+      error: "messages_required",
+      message: VALIDATION_ERROR_MESSAGES.messages_required
+    };
+  }
+  return { valid: true };
+}
+function validateModel(model) {
+  if (!model) {
+    return {
+      valid: false,
+      error: "model_required",
+      message: VALIDATION_ERROR_MESSAGES.model_required
+    };
+  }
+  return { valid: true };
+}
+function validateTokenGetter(getToken) {
+  if (!getToken) {
+    return {
+      valid: false,
+      error: "token_getter_required",
+      message: VALIDATION_ERROR_MESSAGES.token_getter_required
+    };
+  }
+  return { valid: true };
+}
+function validateToken(token) {
+  if (!token) {
+    return {
+      valid: false,
+      error: "token_unavailable",
+      message: VALIDATION_ERROR_MESSAGES.token_unavailable
+    };
+  }
+  return { valid: true };
+}
+function createStreamAccumulator() {
+  return {
+    content: "",
+    completionId: "",
+    completionModel: "",
+    usage: {},
+    finishReason: void 0
+  };
+}
+function buildCompletionResponse(accumulator) {
+  return {
+    id: accumulator.completionId,
+    model: accumulator.completionModel,
+    choices: [
+      {
+        index: 0,
+        message: {
+          role: "assistant",
+          content: [{ type: "text", text: accumulator.content }]
+        },
+        finish_reason: accumulator.finishReason
+      }
+    ],
+    usage: Object.keys(accumulator.usage).length > 0 ? accumulator.usage : void 0
+  };
+}
+function createErrorResult(message, onError) {
+  if (onError) {
+    onError(new Error(message));
+  }
+  return { data: null, error: message };
+}
+function handleError(err, onError) {
+  const errorMsg = err instanceof Error ? err.message : "Failed to send message.";
+  const errorObj = err instanceof Error ? err : new Error(errorMsg);
+  if (onError) {
+    onError(errorObj);
+  }
+  return { data: null, error: errorMsg };
+}
+function parseSSEDataLine(line) {
+  if (!line.startsWith("data: ")) {
+    return null;
+  }
+  const data = line.substring(6).trim();
+  if (data === "[DONE]") {
+    return null;
+  }
+  try {
+    return JSON.parse(data);
+  } catch {
+    return null;
+  }
+}
+
 // src/expo/useChat.ts
+function processSSELines(lines, accumulator, onData, globalOnData) {
+  for (const line of lines) {
+    const chunk = parseSSEDataLine(line);
+    if (!chunk) continue;
+    if (chunk.id && !accumulator.completionId) {
+      accumulator.completionId = chunk.id;
+    }
+    if (chunk.model && !accumulator.completionModel) {
+      accumulator.completionModel = chunk.model;
+    }
+    if (chunk.usage) {
+      accumulator.usage = { ...accumulator.usage, ...chunk.usage };
+    }
+    if (chunk.choices?.[0]) {
+      const choice = chunk.choices[0];
+      if (choice.delta?.content) {
+        const content = choice.delta.content;
+        accumulator.content += content;
+        if (onData) onData(content);
+        if (globalOnData) globalOnData(content);
+      }
+      if (choice.finish_reason) {
+        accumulator.finishReason = choice.finish_reason;
+      }
+    }
+  }
+}
 function useChat(options) {
   const {
     getToken,
@@ -61,20 +190,17 @@ function useChat(options) {
       model,
       onData
     }) => {
-      if (!messages?.length) {
-        const errorMsg = "messages are required to call sendMessage.";
-        if (onError) onError(new Error(errorMsg));
-        return { data: null, error: errorMsg };
+      const messagesValidation = validateMessages(messages);
+      if (!messagesValidation.valid) {
+        return createErrorResult(messagesValidation.message, onError);
       }
-      if (!model) {
-        const errorMsg = "model is required to call sendMessage.";
-        if (onError) onError(new Error(errorMsg));
-        return { data: null, error: errorMsg };
+      const modelValidation = validateModel(model);
+      if (!modelValidation.valid) {
+        return createErrorResult(modelValidation.message, onError);
       }
-      if (!getToken) {
-        const errorMsg = "Token getter function is required.";
-        if (onError) onError(new Error(errorMsg));
-        return { data: null, error: errorMsg };
+      const tokenGetterValidation = validateTokenGetter(getToken);
+      if (!tokenGetterValidation.valid) {
+        return createErrorResult(tokenGetterValidation.message, onError);
       }
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
@@ -84,20 +210,15 @@ function useChat(options) {
       setIsLoading(true);
       try {
         const token = await getToken();
-        if (!token) {
-          const errorMsg = "No access token available.";
+        const tokenValidation = validateToken(token);
+        if (!tokenValidation.valid) {
           setIsLoading(false);
-          if (onError) onError(new Error(errorMsg));
-          return { data: null, error: errorMsg };
+          return createErrorResult(tokenValidation.message, onError);
         }
         const result = await new Promise((resolve) => {
           const xhr = new XMLHttpRequest();
           const url = `${baseUrl}/api/v1/chat/completions`;
-          let accumulatedContent = "";
-          let completionId = "";
-          let completionModel = "";
-          let accumulatedUsage = {};
-          let finishReason;
+          const accumulator = createStreamAccumulator();
           let lastProcessedIndex = 0;
           let incompleteLineBuffer = "";
           const abortHandler = () => {
@@ -117,93 +238,21 @@ function useChat(options) {
             if (!newData.endsWith("\n") && lines.length > 0) {
               incompleteLineBuffer = lines.pop() || "";
             }
-            for (const line of lines) {
-              if (line.startsWith("data: ")) {
-                const data = line.substring(6).trim();
-                if (data === "[DONE]") continue;
-                try {
-                  const chunk = JSON.parse(data);
-                  if (chunk.id && !completionId) {
-                    completionId = chunk.id;
-                  }
-                  if (chunk.model && !completionModel) {
-                    completionModel = chunk.model;
-                  }
-                  if (chunk.usage) {
-                    accumulatedUsage = { ...accumulatedUsage, ...chunk.usage };
-                  }
-                  if (chunk.choices?.[0]) {
-                    const choice = chunk.choices[0];
-                    if (choice.delta?.content) {
-                      const content = choice.delta.content;
-                      accumulatedContent += content;
-                      if (onData) onData(content);
-                      if (globalOnData) globalOnData(content);
-                    }
-                    if (choice.finish_reason) {
-                      finishReason = choice.finish_reason;
-                    }
-                  }
-                } catch {
-                }
-              }
-            }
+            processSSELines(lines, accumulator, onData, globalOnData);
           };
           xhr.onload = () => {
             abortController.signal.removeEventListener("abort", abortHandler);
             if (incompleteLineBuffer) {
-              const line = incompleteLineBuffer.trim();
-              if (line.startsWith("data: ")) {
-                const data = line.substring(6).trim();
-                if (data !== "[DONE]") {
-                  try {
-                    const chunk = JSON.parse(data);
-                    if (chunk.id && !completionId) {
-                      completionId = chunk.id;
-                    }
-                    if (chunk.model && !completionModel) {
-                      completionModel = chunk.model;
-                    }
-                    if (chunk.usage) {
-                      accumulatedUsage = {
-                        ...accumulatedUsage,
-                        ...chunk.usage
-                      };
-                    }
-                    if (chunk.choices?.[0]) {
-                      const choice = chunk.choices[0];
-                      if (choice.delta?.content) {
-                        const content = choice.delta.content;
-                        accumulatedContent += content;
-                        if (onData) onData(content);
-                        if (globalOnData) globalOnData(content);
-                      }
-                      if (choice.finish_reason) {
-                        finishReason = choice.finish_reason;
-                      }
-                    }
-                  } catch {
-                  }
-                }
-              }
+              processSSELines(
+                [incompleteLineBuffer.trim()],
+                accumulator,
+                onData,
+                globalOnData
+              );
               incompleteLineBuffer = "";
             }
             if (xhr.status >= 200 && xhr.status < 300) {
-              const completion = {
-                id: completionId,
-                model: completionModel,
-                choices: [
-                  {
-                    index: 0,
-                    message: {
-                      role: "assistant",
-                      content: [{ type: "text", text: accumulatedContent }]
-                    },
-                    finish_reason: finishReason
-                  }
-                ],
-                usage: Object.keys(accumulatedUsage).length > 0 ? accumulatedUsage : void 0
-              };
+              const completion = buildCompletionResponse(accumulator);
               setIsLoading(false);
               if (onFinish) onFinish(completion);
               resolve({ data: completion, error: null });
@@ -236,13 +285,8 @@ function useChat(options) {
         });
         return result;
       } catch (err) {
-        const errorMsg = err instanceof Error ? err.message : "Failed to send message.";
-        const errorObj = err instanceof Error ? err : new Error(errorMsg);
         setIsLoading(false);
-        if (onError) {
-          onError(errorObj);
-        }
-        return { data: null, error: errorMsg };
+        return handleError(err, onError);
       } finally {
         if (abortControllerRef.current === abortController) {
           abortControllerRef.current = null;

package/dist/expo/index.d.mts

@@ -106,7 +106,10 @@ type LlmapiMessageContentPart = {
  */
 type LlmapiRole = string;
 
-type SendMessageArgs = {
+/**
+ * Base arguments for sending a message
+ */
+type BaseSendMessageArgs = {
     messages: LlmapiMessage[];
     model?: string;
     /**
@@ -117,14 +120,20 @@ type SendMessageArgs = {
      */
     onData?: (chunk: string) => void;
 };
-type SendMessageResult = {
+/**
+ * Base result type for sendMessage
+ */
+type BaseSendMessageResult = {
     data: LlmapiChatCompletionResponse;
     error: null;
 } | {
     data: null;
     error: string;
 };
-type UseChatOptions = {
+/**
+ * Base options for useChat hook
+ */
+type BaseUseChatOptions = {
     getToken?: () => Promise<string | null>;
     baseUrl?: string;
     /**
@@ -147,9 +156,11 @@ type UseChatOptions = {
      */
     onError?: (error: Error) => void;
 };
-type UseChatResult = {
+/**
+ * Base result type for useChat hook
+ */
+type BaseUseChatResult = {
     isLoading: boolean;
-    sendMessage: (args: SendMessageArgs) => Promise<SendMessageResult>;
     /**
      * Aborts the current streaming request if one is in progress.
      *
@@ -159,6 +170,13 @@ type UseChatResult = {
      */
     stop: () => void;
 };
+
+type SendMessageArgs = BaseSendMessageArgs;
+type SendMessageResult = BaseSendMessageResult;
+type UseChatOptions = BaseUseChatOptions;
+type UseChatResult = BaseUseChatResult & {
+    sendMessage: (args: SendMessageArgs) => Promise<SendMessageResult>;
+};
 /**
  * A React hook for managing chat completions with authentication.
  *

package/dist/expo/index.d.ts

@@ -106,7 +106,10 @@ type LlmapiMessageContentPart = {
  */
 type LlmapiRole = string;
 
-type SendMessageArgs = {
+/**
+ * Base arguments for sending a message
+ */
+type BaseSendMessageArgs = {
     messages: LlmapiMessage[];
     model?: string;
     /**
@@ -117,14 +120,20 @@ type SendMessageArgs = {
      */
     onData?: (chunk: string) => void;
 };
-type SendMessageResult = {
+/**
+ * Base result type for sendMessage
+ */
+type BaseSendMessageResult = {
     data: LlmapiChatCompletionResponse;
     error: null;
 } | {
     data: null;
     error: string;
 };
-type UseChatOptions = {
+/**
+ * Base options for useChat hook
+ */
+type BaseUseChatOptions = {
     getToken?: () => Promise<string | null>;
     baseUrl?: string;
     /**
@@ -147,9 +156,11 @@ type UseChatOptions = {
      */
     onError?: (error: Error) => void;
 };
-type UseChatResult = {
+/**
+ * Base result type for useChat hook
+ */
+type BaseUseChatResult = {
     isLoading: boolean;
-    sendMessage: (args: SendMessageArgs) => Promise<SendMessageResult>;
     /**
      * Aborts the current streaming request if one is in progress.
      *
@@ -159,6 +170,13 @@ type UseChatResult = {
      */
     stop: () => void;
 };
+
+type SendMessageArgs = BaseSendMessageArgs;
+type SendMessageResult = BaseSendMessageResult;
+type UseChatOptions = BaseUseChatOptions;
+type UseChatResult = BaseUseChatResult & {
+    sendMessage: (args: SendMessageArgs) => Promise<SendMessageResult>;
+};
 /**
  * A React hook for managing chat completions with authentication.
  *