@umituz/web-ai 0.0.0-stage → 1.0.1

package/dist/hooks/index.d.cts

@@ -0,0 +1,210 @@
+import { B as BlogGenerationRequest, G as GeneratedBlog, b as SocialContentRequest, c as GeneratedSocialContent, a as ContentTone, V as VideoScriptRequest, d as GeneratedVideoScript, e as ContentCalendarEntry, E as Emotion } from '../ContentGeneration-B6iK2B33.cjs';
+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 { 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 '../index-DKHNcMbl.cjs';
+
+/** Provider config for the underlying AIContentService — new AIProviderConfig,
+ *  legacy ProviderConfig, or a custom ITextGenerator. */
+type ContentServiceConfig = AIProviderConfig | ProviderConfig | ITextGenerator;
+
+interface UseAIContentOptions {
+    /** Provider config (AIProviderConfig or legacy ProviderConfig) or a custom ITextGenerator. */
+    config?: ContentServiceConfig;
+    onError?: (error: Error) => void;
+    onProgress?: (progress: number) => void;
+}
+interface UseAIContentReturn {
+    isLoading: boolean;
+    progress: number;
+    error: string | null;
+    errorCode: AIErrorCode | null;
+    generateBlogPost: (request: BlogGenerationRequest) => Promise<GeneratedBlog | null>;
+    generateSocialContent: (request: SocialContentRequest) => Promise<GeneratedSocialContent | null>;
+    generateForAllPlatforms: (topic: string, tone: ContentTone) => Promise<GeneratedSocialContent[]>;
+    generateVideoScript: (request: VideoScriptRequest) => Promise<GeneratedVideoScript | null>;
+    generateContentCalendar: (niche: string, days: number) => Promise<ContentCalendarEntry[]>;
+    analyzeSentiment: (content: string) => Promise<SentimentAnalysisResult | null>;
+    analyzeContent: (request: ContentAnalysisRequest) => Promise<ContentAnalysisResult | null>;
+    optimizeSEO: (request: SEOOptimizationRequest) => Promise<SEOOptimizationResult | null>;
+    calculateSEOScore: (content: string, keywords: string[]) => Promise<SEOScoreBreakdown | null>;
+    predictABTest: (request: ABTestRequest) => Promise<ABTestPrediction[]>;
+    compareVariants: (variantA: string, variantB: string) => Promise<ABTestComparison | null>;
+    generateHashtags: (content: string, count: number) => Promise<string[]>;
+    generateImagePrompt: (description: string, style: string) => Promise<string | null>;
+    generateVoiceScript: (topic: string, emotion: Emotion, duration: number) => Promise<GeneratedVideoScript | null>;
+    generateImage: (request: ImageGenerationRequest) => Promise<GeneratedContent | null>;
+    generateVideo: (request: VideoGenerationRequest) => Promise<GeneratedContent | null>;
+    convertImageToVideo: (request: ImageToVideoRequest) => Promise<GeneratedContent | null>;
+    transformVideo: (request: VideoToVideoRequest) => Promise<GeneratedContent | null>;
+}
+declare function useAIContent(options: UseAIContentOptions): UseAIContentReturn;
+
+type UploadFunction = (file: File, userId: string) => Promise<string>;
+type SaveFunction = (result: Omit<GenerationResult, 'id' | 'createdAt'>) => Promise<void>;
+type CreditCheckFunction = (cost: number) => boolean;
+interface UseAIGenerationOptions {
+    userId?: string;
+    apiKey: string;
+    uploadPhoto?: UploadFunction;
+    saveResult?: SaveFunction;
+    checkCredits?: CreditCheckFunction;
+    onSuccess?: (result: GenerationResult) => void;
+    onError?: (error: Error) => void;
+    onProgress?: (progress: GenerationProgress) => void;
+}
+interface UseAIGenerationReturn {
+    status: GenerationStatus;
+    result: GenerationResult | null;
+    error: Error | null;
+    progress: GenerationProgress | null;
+    generateImage: (input: ImageGenerationInput) => Promise<GenerationResult | null>;
+    generateVideo: (input: VideoGenerationInput) => Promise<GenerationResult | null>;
+    generateFromFiles: (files: File[], type: GenerationType, prompt: string, quality?: ImageQuality | VideoQuality) => Promise<GenerationResult | null>;
+    saveResult?: SaveFunction;
+    cancel: () => void;
+    reset: () => void;
+}
+declare function useAIGeneration(options: UseAIGenerationOptions): UseAIGenerationReturn;
+
+interface UseBlogGeneratorOptions {
+    config: ContentServiceConfig;
+}
+interface UseBlogGeneratorReturn {
+    isGenerating: boolean;
+    generatedBlog: GeneratedBlog | null;
+    error: string | null;
+    generateBlog: (request: BlogGenerationRequest) => Promise<void>;
+    reset: () => void;
+}
+declare function useBlogGenerator(options: UseBlogGeneratorOptions): UseBlogGeneratorReturn;
+
+interface UseSocialContentGeneratorOptions {
+    config: ContentServiceConfig;
+}
+interface UseSocialContentGeneratorReturn {
+    isGenerating: boolean;
+    generatedContents: GeneratedSocialContent[];
+    error: string | null;
+    generateForPlatform: (request: SocialContentRequest) => Promise<void>;
+    generateForAllPlatforms: (topic: string, tone: ContentTone) => Promise<void>;
+    reset: () => void;
+}
+declare function useSocialContentGenerator(options: UseSocialContentGeneratorOptions): UseSocialContentGeneratorReturn;
+
+interface WizardStepDefinition<T extends string> {
+    id: T;
+    label: string;
+    icon?: string;
+    description?: string;
+    optional?: boolean;
+}
+interface UseWizardFlowReturn<T extends string, D> {
+    currentStep: T;
+    steps: ReadonlyArray<WizardStepDefinition<T>>;
+    wizardData: D;
+    isProcessing: boolean;
+    progress: number;
+    next: () => void;
+    back: () => void;
+    skip: () => void;
+    goTo: (step: T) => void;
+    updateData: (updates: Partial<D>) => void;
+    setData: (data: D) => void;
+    setIsProcessing: (processing: boolean) => void;
+    canGoNext: () => boolean;
+    canGoBack: () => boolean;
+    canSkip: () => boolean;
+    isComplete: () => boolean;
+    reset: () => void;
+}
+
+interface UseContentWizardOptions {
+    initialStep?: ContentWizardStep;
+    onStepChange?: (from: ContentWizardStep, to: ContentWizardStep) => void;
+    onComplete?: (data: ContentWizardData) => void;
+}
+type ContentWizardRequest = BlogGenerationRequest | SocialContentRequest | VideoScriptRequest;
+interface UseContentWizardReturn extends Omit<UseWizardFlowReturn<ContentWizardStep, ContentWizardData>, 'buildRequest'> {
+    buildRequest: () => ContentWizardRequest;
+}
+declare function useContentWizard(options?: UseContentWizardOptions): UseContentWizardReturn;
+
+interface UseImageWizardOptions {
+    initialStep?: ImageWizardStep;
+    onStepChange?: (from: ImageWizardStep, to: ImageWizardStep) => void;
+    onComplete?: (data: ImageWizardData) => void;
+}
+interface UseImageWizardReturn extends Omit<UseWizardFlowReturn<ImageWizardStep, ImageWizardData>, 'buildRequest'> {
+    buildRequest: () => ImageGenerationRequest;
+}
+declare function useImageWizard(options?: UseImageWizardOptions): UseImageWizardReturn;
+
+interface UseVideoWizardOptions {
+    initialStep?: VideoWizardStep;
+    onStepChange?: (from: VideoWizardStep, to: VideoWizardStep) => void;
+    onComplete?: (data: VideoWizardData) => void;
+}
+type VideoWizardRequest = VideoGenerationRequest | ImageToVideoRequest | VideoToVideoRequest;
+interface UseVideoWizardReturn extends Omit<UseWizardFlowReturn<VideoWizardStep, VideoWizardData>, 'buildRequest'> {
+    buildRequest: () => VideoWizardRequest;
+}
+declare function useVideoWizard(options?: UseVideoWizardOptions): UseVideoWizardReturn;
+
+/** Sampling/sizing knobs the hook forwards on every call. */
+interface UseTextConfig {
+    readonly model?: string;
+    readonly tier?: TextTier;
+    readonly maxTokens?: number;
+    readonly temperature?: number;
+    readonly topP?: number;
+}
+interface UseTextOptions {
+    readonly model?: string;
+    readonly tier?: TextTier;
+    readonly config?: UseTextConfig;
+    readonly onStart?: () => void;
+    readonly onSuccess?: (result: string) => void;
+    readonly onError?: (error: string) => void;
+}
+interface UseTextReturn {
+    readonly isLoading: boolean;
+    readonly error: string | null;
+    readonly result: string | null;
+    generate: (prompt: string, config?: UseTextConfig) => Promise<string | null>;
+    generateJSON: <T = Record<string, unknown>>(prompt: string, config?: UseTextConfig & {
+        schema?: Record<string, unknown>;
+    }) => Promise<T | null>;
+    stream: (prompt: string, onChunk: (chunk: string) => void, config?: UseTextConfig) => Promise<string | null>;
+    cancel: () => void;
+    reset: () => void;
+    clearError: () => void;
+}
+interface UseTextDeps {
+    /** A single provider or a whole factory (tier defaults + fallback). */
+    readonly engine: ITextProvider | ProviderFactory;
+}
+/**
+ * Single-prompt text hook over the neutral surface — successor of useGroq,
+ * provider-agnostic: pass any ITextProvider or a createAI() factory.
+ */
+declare function useText(options: UseTextOptions | undefined, deps: UseTextDeps): UseTextReturn;
+
+interface UseCacheStatsOptions {
+    readonly pollIntervalMs?: number;
+    readonly enabled?: boolean;
+}
+/** Polls a CacheManager's stats (hit rate, size, age) for dashboards. */
+declare function useCacheStats(cache: CacheManager, options?: UseCacheStatsOptions): CacheStats;
+
+interface UseChatDeps {
+    readonly chatService: ChatService;
+}
+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 };

