@reverbia/sdk 1.0.0-next.20251209090511 → 1.0.0-next.20251211090814

package/dist/expo/index.cjs

@@ -21,7 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   useChat: () => useChat,
-  useImageGeneration: () => useImageGeneration
+  useImageGeneration: () => useImageGeneration,
+  useModels: () => useModels
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -1129,6 +1130,12 @@ var postApiV1ImagesGenerations = (options) => {
     }
   });
 };
+var getApiV1Models = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/v1/models",
+    ...options
+  });
+};
 
 // src/react/useImageGeneration.ts
 function useImageGeneration(options = {}) {
@@ -1210,8 +1217,113 @@ function useImageGeneration(options = {}) {
     stop
   };
 }
+
+// src/react/useModels.ts
+var import_react3 = require("react");
+function useModels(options = {}) {
+  const { getToken, baseUrl = BASE_URL, provider, autoFetch = true } = options;
+  const [models, setModels] = (0, import_react3.useState)([]);
+  const [isLoading, setIsLoading] = (0, import_react3.useState)(false);
+  const [error, setError] = (0, import_react3.useState)(null);
+  const getTokenRef = (0, import_react3.useRef)(getToken);
+  const baseUrlRef = (0, import_react3.useRef)(baseUrl);
+  const providerRef = (0, import_react3.useRef)(provider);
+  const abortControllerRef = (0, import_react3.useRef)(null);
+  (0, import_react3.useEffect)(() => {
+    getTokenRef.current = getToken;
+    baseUrlRef.current = baseUrl;
+    providerRef.current = provider;
+  });
+  (0, import_react3.useEffect)(() => {
+    return () => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+        abortControllerRef.current = null;
+      }
+    };
+  }, []);
+  const fetchModels = (0, import_react3.useCallback)(async () => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+    }
+    const abortController = new AbortController();
+    abortControllerRef.current = abortController;
+    const signal = abortController.signal;
+    setIsLoading(true);
+    setError(null);
+    try {
+      let token;
+      if (getTokenRef.current) {
+        token = await getTokenRef.current() ?? void 0;
+      }
+      if (signal.aborted) return;
+      const headers = {};
+      if (token) {
+        headers["Authorization"] = `Bearer ${token}`;
+      }
+      let allModels = [];
+      let nextPageToken;
+      do {
+        if (signal.aborted) return;
+        const response = await getApiV1Models({
+          baseUrl: baseUrlRef.current,
+          headers,
+          query: {
+            provider: providerRef.current,
+            page_token: nextPageToken
+          },
+          signal
+        });
+        if (response.error) {
+          const errorMsg = response.error.error ?? "Failed to fetch models";
+          throw new Error(errorMsg);
+        }
+        if (response.data) {
+          const newModels = response.data.data || [];
+          allModels = [...allModels, ...newModels];
+          nextPageToken = response.data.next_page_token;
+        }
+      } while (nextPageToken);
+      if (signal.aborted) return;
+      setModels(allModels);
+    } catch (err) {
+      if (err instanceof Error && err.name === "AbortError") {
+        return;
+      }
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      if (!signal.aborted) {
+        setIsLoading(false);
+      }
+      if (abortControllerRef.current === abortController) {
+        abortControllerRef.current = null;
+      }
+    }
+  }, []);
+  const refetch = (0, import_react3.useCallback)(async () => {
+    setModels([]);
+    await fetchModels();
+  }, [fetchModels]);
+  const hasFetchedRef = (0, import_react3.useRef)(false);
+  (0, import_react3.useEffect)(() => {
+    if (autoFetch && !hasFetchedRef.current) {
+      hasFetchedRef.current = true;
+      fetchModels();
+    }
+    if (!autoFetch) {
+      hasFetchedRef.current = false;
+    }
+  }, [autoFetch, fetchModels]);
+  return {
+    models,
+    isLoading,
+    error,
+    refetch
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   useChat,
-  useImageGeneration
+  useImageGeneration,
+  useModels
 });

package/dist/expo/index.d.mts

@@ -191,6 +191,99 @@ type LlmapiMessageContentPart = {
      */
     type?: string;
 };
