@umituz/react-native-ai-groq-provider 1.0.3 → 1.0.5

package/dist/infrastructure/utils/error-mapper.util.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Error Mapper Utility
+ * Utilities for handling and mapping errors
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUserFriendlyError = getUserFriendlyError;
+exports.isRetryableError = isRetryableError;
+exports.isAuthError = isAuthError;
+exports.formatErrorForLogging = formatErrorForLogging;
+const error_types_1 = require("../../domain/entities/error.types");
+/**
+ * Get user-friendly error message
+ */
+function getUserFriendlyError(error) {
+    if (error instanceof error_types_1.GroqError) {
+        switch (error.type) {
+            case error_types_1.GroqErrorType.INVALID_API_KEY:
+                return "Invalid API key. Please check your Groq API credentials.";
+            case error_types_1.GroqErrorType.MISSING_CONFIG:
+                return "Configuration missing. Please initialize the Groq provider.";
+            case error_types_1.GroqErrorType.NETWORK_ERROR:
+                return "Network error. Please check your internet connection.";
+            case error_types_1.GroqErrorType.ABORT_ERROR:
+                return "Request was cancelled.";
+            case error_types_1.GroqErrorType.RATE_LIMIT_ERROR:
+                return "Rate limit exceeded. Please wait a moment and try again.";
+            case error_types_1.GroqErrorType.QUOTA_EXCEEDED:
+                return "API quota exceeded. Please check your Groq account.";
+            case error_types_1.GroqErrorType.SERVER_ERROR:
+                return "Groq server error. Please try again later.";
+            default:
+                return error.message || "An unknown error occurred.";
+        }
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return "An unknown error occurred.";
+}
+/**
+ * Check if error is retryable
+ */
+function isRetryableError(error) {
+    if (error instanceof error_types_1.GroqError) {
+        return (error.type === error_types_1.GroqErrorType.RATE_LIMIT_ERROR ||
+            error.type === error_types_1.GroqErrorType.SERVER_ERROR ||
+            error.type === error_types_1.GroqErrorType.NETWORK_ERROR);
+    }
+    return false;
+}
+/**
+ * Check if error is authentication related
+ */
+function isAuthError(error) {
+    if (error instanceof error_types_1.GroqError) {
+        return error.type === error_types_1.GroqErrorType.INVALID_API_KEY;
+    }
+    return false;
+}
+/**
+ * Format error for logging
+ */
+function formatErrorForLogging(error) {
+    if (error instanceof error_types_1.GroqError) {
+        return `[GroqError:${error.type}] ${error.message}`;
+    }
+    if (error instanceof Error) {
+        return `[${error.name}] ${error.message}`;
+    }
+    return String(error);
+}
+//# sourceMappingURL=error-mapper.util.js.map

package/dist/infrastructure/utils/error-mapper.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-mapper.util.js","sourceRoot":"","sources":["../../../src/infrastructure/utils/error-mapper.util.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAOH,oDA2BC;AAKD,4CASC;AAKD,kCAKC;AAKD,sDAUC;AAvED,mEAA6E;AAE7E;;GAEG;AACH,SAAgB,oBAAoB,CAAC,KAAc;IACjD,IAAI,KAAK,YAAY,uBAAS,EAAE,CAAC;QAC/B,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,2BAAa,CAAC,eAAe;gBAChC,OAAO,0DAA0D,CAAC;YACpE,KAAK,2BAAa,CAAC,cAAc;gBAC/B,OAAO,6DAA6D,CAAC;YACvE,KAAK,2BAAa,CAAC,aAAa;gBAC9B,OAAO,uDAAuD,CAAC;YACjE,KAAK,2BAAa,CAAC,WAAW;gBAC5B,OAAO,wBAAwB,CAAC;YAClC,KAAK,2BAAa,CAAC,gBAAgB;gBACjC,OAAO,0DAA0D,CAAC;YACpE,KAAK,2BAAa,CAAC,cAAc;gBAC/B,OAAO,qDAAqD,CAAC;YAC/D,KAAK,2BAAa,CAAC,YAAY;gBAC7B,OAAO,4CAA4C,CAAC;YACtD;gBACE,OAAO,KAAK,CAAC,OAAO,IAAI,4BAA4B,CAAC;QACzD,CAAC;IACH,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,4BAA4B,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,IAAI,KAAK,YAAY,uBAAS,EAAE,CAAC;QAC/B,OAAO,CACL,KAAK,CAAC,IAAI,KAAK,2BAAa,CAAC,gBAAgB;YAC7C,KAAK,CAAC,IAAI,KAAK,2BAAa,CAAC,YAAY;YACzC,KAAK,CAAC,IAAI,KAAK,2BAAa,CAAC,aAAa,CAC3C,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,uBAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,IAAI,KAAK,2BAAa,CAAC,eAAe,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,KAAc;IAClD,IAAI,KAAK,YAAY,uBAAS,EAAE,CAAC;QAC/B,OAAO,cAAc,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACtD,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/infrastructure/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Infrastructure Utilities
+ */
+export * from "./content-mapper.util";
+export * from "./error-mapper.util";
+export * from "./async";
+//# sourceMappingURL=index.d.ts.map

package/dist/infrastructure/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}

