@umituz/web-ai 1.1.0 → 1.2.0

package/dist/{create-ai-D-oEWzf9.d.ts → create-ai-Cq3HkJxd.d.ts}

@@ -228,6 +228,57 @@ interface StreamRequestOptions {
     readonly signal?: AbortSignal;
 }
 
+/**
+ * Wire-neutral config for any OpenAI-compatible chat-completions endpoint:
+ * OpenAI itself, Groq, OpenRouter, vLLM, LiteLLM, or a Cloudflare AI Gateway
+ * in front of any of them. Two URL shapes are accepted because gateways hand
+ * out both: `baseUrl` (the API root, `/chat/completions` appended) or
+ * `endpointUrl` (the complete chat-completions URL, which wins).
+ *
+ * Model choice: `model` pins every request to one id — the single-model
+ * gateway case; `models` maps the neutral tiers (fast/balanced/powerful) the
+ * way the named providers do. Explicit `model` on a request still overrides
+ * both, as everywhere in the package.
+ */
+interface OpenAiCompatibleProviderConfig {
+    readonly apiKey: string;
+    readonly baseUrl?: string;
+    readonly endpointUrl?: string;
+    readonly model?: string;
+    readonly models?: TierModelMap;
+    readonly timeoutMs?: number;
+}
+
+/**
+ * Structural types for Cloudflare Workers AI — no @cloudflare/workers-types
+ * dependency, exactly like the apps that consume this package. A binding is
+ * "anything with run(model, input)"; the env is "anything that may carry an
+ * optional AI binding", so `{ AI?: ... }` app envs satisfy it as-is.
+ */
+interface WorkersAIBinding {
+    run(model: string, input: Record<string, unknown>): Promise<unknown>;
+}
+interface WorkersAIEnv {
+    AI?: WorkersAIBinding;
+}
+/** Chat message shape the Workers AI text models speak (OpenAI convention). */
+interface WorkersAIMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/** Error carrying the provider status when one exists (route → HTTP code). */
+declare class WorkersAIError extends Error {
+    readonly status?: number;
+    constructor(message: string, status?: number);
+}
+/** Constructor config for the class-based provider (createAI wiring). */
+interface WorkersAIProviderConfig {
+    /** The `env.AI` binding — its presence IS the enabled flag (no apiKey). */
+    binding: WorkersAIBinding;
+    /** Per-tier model overrides; defaults live in WORKERS_AI_TIERS. */
+    models?: Partial<Record<TextTier, string>>;
+}
+
 /**
  * Composition root for the whole package — replaces the old
  * `configureProvider()` singleton. A provider block's presence means the
@@ -255,7 +306,16 @@ interface AIProviderConfig {
     gemini?: Omit<GeminiConfig, "enabled">;
     fal?: Omit<FalConfig, "enabled">;
     pruna?: Omit<PrunaConfig, "enabled">;
+    /** Any OpenAI-compatible endpoint (OpenAI, OpenRouter, vLLM, LiteLLM,
+     *  Cloudflare AI Gateway) addressed by URL — the gateway shape apps
+     *  deploy behind instead of a named vendor key. */
+    openaiCompatible?: Omit<OpenAiCompatibleProviderConfig, "apiKey"> & {
+        apiKey?: string;
+    };
+    /** Cloudflare Workers AI over the `env.AI` binding — no apiKey; the
+     *  binding's presence IS the enabled flag (free-tier text lane). */
+    workersAI?: WorkersAIProviderConfig;
 }
 declare function createAI(config?: AIProviderConfig): ProviderFactory;
 
-export { type AIProviderConfig as A, type GroqChatChunk as G, type StreamRequestOptions as S, ANTHROPIC_API_VERSION as a, ANTHROPIC_DEFAULT_MAX_TOKENS as b, ANTHROPIC_MODELS as c, ANTHROPIC_TIERS as d, type AnthropicEffort as e, type AnthropicMessagesRequest as f, type AnthropicMessagesResponse as g, type AnthropicProviderConfig as h, type AnthropicStopReason as i, type AnthropicStreamEvent as j, type GroqChatRequest as k, type GroqChatResponse as l, type GroqChoice as m, type GroqChunkChoice as n, type GroqConfig as o, type GroqErrorResponse as p, type GroqGenerationConfig as q, type GroqMessage as r, type GroqMessageRole as s, type GroqProviderConfig as t, type GroqReasoningEffort as u, type GroqUsage as v, createAI as w, type AnthropicMessage as x };
+export { type AIProviderConfig as A, createAI as B, type AnthropicMessage as C, type GroqChatChunk as G, type OpenAiCompatibleProviderConfig as O, type StreamRequestOptions as S, type WorkersAIBinding as W, ANTHROPIC_API_VERSION as a, ANTHROPIC_DEFAULT_MAX_TOKENS as b, ANTHROPIC_MODELS as c, ANTHROPIC_TIERS as d, type AnthropicEffort as e, type AnthropicMessagesRequest as f, type AnthropicMessagesResponse as g, type AnthropicProviderConfig as h, type AnthropicStopReason as i, type AnthropicStreamEvent as j, type GroqChatRequest as k, type GroqChatResponse as l, type GroqChoice as m, type GroqChunkChoice as n, type GroqConfig as o, type GroqErrorResponse as p, type GroqGenerationConfig as q, type GroqMessage as r, type GroqMessageRole as s, type GroqProviderConfig as t, type GroqReasoningEffort as u, type GroqUsage as v, type WorkersAIEnv as w, WorkersAIError as x, type WorkersAIMessage as y, type WorkersAIProviderConfig as z };

