@reverbia/sdk 1.0.0-next.20251202130234 → 1.0.0-next.20251202225102

package/dist/react/index.cjs

@@ -46680,6 +46680,7 @@ __export(index_exports, {
   selectTool: () => selectTool,
   useChat: () => useChat,
   useEncryption: () => useEncryption,
+  useImageGeneration: () => useImageGeneration,
   useMemory: () => useMemory,
   useModels: () => useModels
 });
@@ -48430,6 +48431,16 @@ var postApiV1Embeddings = (options) => {
     }
   });
 };
+var postApiV1ImagesGenerations = (options) => {
+  return (options.client ?? client).post({
+    url: "/api/v1/images/generations",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
 var getApiV1Models = (options) => {
   return (options?.client ?? client).get({
     url: "/api/v1/models",
@@ -48913,6 +48924,88 @@ function useModels(options = {}) {
   };
 }
 
+// src/react/useImageGeneration.ts
+var import_react5 = require("react");
+function useImageGeneration(options = {}) {
+  const { getToken, baseUrl = BASE_URL, onFinish, onError } = options;
+  const [isLoading, setIsLoading] = (0, import_react5.useState)(false);
+  const abortControllerRef = (0, import_react5.useRef)(null);
+  (0, import_react5.useEffect)(() => {
+    return () => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+        abortControllerRef.current = null;
+      }
+    };
+  }, []);
+  const stop = (0, import_react5.useCallback)(() => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+      abortControllerRef.current = null;
+    }
+  }, []);
+  const generateImage = (0, import_react5.useCallback)(
+    async (args) => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+      }
+      const abortController = new AbortController();
+      abortControllerRef.current = abortController;
+      setIsLoading(true);
+      try {
+        if (!getToken) {
+          throw new Error("Token getter function is required.");
+        }
+        const token = await getToken();
+        if (!token) {
+          throw new Error("No access token available.");
+        }
+        const response = await postApiV1ImagesGenerations({
+          baseUrl,
+          body: args,
+          headers: {
+            Authorization: `Bearer ${token}`
+          },
+          signal: abortController.signal
+        });
+        if (response.error) {
+          const errorMsg = response.error.error || "Failed to generate image";
+          throw new Error(errorMsg);
+        }
+        if (!response.data) {
+          throw new Error("No data received from image generation API");
+        }
+        const result = response.data;
+        if (onFinish) {
+          onFinish(result);
+        }
+        return { data: result, error: null };
+      } catch (err) {
+        if (err instanceof Error && err.name === "AbortError") {
+          return { data: null, error: "Request aborted" };
+        }
+        const errorMsg = err instanceof Error ? err.message : "Failed to generate image.";
+        const errorObj = err instanceof Error ? err : new Error(errorMsg);
+        if (onError) {
+          onError(errorObj);
+        }
+        return { data: null, error: errorMsg };
+      } finally {
+        if (abortControllerRef.current === abortController) {
+          setIsLoading(false);
+          abortControllerRef.current = null;
+        }
+      }
+    },
+    [getToken, baseUrl, onFinish, onError]
+  );
+  return {
+    isLoading,
+    generateImage,
+    stop
+  };
+}
+
 // src/lib/memory/chat.ts
 var formatMemoriesForChat = (memories, format = "compact") => {
   if (memories.length === 0) {
@@ -48980,6 +49073,7 @@ var extractConversationContext = (messages, maxMessages = 3) => {
   selectTool,
   useChat,
   useEncryption,
+  useImageGeneration,
   useMemory,
   useModels
 });

package/dist/react/index.d.mts

@@ -67,6 +67,96 @@ type LlmapiChoice = {
     index?: number;
     message?: LlmapiMessage;
 };
+/**
+ * ExtraFields contains additional metadata such as provider/model information.
+ */
+type LlmapiImageGenerationExtraFields = {
+    /**
+     * ModelRequested is the model identifier that the client asked for.
+     */
+    model_requested?: string;
+    /**
+     * Provider is the gateway that serviced this request.
+     */
+    provider?: string;
+    /**
+     * RequestType is always "image_generation".
+     */
+    request_type?: string;
+};
+type LlmapiImageGenerationImage = {
+    /**
+     * B64JSON is the base64 payload for models that can only return binary.
+     */
+    b64_json?: string;
+    /**
+     * URL is the signed URL to download the image.
+     */
+    url?: string;
+};
+type LlmapiImageGenerationRequest = {
+    /**
+     * Model is the model identifier to use for generation (e.g., "gpt-image-1").
+     */
+    model?: string;
+    /**
+     * Prompt is the text description of the desired image.
+     */
+    prompt?: string;
+    /**
+     * Quality targets a quality preset (e.g., "auto", "high").
+     */
+    quality?: string;
+    /**
+     * ResponseFormat controls how the generated image is returned (e.g., "url" or "b64_json").
+     */
+    response_format?: string;
+    /**
+     * Size controls the dimensions of the generated image (e.g., "1024x1024").
+     */
+    size?: string;
+};
+type LlmapiImageGenerationResponse = {
+    /**
+     * Created is the Unix timestamp when the image was generated.
+     */
+    created?: number;
+    extra_fields?: LlmapiImageGenerationExtraFields;
+    /**
+     * Images contains the generated images.
+     */
+    images?: Array<LlmapiImageGenerationImage>;
+    /**
+     * Model is the model identifier that generated the image.
+     */
+    model?: string;
+    /**
+     * Provider is the gateway that produced the image.
+     */
+    provider?: string;
+    usage?: LlmapiImageGenerationUsage;
+};
+/**
+ * Usage documents token usage (when available).
+ */
+type LlmapiImageGenerationUsage = {
+    /**
+     * CostMicroUSD is the inference cost for this image generation request
+     */
+    cost_micro_usd?: number;
+    /**
+     * InputTokens is the number of tokens sent in the prompt.
+     */
+    input_tokens?: number;
+    /**
+     * OutputTokens is the number of tokens returned by the model.
+     */
+    output_tokens?: number;
+    /**
+     * TotalTokens is the total number of tokens consumed.
+     */
+    total_tokens?: number;
+};
 /**
  * Message is the generated message
  */
@@ -554,6 +644,42 @@ type UseModelsResult = {
  */
 declare function useModels(options?: UseModelsOptions): UseModelsResult;
 
+type UseImageGenerationOptions = {
+    /**
+     * Custom function to get auth token for API calls
+     */
+    getToken?: () => Promise<string | null>;
+    /**
+     * Optional base URL for the API requests.
+     */
+    baseUrl?: string;
+    /**
+     * Callback function to be called when the generation finishes successfully.
+     */
+    onFinish?: (response: LlmapiImageGenerationResponse) => void;
+    /**
+     * Callback function to be called when an unexpected error is encountered.
+     */
+    onError?: (error: Error) => void;
+};
+type GenerateImageArgs = LlmapiImageGenerationRequest;
+type GenerateImageResult = {
+    data: LlmapiImageGenerationResponse;
+    error: null;
+} | {
+    data: null;
+    error: string;
+};
+type UseImageGenerationResult = {
+    isLoading: boolean;
+    generateImage: (args: GenerateImageArgs) => Promise<GenerateImageResult>;
+    stop: () => void;
+};
+/**
+ * React hook for generating images using the LLM API.
+ */
+declare function useImageGeneration(options?: UseImageGenerationOptions): UseImageGenerationResult;
+
 /**
  * Format memories into a context string that can be included in chat messages
  * @param memories Array of memories with similarity scores
@@ -605,4 +731,4 @@ declare function executeTool(tool: ClientTool, params: Record<string, unknown>):
     error?: string;
 }>;
 
-export { type ClientTool, DEFAULT_TOOL_SELECTOR_MODEL, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, selectTool, useChat, useEncryption, useMemory, useModels };
+export { type ClientTool, DEFAULT_TOOL_SELECTOR_MODEL, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, selectTool, useChat, useEncryption, useImageGeneration, useMemory, useModels };

package/dist/react/index.d.ts

@@ -67,6 +67,96 @@ type LlmapiChoice = {
     index?: number;
     message?: LlmapiMessage;
 };
+/**
+ * ExtraFields contains additional metadata such as provider/model information.
+ */
+type LlmapiImageGenerationExtraFields = {
+    /**
+     * ModelRequested is the model identifier that the client asked for.
+     */
+    model_requested?: string;
+    /**
+     * Provider is the gateway that serviced this request.
+     */
+    provider?: string;
+    /**
+     * RequestType is always "image_generation".
+     */
+    request_type?: string;
+};
+type LlmapiImageGenerationImage = {
+    /**
+     * B64JSON is the base64 payload for models that can only return binary.
+     */
+    b64_json?: string;
+    /**
+     * URL is the signed URL to download the image.
+     */
+    url?: string;
+};
+type LlmapiImageGenerationRequest = {
+    /**
+     * Model is the model identifier to use for generation (e.g., "gpt-image-1").
+     */
+    model?: string;
+    /**
+     * Prompt is the text description of the desired image.
+     */
+    prompt?: string;
+    /**
+     * Quality targets a quality preset (e.g., "auto", "high").
+     */
+    quality?: string;
+    /**
+     * ResponseFormat controls how the generated image is returned (e.g., "url" or "b64_json").
+     */
+    response_format?: string;
+    /**
+     * Size controls the dimensions of the generated image (e.g., "1024x1024").
+     */
+    size?: string;
+};
+type LlmapiImageGenerationResponse = {
+    /**
+     * Created is the Unix timestamp when the image was generated.
+     */
+    created?: number;
+    extra_fields?: LlmapiImageGenerationExtraFields;
+    /**
+     * Images contains the generated images.
+     */
+    images?: Array<LlmapiImageGenerationImage>;
+    /**
+     * Model is the model identifier that generated the image.
+     */
+    model?: string;
+    /**
+     * Provider is the gateway that produced the image.
+     */
+    provider?: string;
+    usage?: LlmapiImageGenerationUsage;
+};
+/**
+ * Usage documents token usage (when available).
+ */
+type LlmapiImageGenerationUsage = {
+    /**
+     * CostMicroUSD is the inference cost for this image generation request
+     */
+    cost_micro_usd?: number;
+    /**
+     * InputTokens is the number of tokens sent in the prompt.
+     */
+    input_tokens?: number;
+    /**
+     * OutputTokens is the number of tokens returned by the model.
+     */
+    output_tokens?: number;
+    /**
+     * TotalTokens is the total number of tokens consumed.
+     */
+    total_tokens?: number;
+};
 /**
  * Message is the generated message
  */
@@ -554,6 +644,42 @@ type UseModelsResult = {
  */
 declare function useModels(options?: UseModelsOptions): UseModelsResult;
 
+type UseImageGenerationOptions = {
+    /**
+     * Custom function to get auth token for API calls
+     */
+    getToken?: () => Promise<string | null>;
+    /**
+     * Optional base URL for the API requests.
+     */
+    baseUrl?: string;
+    /**
+     * Callback function to be called when the generation finishes successfully.
+     */
+    onFinish?: (response: LlmapiImageGenerationResponse) => void;
+    /**
+     * Callback function to be called when an unexpected error is encountered.
+     */
+    onError?: (error: Error) => void;
+};
+type GenerateImageArgs = LlmapiImageGenerationRequest;
+type GenerateImageResult = {
+    data: LlmapiImageGenerationResponse;
+    error: null;
+} | {
+    data: null;
+    error: string;
+};
+type UseImageGenerationResult = {
+    isLoading: boolean;
+    generateImage: (args: GenerateImageArgs) => Promise<GenerateImageResult>;
+    stop: () => void;
+};
+/**
+ * React hook for generating images using the LLM API.
+ */
+declare function useImageGeneration(options?: UseImageGenerationOptions): UseImageGenerationResult;
+
 /**
  * Format memories into a context string that can be included in chat messages
  * @param memories Array of memories with similarity scores
@@ -605,4 +731,4 @@ declare function executeTool(tool: ClientTool, params: Record<string, unknown>):
     error?: string;
 }>;
 
-export { type ClientTool, DEFAULT_TOOL_SELECTOR_MODEL, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, selectTool, useChat, useEncryption, useMemory, useModels };
+export { type ClientTool, DEFAULT_TOOL_SELECTOR_MODEL, type ToolExecutionResult, type ToolParameter, type ToolSelectionResult, createMemoryContextSystemMessage, decryptData, decryptDataBytes, encryptData, executeTool, extractConversationContext, formatMemoriesForChat, selectTool, useChat, useEncryption, useImageGeneration, useMemory, useModels };

package/dist/react/index.mjs

@@ -1745,6 +1745,16 @@ var postApiV1Embeddings = (options) => {
     }
   });
 };
+var postApiV1ImagesGenerations = (options) => {
+  return (options.client ?? client).post({
+    url: "/api/v1/images/generations",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options.headers
+    }
+  });
+};
 var getApiV1Models = (options) => {
   return (options?.client ?? client).get({
     url: "/api/v1/models",
@@ -2228,6 +2238,88 @@ function useModels(options = {}) {
   };
 }
 
+// src/react/useImageGeneration.ts
+import { useCallback as useCallback4, useEffect as useEffect4, useRef as useRef5, useState as useState3 } from "react";
+function useImageGeneration(options = {}) {
+  const { getToken, baseUrl = BASE_URL, onFinish, onError } = options;
+  const [isLoading, setIsLoading] = useState3(false);
+  const abortControllerRef = useRef5(null);
+  useEffect4(() => {
+    return () => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+        abortControllerRef.current = null;
+      }
+    };
+  }, []);
+  const stop = useCallback4(() => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+      abortControllerRef.current = null;
+    }
+  }, []);
+  const generateImage = useCallback4(
+    async (args) => {
+      if (abortControllerRef.current) {
+        abortControllerRef.current.abort();
+      }
+      const abortController = new AbortController();
+      abortControllerRef.current = abortController;
+      setIsLoading(true);
+      try {
+        if (!getToken) {
+          throw new Error("Token getter function is required.");
+        }
+        const token = await getToken();
+        if (!token) {
+          throw new Error("No access token available.");
+        }
+        const response = await postApiV1ImagesGenerations({
+          baseUrl,
+          body: args,
+          headers: {
+            Authorization: `Bearer ${token}`
+          },
+          signal: abortController.signal
+        });
+        if (response.error) {
+          const errorMsg = response.error.error || "Failed to generate image";
+          throw new Error(errorMsg);
+        }
+        if (!response.data) {
+          throw new Error("No data received from image generation API");
+        }
+        const result = response.data;
+        if (onFinish) {
+          onFinish(result);
+        }
+        return { data: result, error: null };
+      } catch (err) {
+        if (err instanceof Error && err.name === "AbortError") {
+          return { data: null, error: "Request aborted" };
+        }
+        const errorMsg = err instanceof Error ? err.message : "Failed to generate image.";
+        const errorObj = err instanceof Error ? err : new Error(errorMsg);
+        if (onError) {
+          onError(errorObj);
+        }
+        return { data: null, error: errorMsg };
+      } finally {
+        if (abortControllerRef.current === abortController) {
+          setIsLoading(false);
+          abortControllerRef.current = null;
+        }
+      }
+    },
+    [getToken, baseUrl, onFinish, onError]
+  );
+  return {
+    isLoading,
+    generateImage,
+    stop
+  };
+}
+
 // src/lib/memory/chat.ts
 var formatMemoriesForChat = (memories, format = "compact") => {
   if (memories.length === 0) {
@@ -2294,6 +2386,7 @@ export {
   selectTool,
   useChat,
   useEncryption,
+  useImageGeneration,
   useMemory,
   useModels
 };

package/package.json

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