@umituz/web-ai 0.0.0-stage → 1.0.1

package/dist/provider.factory-BxsfK4WW.d.cts

@@ -0,0 +1,110 @@
+import { P as ProviderHealth, T as TextRequest, G as GenerationResult, b as StructuredTextRequest, a as StructuredGeneration, S as StreamCallbacks, c as TextTier } from './index-fXjxTR5W.cjs';
+import { T as TextGenerationRequest, I as ImageGenerationRequest, V as VideoGenerationRequest, G as GeneratedContent, a as ImageToVideoRequest, b as VideoToVideoRequest } from './ProviderConfig-DIFa9nmG.cjs';
+
+/**
+ * What a provider can serve. Replaces the old single `'multimodal'` type flag:
+ * a provider declares exactly the capabilities it implements, and the factory
+ * walks providers by capability when routing or failing over.
+ */
+type ProviderCapability = "text" | "image" | "video";
+/** Cost estimation input — any generation request shape the fleet knows. */
+type CostEstimateRequest = TextGenerationRequest | ImageGenerationRequest | VideoGenerationRequest;
+interface IProviderBase {
+    readonly id: string;
+    readonly name: string;
+    readonly capabilities: ReadonlyArray<ProviderCapability>;
+    healthCheck(): Promise<ProviderHealth>;
+    estimateCost(request: CostEstimateRequest): Promise<number>;
+}
+/**
+ * A provider that can turn conversations into text. This is the surface the
+ * factory's `chat`/`chatStream` walk; model choice per quality tier is the
+ * provider's own business (each maps neutral tiers onto its catalogue).
+ */
+interface ITextProvider extends IProviderBase {
+    generate(request: TextRequest): Promise<GenerationResult>;
+    generateStructured<T>(request: StructuredTextRequest): Promise<StructuredGeneration<T>>;
+    stream(request: TextRequest, callbacks: StreamCallbacks): Promise<GenerationResult>;
+    resolveModel(tier: TextTier): string;
+}
+/**
+ * A provider that generates media. Kept as B's media surface — image/video
+ * request and result shapes are already provider-neutral.
+ */
+interface IMediaProvider extends IProviderBase {
+    generateImage(request: ImageGenerationRequest): Promise<GeneratedContent>;
+    generateVideo(request: VideoGenerationRequest): Promise<GeneratedContent>;
+    imageToVideo(request: ImageToVideoRequest): Promise<GeneratedContent>;
+    videoToVideo(request: VideoToVideoRequest): Promise<GeneratedContent>;
+}
+type AnyProvider = ITextProvider | IMediaProvider;
+declare function isTextProvider(provider: AnyProvider): provider is ITextProvider;
+declare function isMediaProvider(provider: AnyProvider): provider is IMediaProvider;
+
+interface TextGenerationOptions {
+    maxTokens?: number;
+    temperature?: number;
+    topP?: number;
+    stopSequences?: string[];
+    model?: string;
+}
+interface ITextGenerator {
+    generateText(prompt: string, options?: TextGenerationOptions): Promise<string>;
+    generateTextStream(prompt: string, options?: TextGenerationOptions): AsyncGenerator<string>;
+}
+
+interface ProviderFactoryConfig {
+    /** Provider ids in preference order; unlisted providers follow in registration order. */
+    priority?: ReadonlyArray<string>;
+    fallbackEnabled?: boolean;
+    /** Tier used when a request names neither a model nor a tier. */
+    defaultTier?: TextTier;
+}
+/**
+ * Composition-aware registry and router. Replaces both ancestors at once:
+ * B's ProviderFactory (health TTL cache, priority fallback walk, media
+ * dispatch) and A's singleton configureProvider (via createAI). Adds the
+ * provider-neutral `chat`/`chatStream` text surface with full usage
+ * propagation, and keeps B's ITextGenerator string facade so the ported
+ * content services compile unchanged.
+ */
+declare class ProviderFactory implements ITextGenerator {
+    private readonly providers;
+    private readonly healthCache;
+    private readonly priority;
+    private readonly fallbackEnabled;
+    readonly defaultTier: TextTier;
+    constructor(config?: ProviderFactoryConfig);
+    register(provider: AnyProvider): void;
+    getProvider(id: string): AnyProvider | undefined;
+    getAllProviders(): AnyProvider[];
+    getByCapability(capability: ProviderCapability): AnyProvider[];
+    getTextProviders(): ITextProvider[];
+    hasTextProvider(): boolean;
+    /**
+     * Single-chat entry point: resolves a healthy text provider by priority,
+     * injects the default tier when the request names neither model nor tier,
+     * and walks the fallback chain on failure. Providers map tiers onto their
+     * own models, so switching Groq→Anthropic is a config change.
+     */
+    chat(request: TextRequest): Promise<GenerationResult>;
+    chatStream(request: TextRequest, callbacks: StreamCallbacks): Promise<GenerationResult>;
+    /** AsyncGenerator adapter over chatStream — A's familiar consumption shape. */
+    streamText(request: TextRequest): AsyncGenerator<string>;
+    generateJson<T>(request: StructuredTextRequest): Promise<StructuredGeneration<T>>;
+    generateText(prompt: string, options?: TextGenerationOptions): Promise<string>;
+    generateTextStream(prompt: string, options?: TextGenerationOptions): AsyncGenerator<string>;
+    generateImage(request: ImageGenerationRequest): Promise<GeneratedContent>;
+    generateVideo(request: VideoGenerationRequest): Promise<GeneratedContent>;
+    imageToVideo(request: ImageToVideoRequest): Promise<GeneratedContent>;
+    videoToVideo(request: VideoToVideoRequest): Promise<GeneratedContent>;
+    checkProviderHealth(providerId: string, forceRefresh?: boolean): Promise<ProviderHealth>;
+    isProviderHealthy(providerId: string): boolean;
+    refreshAllHealth(): Promise<void>;
+    private executeWithFallback;
+    private orderByPriority;
+    private markDegraded;
+    private noProviderError;
+}
+
+export { type AnyProvider as A, type CostEstimateRequest as C, type IMediaProvider as I, type ProviderCapability as P, type TextGenerationOptions as T, type IProviderBase as a, type ITextProvider as b, ProviderFactory as c, type ProviderFactoryConfig as d, isTextProvider as e, type ITextGenerator as f, isMediaProvider as i };

