@umituz/web-ai 1.0.1 → 1.0.2

package/dist/hooks/index.d.cts

@@ -2,11 +2,12 @@ import { B as BlogGenerationRequest, G as GeneratedBlog, b as SocialContentReque
 import { A as AIErrorCode, S as SentimentAnalysisResult, C as ContentAnalysisRequest, a as ContentAnalysisResult, b as SEOOptimizationRequest, c as SEOOptimizationResult, d as SEOScoreBreakdown, e as ABTestRequest, f as ABTestPrediction, g as ABTestComparison, G as GenerationResult, h as GenerationProgress, i as GenerationStatus, I as ImageGenerationInput, V as VideoGenerationInput, j as GenerationType, k as ImageQuality, l as VideoQuality } from '../AIErrors-C5EasV_c.cjs';
 import { d as ProviderConfig, I as ImageGenerationRequest, G as GeneratedContent, V as VideoGenerationRequest, a as ImageToVideoRequest, b as VideoToVideoRequest } from '../ProviderConfig-DIFa9nmG.cjs';
 import { f as ITextGenerator, b as ITextProvider, c as ProviderFactory } from '../provider.factory-BxsfK4WW.cjs';
-import { A as AIProviderConfig } from '../create-ai-DOI9jD3v.cjs';
+import { A as AIProviderConfig, q as GroqGenerationConfig } from '../create-ai-CXYKPK6G.cjs';
 import { ContentWizardStep, ContentWizardData, ImageWizardStep, ImageWizardData, VideoWizardStep, VideoWizardData } from '../wizard/index.cjs';
 import { c as TextTier } from '../index-fXjxTR5W.cjs';
 import { C as CacheManager, b as CacheStats } from '../cache-manager-Df9LLYGA.cjs';
 import { d as ChatService, U as UseChatOptions, k as UseChatReturn } from '../chat.service-CL1qtYxe.cjs';
+import { c as TextGenerationService } from '../text-generation.service-BQO3Tvz2.cjs';
 import '../index-DKHNcMbl.cjs';
 
 /** Provider config for the underlying AIContentService — new AIProviderConfig,
@@ -207,4 +208,29 @@ interface UseChatDeps {
 }
 declare function useChat(options: UseChatOptions, deps?: UseChatDeps): UseChatReturn;
 
-export { type ContentWizardRequest, type CreditCheckFunction, type SaveFunction, type UploadFunction, type UseAIContentOptions, type UseAIContentReturn, type UseAIGenerationOptions, type UseAIGenerationReturn, type UseBlogGeneratorOptions, type UseBlogGeneratorReturn, type UseCacheStatsOptions, type UseChatDeps, type UseContentWizardOptions, type UseContentWizardReturn, type UseImageWizardOptions, type UseImageWizardReturn, type UseSocialContentGeneratorOptions, type UseSocialContentGeneratorReturn, type UseTextConfig, type UseTextDeps, type UseTextOptions, type UseTextReturn, type UseVideoWizardOptions, type UseVideoWizardReturn, type VideoWizardRequest, useAIContent, useAIGeneration, useBlogGenerator, useCacheStats, useChat, useContentWizard, useImageWizard, useSocialContentGenerator, useText, useVideoWizard };
+interface UseGroqOptions {
+    readonly model?: string;
+    readonly generationConfig?: GroqGenerationConfig;
+    readonly onStart?: () => void;
+    readonly onSuccess?: (result: string) => void;
+    readonly onError?: (error: string) => void;
+}
+interface UseGroqReturn {
+    readonly isLoading: boolean;
+    readonly error: string | null;
+    readonly result: string | null;
+    generate: (prompt: string, options?: GroqGenerationConfig) => Promise<string | null>;
+    generateJSON: <T = Record<string, unknown>>(prompt: string, options?: GroqGenerationConfig & {
+        schema?: Record<string, unknown>;
+    }) => Promise<T | null>;
+    stream: (prompt: string, onChunk: (chunk: string) => void, options?: GroqGenerationConfig) => Promise<string | null>;
+    cancel: () => void;
+    reset: () => void;
+    clearError: () => void;
+}
+interface UseGroqDeps {
+    readonly textGeneration?: TextGenerationService;
+}
+declare function useGroq(options?: UseGroqOptions, deps?: UseGroqDeps): UseGroqReturn;
+
+export { type ContentWizardRequest, type CreditCheckFunction, type SaveFunction, type UploadFunction, type UseAIContentOptions, type UseAIContentReturn, type UseAIGenerationOptions, type UseAIGenerationReturn, type UseBlogGeneratorOptions, type UseBlogGeneratorReturn, type UseCacheStatsOptions, type UseChatDeps, type UseContentWizardOptions, type UseContentWizardReturn, type UseGroqDeps, type UseGroqOptions, type UseGroqReturn, type UseImageWizardOptions, type UseImageWizardReturn, type UseSocialContentGeneratorOptions, type UseSocialContentGeneratorReturn, type UseTextConfig, type UseTextDeps, type UseTextOptions, type UseTextReturn, type UseVideoWizardOptions, type UseVideoWizardReturn, type VideoWizardRequest, useAIContent, useAIGeneration, useBlogGenerator, useCacheStats, useChat, useContentWizard, useGroq, useImageWizard, useSocialContentGenerator, useText, useVideoWizard };

package/dist/hooks/index.d.ts

@@ -2,11 +2,12 @@ import { B as BlogGenerationRequest, G as GeneratedBlog, b as SocialContentReque
 import { A as AIErrorCode, S as SentimentAnalysisResult, C as ContentAnalysisRequest, a as ContentAnalysisResult, b as SEOOptimizationRequest, c as SEOOptimizationResult, d as SEOScoreBreakdown, e as ABTestRequest, f as ABTestPrediction, g as ABTestComparison, G as GenerationResult, h as GenerationProgress, i as GenerationStatus, I as ImageGenerationInput, V as VideoGenerationInput, j as GenerationType, k as ImageQuality, l as VideoQuality } from '../AIErrors-B2ogd1PB.js';
 import { d as ProviderConfig, I as ImageGenerationRequest, G as GeneratedContent, V as VideoGenerationRequest, a as ImageToVideoRequest, b as VideoToVideoRequest } from '../ProviderConfig-DIFa9nmG.js';
 import { f as ITextGenerator, b as ITextProvider, c as ProviderFactory } from '../provider.factory-DfDfk0dK.js';
-import { A as AIProviderConfig } from '../create-ai-DXEoke8-.js';
+import { A as AIProviderConfig, q as GroqGenerationConfig } from '../create-ai-9PW752z8.js';
 import { ContentWizardStep, ContentWizardData, ImageWizardStep, ImageWizardData, VideoWizardStep, VideoWizardData } from '../wizard/index.js';
 import { c as TextTier } from '../index-fXjxTR5W.js';
 import { C as CacheManager, b as CacheStats } from '../cache-manager-Df9LLYGA.js';
 import { d as ChatService, U as UseChatOptions, k as UseChatReturn } from '../chat.service-q05GnhEm.js';
+import { c as TextGenerationService } from '../text-generation.service-CcYQM6Ch.js';
 import '../index-DIHz8_OJ.js';
 
 /** Provider config for the underlying AIContentService — new AIProviderConfig,
@@ -207,4 +208,29 @@ interface UseChatDeps {
 }
 declare function useChat(options: UseChatOptions, deps?: UseChatDeps): UseChatReturn;
 
-export { type ContentWizardRequest, type CreditCheckFunction, type SaveFunction, type UploadFunction, type UseAIContentOptions, type UseAIContentReturn, type UseAIGenerationOptions, type UseAIGenerationReturn, type UseBlogGeneratorOptions, type UseBlogGeneratorReturn, type UseCacheStatsOptions, type UseChatDeps, type UseContentWizardOptions, type UseContentWizardReturn, type UseImageWizardOptions, type UseImageWizardReturn, type UseSocialContentGeneratorOptions, type UseSocialContentGeneratorReturn, type UseTextConfig, type UseTextDeps, type UseTextOptions, type UseTextReturn, type UseVideoWizardOptions, type UseVideoWizardReturn, type VideoWizardRequest, useAIContent, useAIGeneration, useBlogGenerator, useCacheStats, useChat, useContentWizard, useImageWizard, useSocialContentGenerator, useText, useVideoWizard };
+interface UseGroqOptions {
+    readonly model?: string;
+    readonly generationConfig?: GroqGenerationConfig;
+    readonly onStart?: () => void;
+    readonly onSuccess?: (result: string) => void;
+    readonly onError?: (error: string) => void;
+}
+interface UseGroqReturn {
+    readonly isLoading: boolean;
+    readonly error: string | null;
+    readonly result: string | null;
+    generate: (prompt: string, options?: GroqGenerationConfig) => Promise<string | null>;
+    generateJSON: <T = Record<string, unknown>>(prompt: string, options?: GroqGenerationConfig & {
+        schema?: Record<string, unknown>;
+    }) => Promise<T | null>;
+    stream: (prompt: string, onChunk: (chunk: string) => void, options?: GroqGenerationConfig) => Promise<string | null>;
+    cancel: () => void;
+    reset: () => void;
+    clearError: () => void;
+}
+interface UseGroqDeps {
+    readonly textGeneration?: TextGenerationService;
+}
+declare function useGroq(options?: UseGroqOptions, deps?: UseGroqDeps): UseGroqReturn;
+
+export { type ContentWizardRequest, type CreditCheckFunction, type SaveFunction, type UploadFunction, type UseAIContentOptions, type UseAIContentReturn, type UseAIGenerationOptions, type UseAIGenerationReturn, type UseBlogGeneratorOptions, type UseBlogGeneratorReturn, type UseCacheStatsOptions, type UseChatDeps, type UseContentWizardOptions, type UseContentWizardReturn, type UseGroqDeps, type UseGroqOptions, type UseGroqReturn, type UseImageWizardOptions, type UseImageWizardReturn, type UseSocialContentGeneratorOptions, type UseSocialContentGeneratorReturn, type UseTextConfig, type UseTextDeps, type UseTextOptions, type UseTextReturn, type UseVideoWizardOptions, type UseVideoWizardReturn, type VideoWizardRequest, useAIContent, useAIGeneration, useBlogGenerator, useCacheStats, useChat, useContentWizard, useGroq, useImageWizard, useSocialContentGenerator, useText, useVideoWizard };

package/dist/hooks/index.js

@@ -115,6 +115,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 */,
@@ -1339,6 +1347,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",
@@ -1355,11 +1384,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",
@@ -1418,13 +1449,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();
@@ -1439,7 +1522,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();
@@ -1466,11 +1549,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);
@@ -1493,7 +1576,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) {
@@ -1595,21 +1678,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();
   }