+type LlmapiModel = {
+    architecture?: LlmapiModelArchitecture;
+    /**
+     * CanonicalSlug is the canonical slug for the model
+     */
+    canonical_slug?: string;
+    /**
+     * ContextLength is the maximum context length in tokens
+     */
+    context_length?: number;
+    /**
+     * Created is the Unix timestamp of when the model was created
+     */
+    created?: number;
+    /**
+     * DefaultParameters contains default parameter values
+     */
+    default_parameters?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Description describes the model and its capabilities
+     */
+    description?: string;
+    /**
+     * HuggingFaceID is the Hugging Face model identifier
+     */
+    hugging_face_id?: string;
+    /**
+     * ID is the model identifier (e.g., "openai/gpt-4")
+     */
+    id?: string;
+    /**
+     * MaxInputTokens is the maximum input tokens
+     */
+    max_input_tokens?: number;
+    /**
+     * MaxOutputTokens is the maximum output tokens
+     */
+    max_output_tokens?: number;
+    /**
+     * Name is the human-readable model name (optional)
+     */
+    name?: string;
+    /**
+     * OwnedBy is the organization that owns the model
+     */
+    owned_by?: string;
+    per_request_limits?: LlmapiModelPerRequestLimits;
+    pricing?: LlmapiModelPricing;
+    /**
+     * SupportedMethods is a list of supported API methods
+     */
+    supported_methods?: Array<string>;
+    /**
+     * SupportedParameters is a list of supported parameter names
+     */
+    supported_parameters?: Array<string>;
+    top_provider?: LlmapiModelTopProvider;
+};
+/**
+ * Architecture describes the model's technical capabilities
+ */
+type LlmapiModelArchitecture = {
+    instruct_type?: string;
+    modality?: string;
+    prompt_formatting?: string;
+    tokenizer?: string;
+};
+/**
+ * PerRequestLimits contains rate limiting information
+ */
+type LlmapiModelPerRequestLimits = {
+    completion_tokens?: number;
+    prompt_tokens?: number;
+};
+/**
+ * Pricing contains the pricing structure for using this model
+ */
+type LlmapiModelPricing = {
+    completion?: string;
+    image?: string;
+    prompt?: string;
+    request?: string;
+};
+/**
+ * TopProvider contains configuration details for the primary provider
+ */
+type LlmapiModelTopProvider = {
+    context_length?: number;
+    is_moderated?: boolean;
+    max_completion_tokens?: number;
+};
 /**
  * Role is the message role (system, user, assistant)
  */
