@umituz/web-ai 1.0.1 → 1.0.2

package/dist/hooks/index.cjs

@@ -117,6 +117,14 @@ var AIError = class _AIError extends Error {
   }
 };
 
+// src/core/errors/groq-error.ts
+var GroqError = class extends AIError {
+  constructor(type, message, cause, metadata = {}) {
+    super(type, message, cause, metadata);
+    this.name = "GroqError";
+  }
+};
+
 // src/core/errors/error-classifier.ts
 var DEFAULT_RETRYABLE_TYPES = /* @__PURE__ */ new Set([
   "NETWORK_ERROR" /* NETWORK_ERROR */,
@@ -1341,6 +1349,27 @@ var RequestDeduplicator = class {
   }
 };
 
+// src/core/utils/api-key-validator.ts
+var DEFAULT_API_KEY_RULE = {
+  minLength: 10
+};
+function validateApiKey(apiKey, rule = DEFAULT_API_KEY_RULE) {
+  if (!apiKey) {
+    return { valid: false, reason: "API key is required" };
+  }
+  const trimmed = apiKey.trim();
+  if (trimmed.length === 0) {
+    return { valid: false, reason: "API key cannot be empty" };
+  }
+  if (trimmed.length < rule.minLength) {
+    return {
+      valid: false,
+      reason: `API key must be at least ${rule.minLength} characters`
+    };
+  }
+  return { valid: true };
+}
+
 // src/providers/groq/groq.constants.ts
 var GROQ_MODELS = {
   LLAMA_3_1_8B_INSTANT: "llama-3.1-8b-instant",
@@ -1357,11 +1386,13 @@ var DEFAULT_GENERATION_CONFIG = {
   topP: 1
 };
 var GROQ_BASE_URL = "https://api.groq.com/openai/v1";
+var DEFAULT_BASE_URL = GROQ_BASE_URL;
 var CHAT_COMPLETIONS_PATH = "/chat/completions";
 var GROQ_TIMEOUTS = {
   DEFAULT: 3e4,
   STREAMING: 6e4
 };
+var TIMEOUTS = GROQ_TIMEOUTS;
 var HTTP_HEADERS = {
   CONTENT_TYPE: "Content-Type",
   APPLICATION_JSON: "application/json",
@@ -1420,13 +1451,65 @@ var GroqChatRequestBuilder = class _GroqChatRequestBuilder {
   }
 };
 
+// src/providers/groq/groq-config-store.ts
+var GroqConfigStore = class {
+  config = null;
+  initialize(config) {
+    const validation = validateApiKey(config.apiKey, { minLength: 1 });
+    if (!validation.valid) {
+      throw new GroqError("INVALID_API_KEY" /* INVALID_API_KEY */, validation.reason ?? "Invalid API key");
+    }
+    const normalized = {
+      apiKey: config.apiKey.trim(),
+      baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,
+      timeoutMs: config.timeoutMs ?? TIMEOUTS.DEFAULT,
+      ...config.models !== void 0 ? { models: config.models } : {},
+      ...config.textModel !== void 0 ? { textModel: config.textModel } : {}
+    };
+    this.config = normalized;
+    return normalized;
+  }
+  get() {
+    if (!this.config) {
+      throw new GroqError(
+        "MISSING_CONFIG" /* MISSING_CONFIG */,
+        "Client not initialized. Call configureProvider first."
+      );
+    }
+    return this.config;
+  }
+  getOrNull() {
+    return this.config;
+  }
+  isInitialized() {
+    return this.config !== null;
+  }
+  setApiKey(apiKey) {
+    const current = this.get();
+    const validation = validateApiKey(apiKey, { minLength: 1 });
+    if (!validation.valid) {
+      throw new GroqError("INVALID_API_KEY" /* INVALID_API_KEY */, validation.reason ?? "Invalid API key");
+    }
+    this.config = { ...current, apiKey: apiKey.trim() };
+  }
+  reset() {
+    this.config = null;
+  }
+};
+
 // src/providers/groq/groq-http-transport.ts
 var GroqHttpTransport = class {
-  constructor(config) {
-    this.config = config;
+  constructor(configSource) {
+    this.configSource = configSource;
   }
-  config;
+  configSource;
   pendingAbortControllers = /* @__PURE__ */ new Set();
+  getConfig() {
+    if ("get" in this.configSource && typeof this.configSource.get === "function") {
+      return this.configSource.get();
+    }
+    return this.configSource;
+  }
   cancelPendingRequests() {
     for (const controller of this.pendingAbortControllers) {
       controller.abort();
@@ -1441,7 +1524,7 @@ var GroqHttpTransport = class {
   }
   async streamChatCompletion(request, options = {}) {
     const url = `${this.baseUrl()}${CHAT_COMPLETIONS_PATH}`;
-    const timeout = this.config.timeoutMs ?? GROQ_TIMEOUTS.STREAMING;
+    const timeout = this.getConfig().timeoutMs ?? GROQ_TIMEOUTS.STREAMING;
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), timeout);
     const onExternalAbort = () => controller.abort();
@@ -1468,11 +1551,11 @@ var GroqHttpTransport = class {
     }
   }
   baseUrl() {
-    return this.config.baseUrl ?? GROQ_BASE_URL;
+    return this.getConfig().baseUrl ?? GROQ_BASE_URL;
   }
   async request(endpoint, body) {
     const url = `${this.baseUrl()}${endpoint}`;
-    const timeout = this.config.timeoutMs ?? GROQ_TIMEOUTS.DEFAULT;
+    const timeout = this.getConfig().timeoutMs ?? GROQ_TIMEOUTS.DEFAULT;
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), timeout);
     this.pendingAbortControllers.add(controller);
@@ -1495,7 +1578,7 @@ var GroqHttpTransport = class {
   buildHeaders() {
     return {
       [HTTP_HEADERS.CONTENT_TYPE]: HTTP_HEADERS.APPLICATION_JSON,
-      [HTTP_HEADERS.AUTHORIZATION]: `${HTTP_HEADERS.BEARER_PREFIX}${this.config.apiKey}`
+      [HTTP_HEADERS.AUTHORIZATION]: `${HTTP_HEADERS.BEARER_PREFIX}${this.getConfig().apiKey}`
     };
   }
   async throwFromErrorResponse(response) {
@@ -1597,21 +1680,40 @@ var CompositeExecutor = class {
 
 // src/providers/groq/groq-http-client.ts
 var GroqHttpClient = class {
+  configStore;
   transport;
   executor;
-  constructor(config, deps = {}) {
-    this.transport = deps.transport ?? new GroqHttpTransport(config);
+  constructor(configOrDeps, maybeDeps = {}) {
+    const isConfig = typeof configOrDeps === "object" && configOrDeps !== null && "apiKey" in configOrDeps && typeof configOrDeps.apiKey === "string";
+    const deps = isConfig ? maybeDeps : configOrDeps ?? {};
+    this.configStore = deps.configStore ?? new GroqConfigStore();
+    if (isConfig) {
+      this.configStore.initialize(configOrDeps);
+    }
+    this.transport = deps.transport ?? new GroqHttpTransport(this.configStore);
     const retryManager2 = deps.retryManager ?? new RetryManager();
     const queue = deps.queue ?? new RequestQueue();
     const deduplicator = deps.deduplicator ?? new RequestDeduplicator();
     this.executor = new CompositeExecutor([
       new DedupeExecutor(deduplicator, {
-        generateKey: (request) => deduplicatorKey(request, config.apiKey)
+        generateKey: (request) => deduplicatorKey(request, this.configStore.isInitialized() ? this.configStore.get().apiKey : "")
       }),
       new RetryExecutor(retryManager2),
       new QueueExecutor(queue, QUEUE_PRIORITY_USER_REQUEST)
     ]);
   }
+  initialize(config) {
+    this.configStore.initialize(config);
+  }
+  isInitialized() {
+    return this.configStore.isInitialized();
+  }
+  getApiKey() {
+    return this.configStore.get().apiKey;
+  }
+  setApiKey(apiKey) {
+    this.configStore.setApiKey(apiKey);
+  }
   cancelPendingRequests() {
     this.transport.cancelPendingRequests();
   }
@@ -1624,6 +1726,10 @@ var GroqHttpClient = class {
   streamChatCompletion(request, options) {
     return this.transport.streamChatCompletion(request, options);
   }
+  reset() {
+    this.transport.cancelPendingRequests();
+    this.configStore.reset();
+  }
 };
 function deduplicatorKey(request, apiKey) {
   const { model, messages, stream: _stream, ...rest } = request;
@@ -5232,12 +5338,168 @@ function useChat(options, deps) {
   };
 }
 
+// src/providers/groq/groq-container.ts
+var container = null;
+function getProvider() {
+  return container;
+}
+
+// src/hooks/use-groq.hook.ts
+function useGroq(options = {}, deps) {
+  const textGeneration = deps?.textGeneration ?? getProvider()?.textGeneration;
+  if (!textGeneration) {
+    throw new Error(
+      "useGroq requires a TextGenerationService dependency. Provide it via the second argument or wire it through configureProvider()."
+    );
+  }
+  const [isLoading, setIsLoading] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const [result, setResult] = react.useState(null);
+  const optionsRef = react.useRef(options);
+  optionsRef.current = options;
+  const abortControllerRef = react.useRef(null);
+  const getOrCreateAbortController = react.useCallback(() => {
+    if (!abortControllerRef.current || abortControllerRef.current.signal.aborted) {
+      abortControllerRef.current = new AbortController();
+    }
+    return abortControllerRef.current;
+  }, []);
+  const stableConfig = react.useMemo(
+    () => ({
+      model: options.model,
+      generationConfig: options.generationConfig
+    }),
+    [
+      options.model,
+      options.generationConfig?.temperature,
+      options.generationConfig?.maxTokens,
+      options.generationConfig?.topP
+    ]
+  );
+  react.useEffect(() => {
+    abortControllerRef.current = new AbortController();
+    return () => {
+      abortControllerRef.current?.abort();
+      abortControllerRef.current = null;
+    };
+  }, []);
+  const runWithState = react.useCallback(
+    async (task) => {
+      const controller = getOrCreateAbortController();
+      const { signal } = controller;
+      if (signal.aborted) return null;
+      setIsLoading(true);
+      setError(null);
+      setResult(null);
+      const currentOptions = optionsRef.current;
+      currentOptions.onStart?.();
+      try {
+        const value = await task(signal);
+        return value;
+      } catch (err) {
+        if (signal.aborted) {
+          return null;
+        }
+        const message = resolveUserFriendlyMessage(err);
+        setError(message);
+        currentOptions.onError?.(message);
+        throw err;
+      } finally {
+        if (!signal.aborted) {
+          setIsLoading(false);
+        }
+      }
+    },
+    [getOrCreateAbortController]
+  );
+  const generate = react.useCallback(
+    (prompt, config) => runWithState(async () => {
+      const response = await textGeneration.generateCompletion(prompt, {
+        model: stableConfig.model,
+        generationConfig: {
+          ...stableConfig.generationConfig,
+          ...config
+        }
+      });
+      setResult(response);
+      optionsRef.current.onSuccess?.(response);
+      return response;
+    }),
+    [runWithState, textGeneration, stableConfig]
+  );
+  const generateJSON = react.useCallback(
+    (prompt, config) => runWithState(async () => {
+      const response = await textGeneration.generateStructured(prompt, {
+        model: stableConfig.model,
+        generationConfig: {
+          ...stableConfig.generationConfig,
+          ...config
+        },
+        ...config?.schema !== void 0 ? { schema: config.schema } : {}
+      });
+      const json = JSON.stringify(response, null, 2);
+      setResult(json);
+      optionsRef.current.onSuccess?.(json);
+      return response;
+    }),
+    [runWithState, textGeneration, stableConfig]
+  );
+  const stream = react.useCallback(
+    (prompt, onChunk, config) => runWithState(async () => {
+      const callbacks = {
+        onChunk,
+        onComplete: (text) => {
+          setResult(text);
+          optionsRef.current.onSuccess?.(text);
+        }
+      };
+      return textGeneration.streamCompletion(
+        prompt,
+        callbacks,
+        {
+          model: stableConfig.model,
+          generationConfig: {
+            ...stableConfig.generationConfig,
+            ...config
+          }
+        }
+      );
+    }),
+    [runWithState, textGeneration, stableConfig]
+  );
+  const cancel = react.useCallback(() => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+      abortControllerRef.current = new AbortController();
+    }
+    setIsLoading(false);
+  }, []);
+  const reset = react.useCallback(() => {
+    cancel();
+    setError(null);
+    setResult(null);
+  }, [cancel]);
+  const clearError = react.useCallback(() => setError(null), []);
+  return {
+    isLoading,
+    error,
+    result,
+    generate,
+    generateJSON,
+    stream,
+    cancel,
+    reset,
+    clearError
+  };
+}
+
 exports.useAIContent = useAIContent;
 exports.useAIGeneration = useAIGeneration;
 exports.useBlogGenerator = useBlogGenerator;
 exports.useCacheStats = useCacheStats;
 exports.useChat = useChat;
 exports.useContentWizard = useContentWizard;
+exports.useGroq = useGroq;
 exports.useImageWizard = useImageWizard;
 exports.useSocialContentGenerator = useSocialContentGenerator;
 exports.useText = useText;