package/dist/{create-ai-DRysRImc.d.cts → create-ai-DDyTVzef.d.cts}

@@ -228,6 +228,57 @@ interface StreamRequestOptions {
     readonly signal?: AbortSignal;
 }
 
+/**
+ * Wire-neutral config for any OpenAI-compatible chat-completions endpoint:
+ * OpenAI itself, Groq, OpenRouter, vLLM, LiteLLM, or a Cloudflare AI Gateway
+ * in front of any of them. Two URL shapes are accepted because gateways hand
+ * out both: `baseUrl` (the API root, `/chat/completions` appended) or
+ * `endpointUrl` (the complete chat-completions URL, which wins).
+ *
+ * Model choice: `model` pins every request to one id — the single-model
+ * gateway case; `models` maps the neutral tiers (fast/balanced/powerful) the
+ * way the named providers do. Explicit `model` on a request still overrides
+ * both, as everywhere in the package.
+ */
+interface OpenAiCompatibleProviderConfig {
+    readonly apiKey: string;
+    readonly baseUrl?: string;
+    readonly endpointUrl?: string;
+    readonly model?: string;
+    readonly models?: TierModelMap;
+    readonly timeoutMs?: number;
+}
+
+/**
+ * Structural types for Cloudflare Workers AI — no @cloudflare/workers-types
+ * dependency, exactly like the apps that consume this package. A binding is
+ * "anything with run(model, input)"; the env is "anything that may carry an
+ * optional AI binding", so `{ AI?: ... }` app envs satisfy it as-is.
+ */
+interface WorkersAIBinding {
+    run(model: string, input: Record<string, unknown>): Promise<unknown>;
+}
+interface WorkersAIEnv {
+    AI?: WorkersAIBinding;
+}
+/** Chat message shape the Workers AI text models speak (OpenAI convention). */
+interface WorkersAIMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/** Error carrying the provider status when one exists (route → HTTP code). */
+declare class WorkersAIError extends Error {
+    readonly status?: number;
+    constructor(message: string, status?: number);
+}
+/** Constructor config for the class-based provider (createAI wiring). */
+interface WorkersAIProviderConfig {
+    /** The `env.AI` binding — its presence IS the enabled flag (no apiKey). */
+    binding: WorkersAIBinding;
+    /** Per-tier model overrides; defaults live in WORKERS_AI_TIERS. */
+    models?: Partial<Record<TextTier, string>>;
+}
+
 /**
  * Composition root for the whole package — replaces the old
  * `configureProvider()` singleton. A provider block's presence means the
@@ -255,7 +306,16 @@ interface AIProviderConfig {
     gemini?: Omit<GeminiConfig, "enabled">;
     fal?: Omit<FalConfig, "enabled">;
     pruna?: Omit<PrunaConfig, "enabled">;
+    /** Any OpenAI-compatible endpoint (OpenAI, OpenRouter, vLLM, LiteLLM,
+     *  Cloudflare AI Gateway) addressed by URL — the gateway shape apps
+     *  deploy behind instead of a named vendor key. */
+    openaiCompatible?: Omit<OpenAiCompatibleProviderConfig, "apiKey"> & {
+        apiKey?: string;
+    };
+    /** Cloudflare Workers AI over the `env.AI` binding — no apiKey; the
+     *  binding's presence IS the enabled flag (free-tier text lane). */
+    workersAI?: WorkersAIProviderConfig;
 }
 declare function createAI(config?: AIProviderConfig): ProviderFactory;
 
-export { type AIProviderConfig as A, type GroqChatChunk as G, type StreamRequestOptions as S, ANTHROPIC_API_VERSION as a, ANTHROPIC_DEFAULT_MAX_TOKENS as b, ANTHROPIC_MODELS as c, ANTHROPIC_TIERS as d, type AnthropicEffort as e, type AnthropicMessagesRequest as f, type AnthropicMessagesResponse as g, type AnthropicProviderConfig as h, type AnthropicStopReason as i, type AnthropicStreamEvent as j, type GroqChatRequest as k, type GroqChatResponse as l, type GroqChoice as m, type GroqChunkChoice as n, type GroqConfig as o, type GroqErrorResponse as p, type GroqGenerationConfig as q, type GroqMessage as r, type GroqMessageRole as s, type GroqProviderConfig as t, type GroqReasoningEffort as u, type GroqUsage as v, createAI as w, type AnthropicMessage as x };
+export { type AIProviderConfig as A, createAI as B, type AnthropicMessage as C, type GroqChatChunk as G, type OpenAiCompatibleProviderConfig as O, type StreamRequestOptions as S, type WorkersAIBinding as W, ANTHROPIC_API_VERSION as a, ANTHROPIC_DEFAULT_MAX_TOKENS as b, ANTHROPIC_MODELS as c, ANTHROPIC_TIERS as d, type AnthropicEffort as e, type AnthropicMessagesRequest as f, type AnthropicMessagesResponse as g, type AnthropicProviderConfig as h, type AnthropicStopReason as i, type AnthropicStreamEvent as j, type GroqChatRequest as k, type GroqChatResponse as l, type GroqChoice as m, type GroqChunkChoice as n, type GroqConfig as o, type GroqErrorResponse as p, type GroqGenerationConfig as q, type GroqMessage as r, type GroqMessageRole as s, type GroqProviderConfig as t, type GroqReasoningEffort as u, type GroqUsage as v, type WorkersAIEnv as w, WorkersAIError as x, type WorkersAIMessage as y, type WorkersAIProviderConfig as z };