package/dist/hooks/index.d.ts

@@ -0,0 +1,210 @@
+import { B as BlogGenerationRequest, G as GeneratedBlog, b as SocialContentRequest, c as GeneratedSocialContent, a as ContentTone, V as VideoScriptRequest, d as GeneratedVideoScript, e as ContentCalendarEntry, E as Emotion } from '../ContentGeneration-B6iK2B33.js';
+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 { 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 '../index-DIHz8_OJ.js';
+
+/** Provider config for the underlying AIContentService — new AIProviderConfig,
+ *  legacy ProviderConfig, or a custom ITextGenerator. */
+type ContentServiceConfig = AIProviderConfig | ProviderConfig | ITextGenerator;
+
+interface UseAIContentOptions {
+    /** Provider config (AIProviderConfig or legacy ProviderConfig) or a custom ITextGenerator. */
+    config?: ContentServiceConfig;
+    onError?: (error: Error) => void;
+    onProgress?: (progress: number) => void;
+}
+interface UseAIContentReturn {
+    isLoading: boolean;
+    progress: number;
+    error: string | null;
+    errorCode: AIErrorCode | null;
+    generateBlogPost: (request: BlogGenerationRequest) => Promise<GeneratedBlog | null>;
+    generateSocialContent: (request: SocialContentRequest) => Promise<GeneratedSocialContent | null>;
+    generateForAllPlatforms: (topic: string, tone: ContentTone) => Promise<GeneratedSocialContent[]>;
+    generateVideoScript: (request: VideoScriptRequest) => Promise<GeneratedVideoScript | null>;
+    generateContentCalendar: (niche: string, days: number) => Promise<ContentCalendarEntry[]>;
+    analyzeSentiment: (content: string) => Promise<SentimentAnalysisResult | null>;
+    analyzeContent: (request: ContentAnalysisRequest) => Promise<ContentAnalysisResult | null>;
+    optimizeSEO: (request: SEOOptimizationRequest) => Promise<SEOOptimizationResult | null>;
+    calculateSEOScore: (content: string, keywords: string[]) => Promise<SEOScoreBreakdown | null>;
+    predictABTest: (request: ABTestRequest) => Promise<ABTestPrediction[]>;
+    compareVariants: (variantA: string, variantB: string) => Promise<ABTestComparison | null>;
+    generateHashtags: (content: string, count: number) => Promise<string[]>;
+    generateImagePrompt: (description: string, style: string) => Promise<string | null>;
+    generateVoiceScript: (topic: string, emotion: Emotion, duration: number) => Promise<GeneratedVideoScript | null>;
+    generateImage: (request: ImageGenerationRequest) => Promise<GeneratedContent | null>;
+    generateVideo: (request: VideoGenerationRequest) => Promise<GeneratedContent | null>;
+    convertImageToVideo: (request: ImageToVideoRequest) => Promise<GeneratedContent | null>;
+    transformVideo: (request: VideoToVideoRequest) => Promise<GeneratedContent | null>;
+}
+declare function useAIContent(options: UseAIContentOptions): UseAIContentReturn;
+
+type UploadFunction = (file: File, userId: string) => Promise<string>;
+type SaveFunction = (result: Omit<GenerationResult, 'id' | 'createdAt'>) => Promise<void>;
+type CreditCheckFunction = (cost: number) => boolean;
+interface UseAIGenerationOptions {
+    userId?: string;
+    apiKey: string;
+    uploadPhoto?: UploadFunction;
+    saveResult?: SaveFunction;
+    checkCredits?: CreditCheckFunction;
+    onSuccess?: (result: GenerationResult) => void;
+    onError?: (error: Error) => void;
+    onProgress?: (progress: GenerationProgress) => void;
+}
+interface UseAIGenerationReturn {
+    status: GenerationStatus;
+    result: GenerationResult | null;
+    error: Error | null;
+    progress: GenerationProgress | null;
+    generateImage: (input: ImageGenerationInput) => Promise<GenerationResult | null>;
+    generateVideo: (input: VideoGenerationInput) => Promise<GenerationResult | null>;
+    generateFromFiles: (files: File[], type: GenerationType, prompt: string, quality?: ImageQuality | VideoQuality) => Promise<GenerationResult | null>;
+    saveResult?: SaveFunction;
+    cancel: () => void;
+    reset: () => void;
+}
+declare function useAIGeneration(options: UseAIGenerationOptions): UseAIGenerationReturn;
+
+interface UseBlogGeneratorOptions {
+    config: ContentServiceConfig;
+}
+interface UseBlogGeneratorReturn {
+    isGenerating: boolean;
+    generatedBlog: GeneratedBlog | null;
+    error: string | null;
+    generateBlog: (request: BlogGenerationRequest) => Promise<void>;
+    reset: () => void;
+}
+declare function useBlogGenerator(options: UseBlogGeneratorOptions): UseBlogGeneratorReturn;
+
+interface UseSocialContentGeneratorOptions {
+    config: ContentServiceConfig;
+}
+interface UseSocialContentGeneratorReturn {
+    isGenerating: boolean;
+    generatedContents: GeneratedSocialContent[];
+    error: string | null;
+    generateForPlatform: (request: SocialContentRequest) => Promise<void>;
+    generateForAllPlatforms: (topic: string, tone: ContentTone) => Promise<void>;
+    reset: () => void;
+}
+declare function useSocialContentGenerator(options: UseSocialContentGeneratorOptions): UseSocialContentGeneratorReturn;
+
+interface WizardStepDefinition<T extends string> {
+    id: T;
+    label: string;
+    icon?: string;
+    description?: string;
+    optional?: boolean;
+}
+interface UseWizardFlowReturn<T extends string, D> {
+    currentStep: T;
+    steps: ReadonlyArray<WizardStepDefinition<T>>;
+    wizardData: D;
+    isProcessing: boolean;
+    progress: number;
+    next: () => void;
+    back: () => void;
+    skip: () => void;
+    goTo: (step: T) => void;
+    updateData: (updates: Partial<D>) => void;
+    setData: (data: D) => void;
+    setIsProcessing: (processing: boolean) => void;
+    canGoNext: () => boolean;
+    canGoBack: () => boolean;
+    canSkip: () => boolean;
+    isComplete: () => boolean;
+    reset: () => void;
+}
+
+interface UseContentWizardOptions {
+    initialStep?: ContentWizardStep;
+    onStepChange?: (from: ContentWizardStep, to: ContentWizardStep) => void;
+    onComplete?: (data: ContentWizardData) => void;
+}
+type ContentWizardRequest = BlogGenerationRequest | SocialContentRequest | VideoScriptRequest;
+interface UseContentWizardReturn extends Omit<UseWizardFlowReturn<ContentWizardStep, ContentWizardData>, 'buildRequest'> {
+    buildRequest: () => ContentWizardRequest;
+}
+declare function useContentWizard(options?: UseContentWizardOptions): UseContentWizardReturn;
+
+interface UseImageWizardOptions {
+    initialStep?: ImageWizardStep;
+    onStepChange?: (from: ImageWizardStep, to: ImageWizardStep) => void;
+    onComplete?: (data: ImageWizardData) => void;
+}
+interface UseImageWizardReturn extends Omit<UseWizardFlowReturn<ImageWizardStep, ImageWizardData>, 'buildRequest'> {
+    buildRequest: () => ImageGenerationRequest;
+}
+declare function useImageWizard(options?: UseImageWizardOptions): UseImageWizardReturn;
+
+interface UseVideoWizardOptions {
+    initialStep?: VideoWizardStep;
+    onStepChange?: (from: VideoWizardStep, to: VideoWizardStep) => void;
+    onComplete?: (data: VideoWizardData) => void;
+}
+type VideoWizardRequest = VideoGenerationRequest | ImageToVideoRequest | VideoToVideoRequest;
+interface UseVideoWizardReturn extends Omit<UseWizardFlowReturn<VideoWizardStep, VideoWizardData>, 'buildRequest'> {
+    buildRequest: () => VideoWizardRequest;
+}
+declare function useVideoWizard(options?: UseVideoWizardOptions): UseVideoWizardReturn;
+
+/** Sampling/sizing knobs the hook forwards on every call. */
+interface UseTextConfig {
+    readonly model?: string;
+    readonly tier?: TextTier;
+    readonly maxTokens?: number;
+    readonly temperature?: number;
+    readonly topP?: number;
+}
+interface UseTextOptions {
+    readonly model?: string;
+    readonly tier?: TextTier;
+    readonly config?: UseTextConfig;
+    readonly onStart?: () => void;
+    readonly onSuccess?: (result: string) => void;
+    readonly onError?: (error: string) => void;
+}
+interface UseTextReturn {
+    readonly isLoading: boolean;
+    readonly error: string | null;
+    readonly result: string | null;
+    generate: (prompt: string, config?: UseTextConfig) => Promise<string | null>;
+    generateJSON: <T = Record<string, unknown>>(prompt: string, config?: UseTextConfig & {
+        schema?: Record<string, unknown>;
+    }) => Promise<T | null>;
+    stream: (prompt: string, onChunk: (chunk: string) => void, config?: UseTextConfig) => Promise<string | null>;
+    cancel: () => void;
+    reset: () => void;
+    clearError: () => void;
+}
+interface UseTextDeps {
+    /** A single provider or a whole factory (tier defaults + fallback). */
+    readonly engine: ITextProvider | ProviderFactory;
+}
+/**
+ * Single-prompt text hook over the neutral surface — successor of useGroq,
+ * provider-agnostic: pass any ITextProvider or a createAI() factory.
+ */
+declare function useText(options: UseTextOptions | undefined, deps: UseTextDeps): UseTextReturn;
+
+interface UseCacheStatsOptions {
+    readonly pollIntervalMs?: number;
+    readonly enabled?: boolean;
+}
+/** Polls a CacheManager's stats (hit rate, size, age) for dashboards. */
+declare function useCacheStats(cache: CacheManager, options?: UseCacheStatsOptions): CacheStats;
+
+interface UseChatDeps {
+    readonly chatService: ChatService;
+}
+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 };