@reverbia/sdk 1.0.0-next.20251205130522 → 1.0.0-next.20251208093930

package/dist/expo/index.cjs

@@ -0,0 +1,263 @@
+"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/expo/index.ts
+var index_exports = {};
+__export(index_exports, {
+  useChat: () => useChat
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/expo/useChat.ts
+var import_react = require("react");
+
+// src/clientConfig.ts
+var BASE_URL = "https://ai-portal-dev.zetachain.com";
+
+// src/expo/useChat.ts
+function useChat(options) {
+  const {
+    getToken,
+    baseUrl = BASE_URL,
+    onData: globalOnData,
+    onFinish,
+    onError
+  } = options || {};
+  const [isLoading, setIsLoading] = (0, import_react.useState)(false);
+  const abortControllerRef = (0, import_react.useRef)(null);
+  const stop = (0, import_react.useCallback)(() => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+      abortControllerRef.current = null;
+    }
+  }, []);
+  (0, import_react.useEffect)(() => {
+    return () => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+        abortControllerRef.current = null;
+      }
+    };
+  }, []);
+  const sendMessage = (0, import_react.useCallback)(
+    async ({
+      messages,
+      model,
+      onData
+    }) => {
+      if (!messages?.length) {
+        const errorMsg = "messages are required to call sendMessage.";
+        if (onError) onError(new Error(errorMsg));
+        return { data: null, error: errorMsg };
+      }
+      if (!model) {
+        const errorMsg = "model is required to call sendMessage.";
+        if (onError) onError(new Error(errorMsg));
+        return { data: null, error: errorMsg };
+      }
+      if (!getToken) {
+        const errorMsg = "Token getter function is required.";
+        if (onError) onError(new Error(errorMsg));
+        return { data: null, error: errorMsg };
+      }
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+      }
+      const abortController = new AbortController();
+      abortControllerRef.current = abortController;
+      setIsLoading(true);
+      try {
+        const token = await getToken();
+        if (!token) {
+          const errorMsg = "No access token available.";
+          setIsLoading(false);
+          if (onError) onError(new Error(errorMsg));
+          return { data: null, error: errorMsg };
+        }
+        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;
+          let lastProcessedIndex = 0;
+          let incompleteLineBuffer = "";
+          const abortHandler = () => {
+            xhr.abort();
+          };
+          abortController.signal.addEventListener("abort", abortHandler);
+          xhr.open("POST", url, true);
+          xhr.setRequestHeader("Content-Type", "application/json");
+          xhr.setRequestHeader("Authorization", `Bearer ${token}`);
+          xhr.setRequestHeader("Accept", "text/event-stream");
+          xhr.onprogress = () => {
+            const newData = xhr.responseText.substring(lastProcessedIndex);
+            lastProcessedIndex = xhr.responseText.length;
+            const dataToProcess = incompleteLineBuffer + newData;
+            incompleteLineBuffer = "";
+            const lines = dataToProcess.split("\n");
+            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 {
+                }
+              }
+            }
+          };
+          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 {
+                  }
+                }
+              }
+              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
+              };
+              setIsLoading(false);
+              if (onFinish) onFinish(completion);
+              resolve({ data: completion, error: null });
+            } else {
+              const errorMsg = `Request failed with status ${xhr.status}`;
+              setIsLoading(false);
+              if (onError) onError(new Error(errorMsg));
+              resolve({ data: null, error: errorMsg });
+            }
+          };
+          xhr.onerror = () => {
+            abortController.signal.removeEventListener("abort", abortHandler);
+            const errorMsg = "Network error";
+            setIsLoading(false);
+            if (onError) onError(new Error(errorMsg));
+            resolve({ data: null, error: errorMsg });
+          };
+          xhr.onabort = () => {
+            abortController.signal.removeEventListener("abort", abortHandler);
+            setIsLoading(false);
+            resolve({ data: null, error: "Request aborted" });
+          };
+          xhr.send(
+            JSON.stringify({
+              messages,
+              model,
+              stream: true
+            })
+          );
+        });
+        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 };
+      } finally {
+        if (abortControllerRef.current === abortController) {
+          abortControllerRef.current = null;
+        }
+      }
+    },
+    [getToken, baseUrl, globalOnData, onFinish, onError]
+  );
+  return {
+    isLoading,
+    sendMessage,
+    stop
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useChat
+});