@@ -1622,6 +1724,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;
@@ -5230,6 +5336,161 @@ function useChat(options, deps) {
   };
 }
 
-export { useAIContent, useAIGeneration, useBlogGenerator, useCacheStats, useChat, useContentWizard, useImageWizard, useSocialContentGenerator, useText, useVideoWizard };
+// 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] = useState(false);
+  const [error, setError] = useState(null);
+  const [result, setResult] = useState(null);
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+  const abortControllerRef = useRef(null);
+  const getOrCreateAbortController = useCallback(() => {
+    if (!abortControllerRef.current || abortControllerRef.current.signal.aborted) {
+      abortControllerRef.current = new AbortController();
+    }
+    return abortControllerRef.current;
+  }, []);
+  const stableConfig = useMemo(
+    () => ({
+      model: options.model,
+      generationConfig: options.generationConfig
+    }),
+    [
+      options.model,
+      options.generationConfig?.temperature,
+      options.generationConfig?.maxTokens,
+      options.generationConfig?.topP
+    ]
+  );
+  useEffect(() => {
+    abortControllerRef.current = new AbortController();
+    return () => {
+      abortControllerRef.current?.abort();
+      abortControllerRef.current = null;
+    };
+  }, []);
+  const runWithState = 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 = 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 = 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 = 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 = useCallback(() => {
+    if (abortControllerRef.current) {
+      abortControllerRef.current.abort();
+      abortControllerRef.current = new AbortController();
+    }
+    setIsLoading(false);
+  }, []);
+  const reset = useCallback(() => {
+    cancel();
+    setError(null);
+    setResult(null);
+  }, [cancel]);
+  const clearError = useCallback(() => setError(null), []);
+  return {
+    isLoading,
+    error,
+    result,
+    generate,
+    generateJSON,
+    stream,
+    cancel,
+    reset,
+    clearError
+  };
+}
+
+export { useAIContent, useAIGeneration, useBlogGenerator, useCacheStats, useChat, useContentWizard, useGroq, useImageWizard, useSocialContentGenerator, useText, useVideoWizard };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map