@umituz/web-ai 0.0.0-stage → 1.0.1

package/dist/index-DIHz8_OJ.d.ts

@@ -0,0 +1,48 @@
+import { c as TextTier } from './index-fXjxTR5W.js';
+
+declare enum AIErrorType {
+    INVALID_API_KEY = "INVALID_API_KEY",
+    MISSING_CONFIG = "MISSING_CONFIG",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    ABORT_ERROR = "ABORT_ERROR",
+    RATE_LIMIT_ERROR = "RATE_LIMIT_ERROR",
+    SERVER_ERROR = "SERVER_ERROR",
+    CLIENT_ERROR = "CLIENT_ERROR",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+declare const USER_FRIENDLY_ERROR_MESSAGES: Readonly<Record<AIErrorType, string>>;
+
+interface AIErrorMetadata {
+    readonly status?: number;
+    readonly url?: string;
+    readonly [key: string]: unknown;
+}
+declare class AIError extends Error {
+    readonly type: AIErrorType;
+    readonly code: string;
+    readonly cause?: unknown;
+    readonly metadata: AIErrorMetadata;
+    constructor(typeOrMessage: AIErrorType | string, messageOrCode?: string, cause?: unknown, metadata?: AIErrorMetadata);
+    static from(error: unknown, fallbackCode?: string): AIError;
+    toString(): string;
+    toJSON(): {
+        name: string;
+        type: AIErrorType;
+        code: string;
+        message: string;
+        metadata: AIErrorMetadata;
+    };
+}
+
+/**
+ * Per-provider default model per tier. Config can override any slot; an
+ * explicit `model` on a request overrides everything. This table is the knob
+ * that turns "switch from Claude to Groq" into a config edit.
+ */
+type TierModelMap = Readonly<Partial<Record<TextTier, string>>>;
+declare const TEXT_TIERS: ReadonlyArray<TextTier>;
+declare function isTextTier(value: unknown): value is TextTier;
+declare function resolveModel(tiers: TierModelMap, tier: TextTier, providerId: string): string;
+declare function mergeTierOverrides(defaults: TierModelMap, overrides?: TierModelMap): TierModelMap;
+
+export { AIError as A, TEXT_TIERS as T, USER_FRIENDLY_ERROR_MESSAGES as U, type AIErrorMetadata as a, AIErrorType as b, type TierModelMap as c, isTextTier as i, mergeTierOverrides as m, resolveModel as r };

package/dist/index-DKHNcMbl.d.cts

@@ -0,0 +1,48 @@
+import { c as TextTier } from './index-fXjxTR5W.cjs';
+
+declare enum AIErrorType {
+    INVALID_API_KEY = "INVALID_API_KEY",
+    MISSING_CONFIG = "MISSING_CONFIG",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    ABORT_ERROR = "ABORT_ERROR",
+    RATE_LIMIT_ERROR = "RATE_LIMIT_ERROR",
+    SERVER_ERROR = "SERVER_ERROR",
+    CLIENT_ERROR = "CLIENT_ERROR",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+declare const USER_FRIENDLY_ERROR_MESSAGES: Readonly<Record<AIErrorType, string>>;
+
+interface AIErrorMetadata {
+    readonly status?: number;
+    readonly url?: string;
+    readonly [key: string]: unknown;
+}
+declare class AIError extends Error {
+    readonly type: AIErrorType;
+    readonly code: string;
+    readonly cause?: unknown;
+    readonly metadata: AIErrorMetadata;
+    constructor(typeOrMessage: AIErrorType | string, messageOrCode?: string, cause?: unknown, metadata?: AIErrorMetadata);
+    static from(error: unknown, fallbackCode?: string): AIError;
+    toString(): string;
+    toJSON(): {
+        name: string;
+        type: AIErrorType;
+        code: string;
+        message: string;
+        metadata: AIErrorMetadata;
+    };
+}
+
+/**
+ * Per-provider default model per tier. Config can override any slot; an
+ * explicit `model` on a request overrides everything. This table is the knob
+ * that turns "switch from Claude to Groq" into a config edit.
+ */
+type TierModelMap = Readonly<Partial<Record<TextTier, string>>>;
+declare const TEXT_TIERS: ReadonlyArray<TextTier>;
+declare function isTextTier(value: unknown): value is TextTier;
+declare function resolveModel(tiers: TierModelMap, tier: TextTier, providerId: string): string;
+declare function mergeTierOverrides(defaults: TierModelMap, overrides?: TierModelMap): TierModelMap;
+
+export { AIError as A, TEXT_TIERS as T, USER_FRIENDLY_ERROR_MESSAGES as U, type AIErrorMetadata as a, AIErrorType as b, type TierModelMap as c, isTextTier as i, mergeTierOverrides as m, resolveModel as r };

package/dist/index-fXjxTR5W.d.cts

@@ -0,0 +1,66 @@
+/**
+ * Provider-neutral types shared by every layer of @umituz/web-ai.
+ * Nothing in this file imports a provider — the whole point of the package
+ * is that swapping Groq for Claude (or vice versa) is a config change, and
+ * these types are the vocabulary that makes that possible.
+ */
+/** Neutral quality tier — providers map it onto their own concrete models. */
+type TextTier = "fast" | "balanced" | "powerful";
+/** Why the model stopped generating, normalized across providers. */
+type FinishReason = "stop" | "length" | "content_filter" | "refusal";
+/** Token accounting, normalized from each provider's native usage shape. */
+interface TokenUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly totalTokens?: number;
+}
+/** What every text-generating method returns — usage is never discarded. */
+interface GenerationResult {
+    readonly text: string;
+    readonly usage?: TokenUsage;
+    readonly model: string;
+    readonly providerId: string;
+    readonly finishReason?: FinishReason;
+}
+/** Universal chat message shape; providers translate to their own wire format. */
+interface ChatMessage {
+    readonly role: "system" | "user" | "assistant";
+    readonly content: string;
+}
+interface TextRequest {
+    /** Full conversation, oldest first. systemPrompt is preferred over system roles here. */
+    readonly messages: ReadonlyArray<ChatMessage>;
+    /** Top-level system instruction; providers that need it in-band map it themselves. */
+    readonly systemPrompt?: string;
+    /** Explicit model id — always wins over tier resolution. */
+    readonly model?: string;
+    /** Neutral quality tier; resolved against the serving provider's model map. */
+    readonly tier?: TextTier;
+    readonly maxTokens?: number;
+    /**
+     * Sampling hints. Honored by providers whose API still supports sampling
+     * parameters (Groq, Gemini); ignored by Anthropic — its current API version
+     * rejects temperature/top_p outright, so the Anthropic provider never puts
+     * them on the wire.
+     */
+    readonly temperature?: number;
+    readonly topP?: number;
+    readonly stopSequences?: ReadonlyArray<string>;
+    readonly signal?: AbortSignal;
+}
+interface StreamCallbacks {
+    readonly onChunk?: (text: string) => void;
+    readonly onComplete?: (result: GenerationResult) => void;
+    readonly onError?: (error: Error) => void;
+}
+interface StructuredTextRequest extends TextRequest {
+    /** JSON schema describing the expected object; embedded into the prompt. */
+    readonly schema: Record<string, unknown>;
+}
+interface StructuredGeneration<T> {
+    readonly value: T;
+    readonly result: GenerationResult;
+}
+type ProviderHealth = "healthy" | "degraded" | "exhausted" | "unavailable";
+
+export type { ChatMessage as C, FinishReason as F, GenerationResult as G, ProviderHealth as P, StreamCallbacks as S, TextRequest as T, StructuredGeneration as a, StructuredTextRequest as b, TextTier as c, TokenUsage as d };

package/dist/index-fXjxTR5W.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Provider-neutral types shared by every layer of @umituz/web-ai.
+ * Nothing in this file imports a provider — the whole point of the package
+ * is that swapping Groq for Claude (or vice versa) is a config change, and
+ * these types are the vocabulary that makes that possible.
+ */
+/** Neutral quality tier — providers map it onto their own concrete models. */
+type TextTier = "fast" | "balanced" | "powerful";
+/** Why the model stopped generating, normalized across providers. */
+type FinishReason = "stop" | "length" | "content_filter" | "refusal";
+/** Token accounting, normalized from each provider's native usage shape. */
+interface TokenUsage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly totalTokens?: number;
+}
+/** What every text-generating method returns — usage is never discarded. */
+interface GenerationResult {
+    readonly text: string;
+    readonly usage?: TokenUsage;
+    readonly model: string;
+    readonly providerId: string;
+    readonly finishReason?: FinishReason;
+}
+/** Universal chat message shape; providers translate to their own wire format. */
+interface ChatMessage {
+    readonly role: "system" | "user" | "assistant";
+    readonly content: string;
+}
+interface TextRequest {
+    /** Full conversation, oldest first. systemPrompt is preferred over system roles here. */
+    readonly messages: ReadonlyArray<ChatMessage>;
+    /** Top-level system instruction; providers that need it in-band map it themselves. */
+    readonly systemPrompt?: string;
+    /** Explicit model id — always wins over tier resolution. */
+    readonly model?: string;
+    /** Neutral quality tier; resolved against the serving provider's model map. */
+    readonly tier?: TextTier;
+    readonly maxTokens?: number;
+    /**
+     * Sampling hints. Honored by providers whose API still supports sampling
+     * parameters (Groq, Gemini); ignored by Anthropic — its current API version
+     * rejects temperature/top_p outright, so the Anthropic provider never puts
+     * them on the wire.
+     */
+    readonly temperature?: number;
+    readonly topP?: number;
+    readonly stopSequences?: ReadonlyArray<string>;
+    readonly signal?: AbortSignal;
+}
+interface StreamCallbacks {
+    readonly onChunk?: (text: string) => void;
+    readonly onComplete?: (result: GenerationResult) => void;
+    readonly onError?: (error: Error) => void;
+}
+interface StructuredTextRequest extends TextRequest {
+    /** JSON schema describing the expected object; embedded into the prompt. */
+    readonly schema: Record<string, unknown>;
+}
+interface StructuredGeneration<T> {
+    readonly value: T;
+    readonly result: GenerationResult;
+}
+type ProviderHealth = "healthy" | "degraded" | "exhausted" | "unavailable";
+
+export type { ChatMessage as C, FinishReason as F, GenerationResult as G, ProviderHealth as P, StreamCallbacks as S, TextRequest as T, StructuredGeneration as a, StructuredTextRequest as b, TextTier as c, TokenUsage as d };