package/dist/expo/index.d.mts

@@ -0,0 +1,199 @@
+/**
+ * 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;
+    /**
+     * CostMicroUSD is the cost of this completion in micro-dollars (USD × 1,000,000)
+     */
+    cost_micro_usd?: 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?: Array<LlmapiMessageContentPart>;
+    role?: LlmapiRole;
+};
+/**
+ * ImageURL is used when Type=image_url
+ */
+type LlmapiMessageContentImage = {
+    /**
+     * Detail is the OpenAI detail hint (auto|low|high)
+     */
+    detail?: string;
+    /**
+     * URL is the image URL or data URI
+     */
+    url?: string;
+};
+type LlmapiMessageContentPart = {
+    image_url?: LlmapiMessageContentImage;
+    /**
+     * Text holds the text content when Type=text
+     */
+    text?: string;
+    /**
+     * Type is the block type (`text` or `image_url`)
+     */
+    type?: string;
+};
+/**
+ * Role is the message role (system, user, assistant)
+ */
+type LlmapiRole = string;
+
+type SendMessageArgs = {
+    messages: LlmapiMessage[];
+    model?: string;
+    /**
+     * Per-request callback for data chunks. Called in addition to the global
+     * `onData` callback if provided in `useChat` options.
+     *
+     * @param chunk - The content delta from the current chunk
+     */
+    onData?: (chunk: string) => void;
+};
+type SendMessageResult = {
+    data: LlmapiChatCompletionResponse;
+    error: null;
+} | {
+    data: null;
+    error: string;
+};
+type UseChatOptions = {
+    getToken?: () => Promise<string | null>;
+    baseUrl?: string;
+    /**
+     * Callback function to be called when a new data chunk is received.
+     */
+    onData?: (chunk: string) => void;
+    /**
+     * Callback function to be called when the chat completion finishes successfully.
+     */
+    onFinish?: (response: LlmapiChatCompletionResponse) => void;
+    /**
+     * Callback function to be called when an unexpected error is encountered.
+     *
+     * **Note:** This callback is NOT called for aborted requests (via `stop()` or
+     * component unmount). Aborts are intentional actions and are not considered
+     * errors. To detect aborts, check the `error` field in the `sendMessage` result:
+     * `result.error === "Request aborted"`.
+     *
+     * @param error - The error that occurred (never an AbortError)
+     */
+    onError?: (error: Error) => void;
+};
+type UseChatResult = {
+    isLoading: boolean;
+    sendMessage: (args: SendMessageArgs) => Promise<SendMessageResult>;
+    /**
+     * Aborts the current streaming request if one is in progress.
+     *
+     * When a request is aborted, `sendMessage` will return with
+     * `{ data: null, error: "Request aborted" }`. The `onError` callback
+     * will NOT be called, as aborts are intentional actions, not errors.
+     */
+    stop: () => void;
+};
+/**
+ * A React hook for managing chat completions with authentication.
+ *
+ * **React Native version** - This is a lightweight version that only supports
+ * API-based chat completions. Local chat and client-side tools are not available
+ * in React Native.
+ *
+ * @param options - Optional configuration object
+ * @param options.getToken - An async function that returns an authentication token.
+ * @param options.baseUrl - Optional base URL for the API requests.
+ * @param options.onData - Callback function to be called when a new data chunk is received.
+ * @param options.onFinish - Callback function to be called when the chat completion finishes successfully.
+ * @param options.onError - Callback function to be called when an unexpected error is encountered.
+ *
+ * @returns An object containing:
+ *   - `isLoading`: A boolean indicating whether a request is currently in progress
+ *   - `sendMessage`: An async function to send chat messages
+ *   - `stop`: A function to abort the current request
+ *
+ * @example
+ * ```tsx
+ * const { isLoading, sendMessage, stop } = useChat({
+ *   getToken: async () => await getAuthToken(),
+ *   onFinish: (response) => console.log("Chat finished:", response),
+ *   onError: (error) => console.error("Chat error:", error)
+ * });
+ *
+ * const handleSend = async () => {
+ *   const result = await sendMessage({
+ *     messages: [{ role: 'user', content: [{ type: 'text', text: 'Hello!' }] }],
+ *     model: 'gpt-4o-mini'
+ *   });
+ * };
+ * ```
+ */
+declare function useChat(options?: UseChatOptions): UseChatResult;
+
+export { useChat };