@@ -340,4 +433,34 @@ type UseImageGenerationResult = {
  */
 declare function useImageGeneration(options?: UseImageGenerationOptions): UseImageGenerationResult;
 
-export { useChat, useImageGeneration };
+type UseModelsOptions = {
+    /**
+     * Custom function to get auth token for API calls
+     */
+    getToken?: () => Promise<string | null>;
+    /**
+     * Optional base URL for the API requests.
+     */
+    baseUrl?: string;
+    /**
+     * Optional filter for specific provider (e.g. "openai")
+     */
+    provider?: string;
+    /**
+     * Whether to fetch models automatically on mount (default: true)
+     */
+    autoFetch?: boolean;
+};
+type UseModelsResult = {
+    models: LlmapiModel[];
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * React hook for fetching available LLM models.
+ * Automatically fetches all available models.
+ */
+declare function useModels(options?: UseModelsOptions): UseModelsResult;
+
+export { type UseModelsOptions, type UseModelsResult, useChat, useImageGeneration, useModels };

package/dist/expo/index.d.ts

@@ -191,6 +191,99 @@ type LlmapiMessageContentPart = {
      */
     type?: string;
 };
+type LlmapiModel = {
+    architecture?: LlmapiModelArchitecture;
+    /**
+     * CanonicalSlug is the canonical slug for the model
+     */
+    canonical_slug?: string;
+    /**
+     * ContextLength is the maximum context length in tokens
+     */
+    context_length?: number;
+    /**
+     * Created is the Unix timestamp of when the model was created
+     */
+    created?: number;
+    /**
+     * DefaultParameters contains default parameter values
+     */
+    default_parameters?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Description describes the model and its capabilities
+     */
+    description?: string;
+    /**
+     * HuggingFaceID is the Hugging Face model identifier
+     */
+    hugging_face_id?: string;
+    /**
+     * ID is the model identifier (e.g., "openai/gpt-4")
+     */
+    id?: string;
+    /**
+     * MaxInputTokens is the maximum input tokens
+     */
+    max_input_tokens?: number;
+    /**
+     * MaxOutputTokens is the maximum output tokens
+     */
+    max_output_tokens?: number;
+    /**
+     * Name is the human-readable model name (optional)
+     */
+    name?: string;
+    /**
+     * OwnedBy is the organization that owns the model
+     */
+    owned_by?: string;
+    per_request_limits?: LlmapiModelPerRequestLimits;
+    pricing?: LlmapiModelPricing;
+    /**
+     * SupportedMethods is a list of supported API methods
+     */
+    supported_methods?: Array<string>;
+    /**
+     * SupportedParameters is a list of supported parameter names
+     */
+    supported_parameters?: Array<string>;
+    top_provider?: LlmapiModelTopProvider;
+};
+/**
+ * Architecture describes the model's technical capabilities
+ */
+type LlmapiModelArchitecture = {
+    instruct_type?: string;
+    modality?: string;
+    prompt_formatting?: string;
+    tokenizer?: string;
+};
+/**
+ * PerRequestLimits contains rate limiting information
+ */
+type LlmapiModelPerRequestLimits = {
+    completion_tokens?: number;
+    prompt_tokens?: number;
+};
+/**
+ * Pricing contains the pricing structure for using this model
+ */
+type LlmapiModelPricing = {
+    completion?: string;
+    image?: string;
+    prompt?: string;
+    request?: string;
+};
+/**
+ * TopProvider contains configuration details for the primary provider
+ */
+type LlmapiModelTopProvider = {
+    context_length?: number;
+    is_moderated?: boolean;
+    max_completion_tokens?: number;
+};
 /**
  * Role is the message role (system, user, assistant)
  */
@@ -340,4 +433,34 @@ type UseImageGenerationResult = {
  */
 declare function useImageGeneration(options?: UseImageGenerationOptions): UseImageGenerationResult;
 
-export { useChat, useImageGeneration };
+type UseModelsOptions = {
+    /**
+     * Custom function to get auth token for API calls
+     */
+    getToken?: () => Promise<string | null>;
+    /**
+     * Optional base URL for the API requests.
+     */
+    baseUrl?: string;
+    /**
+     * Optional filter for specific provider (e.g. "openai")
+     */
+    provider?: string;
+    /**
+     * Whether to fetch models automatically on mount (default: true)
+     */
+    autoFetch?: boolean;
+};
+type UseModelsResult = {
+    models: LlmapiModel[];
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+/**
+ * React hook for fetching available LLM models.
+ * Automatically fetches all available models.
+ */
+declare function useModels(options?: UseModelsOptions): UseModelsResult;
+
+export { type UseModelsOptions, type UseModelsResult, useChat, useImageGeneration, useModels };

package/dist/expo/index.mjs

@@ -1102,6 +1102,12 @@ var postApiV1ImagesGenerations = (options) => {
     }
   });
 };
+var getApiV1Models = (options) => {
+  return (options?.client ?? client).get({
+    url: "/api/v1/models",
+    ...options
+  });
+};
 
 // src/react/useImageGeneration.ts
 function useImageGeneration(options = {}) {
@@ -1183,7 +1189,112 @@ function useImageGeneration(options = {}) {
     stop
   };
 }
+
+// src/react/useModels.ts
+import { useCallback as useCallback3, useEffect as useEffect3, useRef as useRef3, useState as useState3 } from "react";
+function useModels(options = {}) {
+  const { getToken, baseUrl = BASE_URL, provider, autoFetch = true } = options;
+  const [models, setModels] = useState3([]);
+  const [isLoading, setIsLoading] = useState3(false);
+  const [error, setError] = useState3(null);
+  const getTokenRef = useRef3(getToken);
+  const baseUrlRef = useRef3(baseUrl);
+  const providerRef = useRef3(provider);
+  const abortControllerRef = useRef3(null);
+  useEffect3(() => {
+    getTokenRef.current = getToken;
+    baseUrlRef.current = baseUrl;
+    providerRef.current = provider;
+  });
+  useEffect3(() => {
+    return () => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+        abortControllerRef.current = null;
+      }
+    };
+  }, []);
+  const fetchModels = useCallback3(async () => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+    }
+    const abortController = new AbortController();
+    abortControllerRef.current = abortController;
+    const signal = abortController.signal;
+    setIsLoading(true);
+    setError(null);
+    try {
+      let token;
+      if (getTokenRef.current) {
+        token = await getTokenRef.current() ?? void 0;
+      }
+      if (signal.aborted) return;
+      const headers = {};
+      if (token) {
+        headers["Authorization"] = `Bearer ${token}`;
+      }
+      let allModels = [];
+      let nextPageToken;
+      do {
+        if (signal.aborted) return;
+        const response = await getApiV1Models({
+          baseUrl: baseUrlRef.current,
+          headers,
+          query: {
+            provider: providerRef.current,
+            page_token: nextPageToken
+          },
+          signal
+        });
+        if (response.error) {
+          const errorMsg = response.error.error ?? "Failed to fetch models";
+          throw new Error(errorMsg);
+        }
+        if (response.data) {
+          const newModels = response.data.data || [];
+          allModels = [...allModels, ...newModels];
+          nextPageToken = response.data.next_page_token;
+        }
+      } while (nextPageToken);
+      if (signal.aborted) return;
+      setModels(allModels);
+    } catch (err) {
+      if (err instanceof Error && err.name === "AbortError") {
+        return;
+      }
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      if (!signal.aborted) {
+        setIsLoading(false);
+      }
+      if (abortControllerRef.current === abortController) {
+        abortControllerRef.current = null;
+      }
+    }
+  }, []);
+  const refetch = useCallback3(async () => {
+    setModels([]);
+    await fetchModels();
+  }, [fetchModels]);
+  const hasFetchedRef = useRef3(false);
+  useEffect3(() => {
+    if (autoFetch && !hasFetchedRef.current) {
+      hasFetchedRef.current = true;
+      fetchModels();
+    }
+    if (!autoFetch) {
+      hasFetchedRef.current = false;
+    }
+  }, [autoFetch, fetchModels]);
+  return {
+    models,
+    isLoading,
+    error,
+    refetch
+  };
+}
 export {
   useChat,
-  useImageGeneration
+  useImageGeneration,
+  useModels
 };