package/dist/infrastructure/utils/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Infrastructure Utilities
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./content-mapper.util"), exports);
+__exportStar(require("./error-mapper.util"), exports);
+__exportStar(require("./async"), exports);
+//# sourceMappingURL=index.js.map

package/dist/infrastructure/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/infrastructure/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,wDAAsC;AACtC,sDAAoC;AACpC,0CAAwB"}

package/dist/presentation/hooks/useGroq.d.ts

@@ -0,0 +1,42 @@
+/**
+ * useGroq Hook
+ * Main React hook for Groq text generation
+ */
+import type { GroqGenerationConfig } from "../../domain/entities";
+export interface UseGroqOptions {
+    /** Initial model to use */
+    model?: string;
+    /** Default generation config */
+    generationConfig?: GroqGenerationConfig;
+    /** Callback when generation starts */
+    onStart?: () => void;
+    /** Callback when generation completes */
+    onSuccess?: (result: string) => void;
+    /** Callback when generation fails */
+    onError?: (error: string) => void;
+}
+export interface UseGroqReturn {
+    /** Loading state */
+    isLoading: boolean;
+    /** Error message */
+    error: string | null;
+    /** Generated result */
+    result: string | null;
+    /** Generate text from a prompt */
+    generate: (prompt: string, options?: GroqGenerationConfig) => Promise<string>;
+    /** Generate structured JSON output */
+    generateJSON: <T = Record<string, unknown>>(prompt: string, options?: GroqGenerationConfig & {
+        schema?: Record<string, unknown>;
+    }) => Promise<T>;
+    /** Stream text generation */
+    stream: (prompt: string, onChunk: (chunk: string) => void, options?: GroqGenerationConfig) => Promise<void>;
+    /** Reset state */
+    reset: () => void;
+    /** Clear error */
+    clearError: () => void;
+}
+/**
+ * Hook for Groq text generation
+ */
+export declare function useGroq(options?: UseGroqOptions): UseGroqReturn;
+//# sourceMappingURL=useGroq.d.ts.map

package/dist/presentation/hooks/useGroq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGroq.d.ts","sourceRoot":"","sources":["../../../src/presentation/hooks/useGroq.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAkB,MAAM,uBAAuB,CAAC;AASlF,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,yCAAyC;IACzC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,qCAAqC;IACrC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,oBAAoB;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uBAAuB;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,kCAAkC;IAClC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,sCAAsC;IACtC,YAAY,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,oBAAoB,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAClE,OAAO,CAAC,CAAC,CAAC,CAAC;IAChB,6BAA6B;IAC7B,MAAM,EAAE,CACN,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAChC,OAAO,CAAC,EAAE,oBAAoB,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,kBAAkB;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,kBAAkB;IAClB,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CAsKnE"}