package/dist/expo/index.d.ts

@@ -0,0 +1,199 @@
+/**
+ * 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;
+    /**
+     * CostMicroUSD is the cost of this completion in micro-dollars (USD × 1,000,000)
+     */
+    cost_micro_usd?: 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?: Array<LlmapiMessageContentPart>;
+    role?: LlmapiRole;
+};
+/**
+ * ImageURL is used when Type=image_url
+ */
+type LlmapiMessageContentImage = {
+    /**
+     * Detail is the OpenAI detail hint (auto|low|high)
+     */
+    detail?: string;
+    /**
+     * URL is the image URL or data URI
+     */
+    url?: string;
+};
+type LlmapiMessageContentPart = {
+    image_url?: LlmapiMessageContentImage;
+    /**
+     * Text holds the text content when Type=text
+     */
+    text?: string;
+    /**
+     * Type is the block type (`text` or `image_url`)
+     */
+    type?: string;
+};
+/**
+ * Role is the message role (system, user, assistant)
+ */
+type LlmapiRole = string;
+
+type SendMessageArgs = {
+    messages: LlmapiMessage[];
+    model?: string;
+    /**
+     * Per-request callback for data chunks. Called in addition to the global
+     * `onData` callback if provided in `useChat` options.
+     *
+     * @param chunk - The content delta from the current chunk
+     */
+    onData?: (chunk: string) => void;
+};
+type SendMessageResult = {
+    data: LlmapiChatCompletionResponse;
+    error: null;
+} | {
+    data: null;
+    error: string;
+};
+type UseChatOptions = {
+    getToken?: () => Promise<string | null>;
+    baseUrl?: string;
+    /**
+     * Callback function to be called when a new data chunk is received.
+     */
+    onData?: (chunk: string) => void;
+    /**
+     * Callback function to be called when the chat completion finishes successfully.
+     */
+    onFinish?: (response: LlmapiChatCompletionResponse) => void;
+    /**
+     * Callback function to be called when an unexpected error is encountered.
+     *
+     * **Note:** This callback is NOT called for aborted requests (via `stop()` or
+     * component unmount). Aborts are intentional actions and are not considered
+     * errors. To detect aborts, check the `error` field in the `sendMessage` result:
+     * `result.error === "Request aborted"`.
+     *
+     * @param error - The error that occurred (never an AbortError)
+     */
+    onError?: (error: Error) => void;
+};
+type UseChatResult = {
+    isLoading: boolean;
+    sendMessage: (args: SendMessageArgs) => Promise<SendMessageResult>;
+    /**
+     * Aborts the current streaming request if one is in progress.
+     *
+     * When a request is aborted, `sendMessage` will return with
+     * `{ data: null, error: "Request aborted" }`. The `onError` callback
+     * will NOT be called, as aborts are intentional actions, not errors.
+     */
+    stop: () => void;
+};
+/**
+ * A React hook for managing chat completions with authentication.
+ *
+ * **React Native version** - This is a lightweight version that only supports
+ * API-based chat completions. Local chat and client-side tools are not available
+ * in React Native.
+ *
+ * @param options - Optional configuration object
+ * @param options.getToken - An async function that returns an authentication token.
+ * @param options.baseUrl - Optional base URL for the API requests.
+ * @param options.onData - Callback function to be called when a new data chunk is received.
+ * @param options.onFinish - Callback function to be called when the chat completion finishes successfully.
+ * @param options.onError - Callback function to be called when an unexpected error is encountered.
+ *
+ * @returns An object containing:
+ *   - `isLoading`: A boolean indicating whether a request is currently in progress
+ *   - `sendMessage`: An async function to send chat messages
+ *   - `stop`: A function to abort the current request
+ *
+ * @example
+ * ```tsx
+ * const { isLoading, sendMessage, stop } = useChat({
+ *   getToken: async () => await getAuthToken(),
+ *   onFinish: (response) => console.log("Chat finished:", response),
+ *   onError: (error) => console.error("Chat error:", error)
+ * });
+ *
+ * const handleSend = async () => {
+ *   const result = await sendMessage({
+ *     messages: [{ role: 'user', content: [{ type: 'text', text: 'Hello!' }] }],
+ *     model: 'gpt-4o-mini'
+ *   });
+ * };
+ * ```
+ */
+declare function useChat(options?: UseChatOptions): UseChatResult;
+
+export { useChat };