package/dist/react/index.cjs

@@ -1279,7 +1279,8 @@ function useChat(options) {
       messages,
       model,
       onData,
-      runTools = true
+      runTools = true,
+      headers
     }) => {
       const messagesValidation = validateMessages(messages);
       if (!messagesValidation.valid) {
@@ -1468,7 +1469,8 @@ Please inform the user about this issue and try to help them alternatively.`
             },
             headers: {
               "Content-Type": "application/json",
-              Authorization: `Bearer ${token}`
+              Authorization: `Bearer ${token}`,
+              ...headers
             },
             signal: abortController.signal
           });

package/dist/react/index.d.mts

@@ -456,6 +456,10 @@ type SendMessageArgs = BaseSendMessageArgs & {
      * Defaults to true if tools are configured.
      */
     runTools?: boolean;
+    /**
+     * Optional custom headers to include with the request.
+     */
+    headers?: Record<string, string>;
 };
 type SendMessageResult = {
     data: LlmapiChatCompletionResponse;

package/dist/react/index.d.ts

@@ -456,6 +456,10 @@ type SendMessageArgs = BaseSendMessageArgs & {
      * Defaults to true if tools are configured.
      */
     runTools?: boolean;
+    /**
+     * Optional custom headers to include with the request.
+     */
+    headers?: Record<string, string>;
 };
 type SendMessageResult = {
     data: LlmapiChatCompletionResponse;

package/dist/react/index.mjs

@@ -1225,7 +1225,8 @@ function useChat(options) {
       messages,
       model,
       onData,
-      runTools = true
+      runTools = true,
+      headers
     }) => {
       const messagesValidation = validateMessages(messages);
       if (!messagesValidation.valid) {
@@ -1414,7 +1415,8 @@ Please inform the user about this issue and try to help them alternatively.`
             },
             headers: {
               "Content-Type": "application/json",
-              Authorization: `Bearer ${token}`
+              Authorization: `Bearer ${token}`,
+              ...headers
             },
             signal: abortController.signal
           });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reverbia/sdk",
-  "version": "1.0.0-next.20251209090511",
+  "version": "1.0.0-next.20251211090814",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",