package/dist/presentation/hooks/useGroq.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * useGroq Hook
+ * Main React hook for Groq text generation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useGroq = useGroq;
+const react_1 = require("react");
+const TextGeneration_1 = require("../../infrastructure/services/TextGeneration");
+const StructuredText_1 = require("../../infrastructure/services/StructuredText");
+const Streaming_1 = require("../../infrastructure/services/Streaming");
+const error_mapper_util_1 = require("../../infrastructure/utils/error-mapper.util");
+const telemetry_1 = require("../../infrastructure/telemetry");
+/**
+ * Hook for Groq text generation
+ */
+function useGroq(options = {}) {
+    const [isLoading, setIsLoading] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    const [result, setResult] = (0, react_1.useState)(null);
+    const abortControllerRef = (0, react_1.useRef)(null);
+    const generate = (0, react_1.useCallback)(async (prompt, config) => {
+        // Cancel any ongoing request
+        if (abortControllerRef.current) {
+            abortControllerRef.current.abort();
+        }
+        abortControllerRef.current = new AbortController();
+        setIsLoading(true);
+        setError(null);
+        setResult(null);
+        telemetry_1.telemetry.log("groq_generate_start", { prompt: prompt.substring(0, 100) });
+        options.onStart?.();
+        try {
+            const response = await (0, TextGeneration_1.textGeneration)(prompt, {
+                model: options.model,
+                generationConfig: { ...options.generationConfig, ...config },
+            });
+            setResult(response);
+            options.onSuccess?.(response);
+            telemetry_1.telemetry.log("groq_generate_success", { responseLength: response.length });
+            return response;
+        }
+        catch (err) {
+            const errorMessage = (0, error_mapper_util_1.getUserFriendlyError)(err);
+            setError(errorMessage);
+            options.onError?.(errorMessage);
+            telemetry_1.telemetry.log("groq_generate_error", { error: errorMessage });
+            throw err;
+        }
+        finally {
+            setIsLoading(false);
+            abortControllerRef.current = null;
+        }
+    }, [options]);
+    const generateJSON = (0, react_1.useCallback)(async (prompt, config) => {
+        // Cancel any ongoing request
+        if (abortControllerRef.current) {
+            abortControllerRef.current.abort();
+        }
+        abortControllerRef.current = new AbortController();
+        setIsLoading(true);
+        setError(null);
+        setResult(null);
+        telemetry_1.telemetry.log("groq_generate_json_start", { prompt: prompt.substring(0, 100) });
+        options.onStart?.();
+        try {
+            const response = await (0, StructuredText_1.structuredText)(prompt, {
+                model: options.model,
+                generationConfig: { ...options.generationConfig, ...config },
+                schema: config?.schema,
+            });
+            setResult(JSON.stringify(response, null, 2));
+            options.onSuccess?.(JSON.stringify(response, null, 2));
+            telemetry_1.telemetry.log("groq_generate_json_success");
+            return response;
+        }
+        catch (err) {
+            const errorMessage = (0, error_mapper_util_1.getUserFriendlyError)(err);
+            setError(errorMessage);
+            options.onError?.(errorMessage);
+            telemetry_1.telemetry.log("groq_generate_json_error", { error: errorMessage });
+            throw err;
+        }
+        finally {
+            setIsLoading(false);
+            abortControllerRef.current = null;
+        }
+    }, [options]);
+    const stream = (0, react_1.useCallback)(async (prompt, onChunk, config) => {
+        // Cancel any ongoing request
+        if (abortControllerRef.current) {
+            abortControllerRef.current.abort();
+        }
+        abortControllerRef.current = new AbortController();
+        setIsLoading(true);
+        setError(null);
+        setResult(null);
+        let fullContent = "";
+        telemetry_1.telemetry.log("groq_stream_start", { prompt: prompt.substring(0, 100) });
+        options.onStart?.();
+        try {
+            for await (const chunk of (0, Streaming_1.streaming)(prompt, {
+                model: options.model,
+                generationConfig: { ...options.generationConfig, ...config },
+                callbacks: {
+                    onChunk: (c) => {
+                        fullContent += c;
+                        onChunk(c);
+                    },
+                },
+            })) {
+                // Streamed via callback
+            }
+            setResult(fullContent);
+            options.onSuccess?.(fullContent);
+            telemetry_1.telemetry.log("groq_stream_success", { contentLength: fullContent.length });
+        }
+        catch (err) {
+            const errorMessage = (0, error_mapper_util_1.getUserFriendlyError)(err);
+            setError(errorMessage);
+            options.onError?.(errorMessage);
+            telemetry_1.telemetry.log("groq_stream_error", { error: errorMessage });
+            throw err;
+        }
+        finally {
+            setIsLoading(false);
+            abortControllerRef.current = null;
+        }
+    }, [options]);
+    const reset = (0, react_1.useCallback)(() => {
+        if (abortControllerRef.current) {
+            abortControllerRef.current.abort();
+            abortControllerRef.current = null;
+        }
+        setIsLoading(false);
+        setError(null);
+        setResult(null);
+    }, []);
+    const clearError = (0, react_1.useCallback)(() => {
+        setError(null);
+    }, []);
+    return {
+        isLoading,
+        error,
+        result,
+        generate,
+        generateJSON,
+        stream,
+        reset,
+        clearError,
+    };
+}
+//# sourceMappingURL=useGroq.js.map