package/dist/provider.factory-DfDfk0dK.d.ts

@@ -0,0 +1,110 @@
+import { P as ProviderHealth, T as TextRequest, G as GenerationResult, b as StructuredTextRequest, a as StructuredGeneration, S as StreamCallbacks, c as TextTier } from './index-fXjxTR5W.js';
+import { T as TextGenerationRequest, I as ImageGenerationRequest, V as VideoGenerationRequest, G as GeneratedContent, a as ImageToVideoRequest, b as VideoToVideoRequest } from './ProviderConfig-DIFa9nmG.js';
+
+/**
+ * What a provider can serve. Replaces the old single `'multimodal'` type flag:
+ * a provider declares exactly the capabilities it implements, and the factory
+ * walks providers by capability when routing or failing over.
+ */
+type ProviderCapability = "text" | "image" | "video";
+/** Cost estimation input — any generation request shape the fleet knows. */
+type CostEstimateRequest = TextGenerationRequest | ImageGenerationRequest | VideoGenerationRequest;
+interface IProviderBase {
+    readonly id: string;
+    readonly name: string;
+    readonly capabilities: ReadonlyArray<ProviderCapability>;
+    healthCheck(): Promise<ProviderHealth>;
+    estimateCost(request: CostEstimateRequest): Promise<number>;
+}
+/**
+ * A provider that can turn conversations into text. This is the surface the
+ * factory's `chat`/`chatStream` walk; model choice per quality tier is the
+ * provider's own business (each maps neutral tiers onto its catalogue).
+ */
+interface ITextProvider extends IProviderBase {
+    generate(request: TextRequest): Promise<GenerationResult>;
+    generateStructured<T>(request: StructuredTextRequest): Promise<StructuredGeneration<T>>;
+    stream(request: TextRequest, callbacks: StreamCallbacks): Promise<GenerationResult>;
+    resolveModel(tier: TextTier): string;
+}
+/**
+ * A provider that generates media. Kept as B's media surface — image/video
+ * request and result shapes are already provider-neutral.
+ */
+interface IMediaProvider extends IProviderBase {
+    generateImage(request: ImageGenerationRequest): Promise<GeneratedContent>;
+    generateVideo(request: VideoGenerationRequest): Promise<GeneratedContent>;
+    imageToVideo(request: ImageToVideoRequest): Promise<GeneratedContent>;
+    videoToVideo(request: VideoToVideoRequest): Promise<GeneratedContent>;
+}
+type AnyProvider = ITextProvider | IMediaProvider;
+declare function isTextProvider(provider: AnyProvider): provider is ITextProvider;
+declare function isMediaProvider(provider: AnyProvider): provider is IMediaProvider;
+
+interface TextGenerationOptions {
+    maxTokens?: number;
+    temperature?: number;
+    topP?: number;
+    stopSequences?: string[];
+    model?: string;
+}
+interface ITextGenerator {
+    generateText(prompt: string, options?: TextGenerationOptions): Promise<string>;
+    generateTextStream(prompt: string, options?: TextGenerationOptions): AsyncGenerator<string>;
+}
+
+interface ProviderFactoryConfig {
+    /** Provider ids in preference order; unlisted providers follow in registration order. */
+    priority?: ReadonlyArray<string>;
+    fallbackEnabled?: boolean;
+    /** Tier used when a request names neither a model nor a tier. */
+    defaultTier?: TextTier;
+}
+/**
+ * Composition-aware registry and router. Replaces both ancestors at once:
+ * B's ProviderFactory (health TTL cache, priority fallback walk, media
+ * dispatch) and A's singleton configureProvider (via createAI). Adds the
+ * provider-neutral `chat`/`chatStream` text surface with full usage
+ * propagation, and keeps B's ITextGenerator string facade so the ported
+ * content services compile unchanged.
+ */
+declare class ProviderFactory implements ITextGenerator {
+    private readonly providers;
+    private readonly healthCache;
+    private readonly priority;
+    private readonly fallbackEnabled;
+    readonly defaultTier: TextTier;
+    constructor(config?: ProviderFactoryConfig);
+    register(provider: AnyProvider): void;
+    getProvider(id: string): AnyProvider | undefined;
+    getAllProviders(): AnyProvider[];
+    getByCapability(capability: ProviderCapability): AnyProvider[];
+    getTextProviders(): ITextProvider[];
+    hasTextProvider(): boolean;
+    /**
+     * Single-chat entry point: resolves a healthy text provider by priority,
+     * injects the default tier when the request names neither model nor tier,
+     * and walks the fallback chain on failure. Providers map tiers onto their
+     * own models, so switching Groq→Anthropic is a config change.
+     */
+    chat(request: TextRequest): Promise<GenerationResult>;
+    chatStream(request: TextRequest, callbacks: StreamCallbacks): Promise<GenerationResult>;
+    /** AsyncGenerator adapter over chatStream — A's familiar consumption shape. */
+    streamText(request: TextRequest): AsyncGenerator<string>;
+    generateJson<T>(request: StructuredTextRequest): Promise<StructuredGeneration<T>>;
+    generateText(prompt: string, options?: TextGenerationOptions): Promise<string>;
+    generateTextStream(prompt: string, options?: TextGenerationOptions): AsyncGenerator<string>;
+    generateImage(request: ImageGenerationRequest): Promise<GeneratedContent>;
+    generateVideo(request: VideoGenerationRequest): Promise<GeneratedContent>;
+    imageToVideo(request: ImageToVideoRequest): Promise<GeneratedContent>;
+    videoToVideo(request: VideoToVideoRequest): Promise<GeneratedContent>;
+    checkProviderHealth(providerId: string, forceRefresh?: boolean): Promise<ProviderHealth>;
+    isProviderHealthy(providerId: string): boolean;
+    refreshAllHealth(): Promise<void>;
+    private executeWithFallback;
+    private orderByPriority;
+    private markDegraded;
+    private noProviderError;
+}
+
+export { type AnyProvider as A, type CostEstimateRequest as C, type IMediaProvider as I, type ProviderCapability as P, type TextGenerationOptions as T, type IProviderBase as a, type ITextProvider as b, ProviderFactory as c, type ProviderFactoryConfig as d, isTextProvider as e, type ITextGenerator as f, isMediaProvider as i };