package/dist/presentation/hooks/useGroq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGroq.js","sourceRoot":"","sources":["../../../src/presentation/hooks/useGroq.ts"],"names":[],"mappings":"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"}

package/dist/presentation/hooks/useOperationManager.d.ts

@@ -0,0 +1,34 @@
+/**
+ * useOperationManager Hook
+ * Manages async operations with loading, error, and success states
+ */
+export interface OperationState<T> {
+    isLoading: boolean;
+    error: string | null;
+    data: T | null;
+}
+export interface UseOperationManagerOptions<T> {
+    /** Initial data */
+    initialData?: T | null;
+    /** Callback when operation starts */
+    onStart?: () => void;
+    /** Callback when operation succeeds */
+    onSuccess?: (data: T) => void;
+    /** Callback when operation fails */
+    onError?: (error: string) => void;
+}
+/**
+ * Hook for managing async operations
+ */
+export declare function useOperationManager<T = unknown>(options?: UseOperationManagerOptions<T>): {
+    execute: <R = T>(operationName: string, asyncFn: (signal?: AbortSignal) => Promise<R>, config?: {
+        abortPrevious?: boolean;
+    }) => Promise<R>;
+    reset: () => void;
+    clearError: () => void;
+    setData: (data: T | null) => void;
+    isLoading: boolean;
+    error: string | null;
+    data: T;
+};
+//# sourceMappingURL=useOperationManager.d.ts.map

package/dist/presentation/hooks/useOperationManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOperationManager.d.ts","sourceRoot":"","sources":["../../../src/presentation/hooks/useOperationManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAC3C,mBAAmB;IACnB,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACvB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,uCAAuC;IACvC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IAC9B,oCAAoC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAC7C,OAAO,GAAE,0BAA0B,CAAC,CAAC,CAAM;cAYlC,CAAC,qBACS,MAAM,WACZ,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,WACpC;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,KACnC,OAAO,CAAC,CAAC,CAAC;;;oBAoDoB,CAAC,GAAG,IAAI;eAxFhC,OAAO;WACX,MAAM,GAAG,IAAI;;EAkGrB"}

package/dist/presentation/hooks/useOperationManager.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * useOperationManager Hook
+ * Manages async operations with loading, error, and success states
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useOperationManager = useOperationManager;
+const react_1 = require("react");
+const error_mapper_util_1 = require("../../infrastructure/utils/error-mapper.util");
+const telemetry_1 = require("../../infrastructure/telemetry");
+/**
+ * Hook for managing async operations
+ */
+function useOperationManager(options = {}) {
+    const [state, setState] = (0, react_1.useState)({
+        isLoading: false,
+        error: null,
+        data: options.initialData ?? null,
+    });
+    const abortControllerRef = (0, react_1.useRef)(null);
+    const operationNameRef = (0, react_1.useRef)("");
+    const execute = (0, react_1.useCallback)(async (operationName, asyncFn, config) => {
+        // Cancel previous operation if configured
+        if (config?.abortPrevious && abortControllerRef.current) {
+            abortControllerRef.current.abort();
+        }
+        abortControllerRef.current = new AbortController();
+        operationNameRef.current = operationName;
+        setState((prev) => ({ ...prev, isLoading: true, error: null }));
+        telemetry_1.telemetry.log(`${operationName}_start`);
+        options.onStart?.();
+        try {
+            const result = await asyncFn(abortControllerRef.current.signal);
+            setState((prev) => ({ ...prev, isLoading: false, data: result }));
+            options.onSuccess?.(result);
+            telemetry_1.telemetry.log(`${operationName}_success`);
+            return result;
+        }
+        catch (error) {
+            const errorMessage = (0, error_mapper_util_1.getUserFriendlyError)(error);
+            setState((prev) => ({ ...prev, isLoading: false, error: errorMessage }));
+            options.onError?.(errorMessage);
+            telemetry_1.telemetry.log(`${operationName}_error`, { error: errorMessage });
+            throw error;
+        }
+        finally {
+            abortControllerRef.current = null;
+        }
+    }, [options]);
+    const reset = (0, react_1.useCallback)(() => {
+        if (abortControllerRef.current) {
+            abortControllerRef.current.abort();
+            abortControllerRef.current = null;
+        }
+        setState((prev) => ({
+            ...prev,
+            isLoading: false,
+            error: null,
+            data: options.initialData ?? null,
+        }));
+    }, [options.initialData]);
+    const clearError = (0, react_1.useCallback)(() => {
+        setState((prev) => ({ ...prev, error: null }));
+    }, []);
+    const setData = (0, react_1.useCallback)((data) => {
+        setState((prev) => ({ ...prev, data }));
+    }, []);
+    return {
+        ...state,
+        execute,
+        reset,
+        clearError,
+        setData,
+    };
+}
+//# sourceMappingURL=useOperationManager.js.map

package/dist/presentation/hooks/useOperationManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOperationManager.js","sourceRoot":"","sources":["../../../src/presentation/hooks/useOperationManager.ts"],"names":[],"mappings":"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"}

package/dist/providers/ConfigBuilder.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Configuration Builder
+ * Builder pattern for Groq configuration
+ */
+import type { GroqConfig, GroqGenerationConfig } from "../domain/entities";
+/**
+ * Builder for Groq configuration
+ */
+export declare class ConfigBuilder {
+    private config;
+    /**
+     * Set API key
+     */
+    withApiKey(apiKey: string): ConfigBuilder;
+    /**
+     * Set base URL
+     */
+    withBaseUrl(baseUrl: string): ConfigBuilder;
+    /**
+     * Set timeout
+     */
+    withTimeout(timeoutMs: number): ConfigBuilder;
+    /**
+     * Set default text model
+     */
+    withTextModel(model: string): ConfigBuilder;
+    /**
+     * Build configuration
+     */
+    build(): GroqConfig;
+    /**
+     * Create a new builder instance
+     */
+    static create(): ConfigBuilder;
+}
+/**
+ * Builder for generation configuration
+ */
+export declare class GenerationConfigBuilder {
+    private config;
+    /**
+     * Set temperature
+     */
+    withTemperature(temperature: number): GenerationConfigBuilder;
+    /**
+     * Set max tokens
+     */
+    withMaxTokens(maxTokens: number): GenerationConfigBuilder;
+    /**
+     * Set top P
+     */
+    withTopP(topP: number): GenerationConfigBuilder;
+    /**
+     * Set frequency penalty
+     */
+    withFrequencyPenalty(penalty: number): GenerationConfigBuilder;
+    /**
+     * Set presence penalty
+     */
+    withPresencePenalty(penalty: number): GenerationConfigBuilder;
+    /**
+     * Set stop sequences
+     */
+    withStop(stop: string[]): GenerationConfigBuilder;
+    /**
+     * Build configuration
+     */
+    build(): GroqGenerationConfig;
+    /**
+     * Create a new builder instance
+     */
+    static create(): GenerationConfigBuilder;
+    /**
+     * Create a balanced configuration
+     */
+    static balanced(): GenerationConfigBuilder;
+    /**
+     * Create a creative configuration
+     */
+    static creative(): GenerationConfigBuilder;
+    /**
+     * Create a precise configuration
+     */
+    static precise(): GenerationConfigBuilder;
+}
+//# sourceMappingURL=ConfigBuilder.d.ts.map

package/dist/providers/ConfigBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigBuilder.d.ts","sourceRoot":"","sources":["../../src/providers/ConfigBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG3E;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA2B;IAEzC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAKzC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa;IAK3C;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa;IAK7C;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa;IAK3C;;OAEG;IACH,KAAK,IAAI,UAAU;IAanB;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,aAAa;CAG/B;AAED;;GAEG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAA4B;IAE1C;;OAEG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,uBAAuB;IAK7D;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB;IAKzD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB;IAK/C;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB;IAK9D;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB;IAK7D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,uBAAuB;IAKjD;;OAEG;IACH,KAAK,IAAI,oBAAoB;IAI7B;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,uBAAuB;IAIxC;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,uBAAuB;IAI1C;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,uBAAuB;IAI1C;;OAEG;IACH,MAAM,CAAC,OAAO,IAAI,uBAAuB;CAG1C"}