@tombcato/ai-selector-core 0.1.1 → 0.1.2

package/dist/index.d.ts

@@ -1,13 +1,354 @@
-/**
- * AI Provider Selector - Core Package
- * Framework-agnostic logic for AI provider configuration
- */
-export * from './i18n';
-export type { Provider, Model, AIConfig, ApiFormat, TestConnectionOptions, TestConnectionResult, FetchModelsOptions, StorageAdapter, ProviderConfig, CustomProviderDefinition, AIConfigFormProps, ModelFetcher, FetcherParams, FetcherActionType, } from './types';
-export { PROVIDERS, PROVIDER_ID, type ProviderId, getProvider, getAllProviders, getProvidersByFormat } from './providers';
-export { STATIC_MODELS, getStaticModels } from './models';
-export { testConnection, fetchModels } from './api';
-export { localStorageAdapter, createConfigStorage } from './storage';
-export { resolveProviderConfig, getProviderFromConfig, type ResolvedConfig } from './config';
-export { type ProviderStrategy, strategyRegistry, getStrategy, sendDirectChat, testDirectConnection, type DirectChatOptions, type DirectChatResult, } from './strategies';
-//# sourceMappingURL=index.d.ts.map
+export declare interface AIConfig {
+    providerId: string;
+    apiKey: string;
+    model: string;
+    modelName?: string;
+    baseUrl?: string;
+}
+
+/** AIConfigForm 组件的 Props */
+export declare interface AIConfigFormProps {
+    /**
+     * 自定义请求处理器
+     * 用于接管获取模型列表和连通性测试的请求
+     * 如果提供此函数，proxyUrl 在这两种操作中将被忽略
+     */
+    modelFetcher?: ModelFetcher;
+    /** 后端代理地址（必需，除非提供了 modelFetcher） */
+    proxyUrl?: string;
+    /** Provider 配置（可选，默认使用全部内置 Providers） */
+    config?: ProviderConfig;
+    /** 初始配置（可选，用于编辑已有配置） */
+    initialConfig?: Partial<AIConfig>;
+    /** 表单标题 */
+    title?: string;
+    /** 是否显示配置预览区域 */
+    showPreview?: boolean;
+    /** 保存按钮文本 */
+    saveButtonText?: string;
+    /** 是否禁用整个表单 */
+    disabled?: boolean;
+}
+
+/**
+ * AI Provider Selector - Core Types
+ * Framework-agnostic type definitions
+ */
+export declare type ApiFormat = 'openai' | 'anthropic' | 'gemini' | 'cohere';
+
+export declare function createConfigStorage(adapter?: StorageAdapter, options?: StorageOptions): {
+    /**
+     * Save AI config
+     */
+    save(config: AIConfig): void;
+    /**
+     * Load AI config
+     */
+    load(): AIConfig | null;
+    /**
+     * Clear AI config
+     */
+    clear(): void;
+};
+
+/** 自定义 Provider 定义 */
+export declare interface CustomProviderDefinition {
+    name: string;
+    baseUrl: string;
+    needsApiKey: boolean;
+    apiFormat: ApiFormat;
+    supportsModelsApi?: boolean;
+    icon?: string;
+    /** 静态模型列表（当不支持 /models API 时使用） */
+    models?: Model[];
+}
+
+/** 自定义 Provider 定义 */
+export declare interface CustomProviderDefinition {
+    name: string;
+    baseUrl: string;
+    needsApiKey: boolean;
+    apiFormat: ApiFormat;
+    supportsModelsApi?: boolean;
+    icon?: string;
+    /** 静态模型列表（当不支持 /models API 时使用） */
+    models?: Model[];
+}
+
+export declare interface DirectChatOptions {
+    apiFormat: string;
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+    maxTokens?: number;
+}
+
+export declare interface DirectChatResult {
+    success: boolean;
+    content?: string;
+    message?: string;
+    latencyMs?: number;
+}
+
+export declare type FetcherActionType = 'fetchModels' | 'checkConnection';
+
+export declare interface FetcherParams {
+    type: FetcherActionType;
+    providerId: string;
+    baseUrl: string;
+    apiKey?: string;
+    modelId?: string;
+}
+
+/**
+ * Fetch available models from a provider
+ */
+export declare function fetchModels(options: FetchModelsOptions): Promise<Model[]>;
+
+export declare interface FetchModelsOptions {
+    provider: Provider;
+    apiKey?: string;
+    baseUrl?: string;
+    proxyUrl?: string;
+    fallbackToStatic?: boolean;
+}
+
+/**
+ * Get all providers as an array
+ */
+export declare function getAllProviders(): Provider[];
+
+/**
+ * Get a provider by ID
+ */
+export declare function getProvider(id: string): Provider | undefined;
+
+/**
+ * Get a single provider by ID from config
+ */
+export declare function getProviderFromConfig(providerId: string, config?: ProviderConfig): Provider | null;
+
+/**
+ * Get providers by API format
+ */
+export declare function getProvidersByFormat(format: Provider['apiFormat']): Provider[];
+
+/**
+ * Get static models for a provider
+ */
+export declare function getStaticModels(providerId: string): Model[];
+
+export declare function getStrategy(format: string): ProviderStrategy;
+
+export declare const I18N: {
+    readonly zh: {
+        readonly save: "保存配置";
+        readonly saved: "保存成功";
+        readonly providerLabel: "Provider";
+        readonly modelLabel: "Model";
+        readonly selectProvider: "选择 Provider...";
+        readonly customBaseUrl: "自定义 Base URL";
+        readonly apiKeyLabel: "API Key";
+        readonly apiKeyPlaceholder: "输入 API Key...";
+        readonly testConnection: "测试模型连接";
+        readonly testing: "测试中...";
+        readonly testSuccess: "连接成功";
+        readonly testFailed: "测试连通性失败";
+        readonly selectModel: "选择 Model...";
+        readonly searchModel: "搜索或自定义模型...";
+        readonly useCustom: "使用自定义";
+        readonly noModels: "暂无模型数据";
+        readonly apiKeyTip: "输入 API Key 后可获取完整模型列表";
+        readonly fetchModelsFailed: "拉取模型列表失败，已使用离线模型列表";
+        readonly refreshingModels: "列表刷新中...";
+        readonly modelListUpdated: "模型列表已刷新";
+        readonly preview: "配置预览";
+        readonly unselected: "(未选择)";
+    };
+    readonly en: {
+        readonly save: "Save Config";
+        readonly saved: "Saved";
+        readonly providerLabel: "Provider";
+        readonly modelLabel: "Model";
+        readonly selectProvider: "Select Provider...";
+        readonly customBaseUrl: "Custom Base URL";
+        readonly apiKeyLabel: "API Key";
+        readonly apiKeyPlaceholder: "Enter API Key...";
+        readonly testConnection: "Test Model Connection";
+        readonly testing: "Testing...";
+        readonly testSuccess: "Connection Successful";
+        readonly testFailed: "Connection Failed";
+        readonly selectModel: "Select Model...";
+        readonly searchModel: "Search or custom models...";
+        readonly useCustom: "Use custom";
+        readonly noModels: "No models found";
+        readonly apiKeyTip: "Enter API Key to fetch full model list";
+        readonly fetchModelsFailed: "Failed to fetch model list, using offline models";
+        readonly refreshingModels: "Refreshing models...";
+        readonly modelListUpdated: "Model list updated";
+        readonly preview: "Config Preview";
+        readonly unselected: "(Unselected)";
+    };
+};
+
+export declare type I18NKeys = keyof typeof I18N['zh'];
+
+export declare type Language = keyof typeof I18N;
+
+/**
+ * Default localStorage adapter
+ */
+export declare const localStorageAdapter: StorageAdapter;
+
+export declare interface Model {
+    id: string;
+    name: string;
+}
+
+/**
+ * Custom fetcher for retrieving models and checking connection.
+ * If provided, this will bypass internal fetch logic.
+ *
+ * - type='fetchModels': returns Promise<Model[]>
+ * - type='checkConnection': returns Promise<{ success: boolean; latency?: number; message?: string }>
+ */
+export declare type ModelFetcher = (params: FetcherParams) => Promise<any>;
+
+export declare interface Provider {
+    id: string;
+    name: string;
+    baseUrl: string;
+    needsApiKey: boolean;
+    apiFormat: ApiFormat;
+    supportsModelsApi: boolean;
+    icon?: string;
+}
+
+export declare const PROVIDER_ID: {
+    readonly OPENAI: "openai";
+    readonly ANTHROPIC: "anthropic";
+    readonly GEMINI: "gemini";
+    readonly DEEPSEEK: "deepseek";
+    readonly OPENROUTER: "openrouter";
+    readonly GROQ: "groq";
+    readonly MISTRAL: "mistral";
+    readonly MOONSHOT: "moonshot";
+    readonly QWEN: "qwen";
+    readonly ZHIPU: "zhipu";
+    readonly SILICONFLOW: "siliconflow";
+    readonly XAI: "xai";
+    readonly TOGETHER: "together";
+    readonly FIREWORKS: "fireworks";
+    readonly DEEPINFRA: "deepinfra";
+    readonly PERPLEXITY: "perplexity";
+    readonly COHERE: "cohere";
+    readonly OLLAMA: "ollama";
+    readonly DOUBAO: "doubao";
+    readonly MINIMAX: "minimax";
+};
+
+/** Provider 配置 JSON */
+export declare interface ProviderConfig {
+    /** 模式：default=内置+自定义，customOnly=只用自定义 */
+    mode: 'default' | 'customOnly';
+    /** 白名单：只显示这些内置 provider（仅 mode=default） */
+    include?: string[];
+    /** 黑名单：隐藏这些内置 provider（仅 mode=default） */
+    exclude?: string[];
+    /** 自定义 Providers */
+    custom?: Record<string, CustomProviderDefinition>;
+}
+
+export declare type ProviderId = typeof PROVIDER_ID[keyof typeof PROVIDER_ID];
+
+export declare const PROVIDERS: Record<string, Provider>;
+
+export declare interface ProviderStrategy {
+    format: string;
+    getModelsEndpoint?: (baseUrl: string, apiKey: string) => string;
+    parseModelsResponse?: (data: any) => Model[];
+    getChatEndpoint: (baseUrl: string, apiKey: string, model: string) => string;
+    buildChatPayload: (model: string, messages: Array<{
+        role: string;
+        content: string;
+    }>, maxTokens: number) => Record<string, unknown>;
+    parseChatResponse: (data: any) => string;
+    buildHeaders: (apiKey: string) => Record<string, string>;
+}
+
+export declare interface ResolvedConfig {
+    providers: Provider[];
+    getModels: (providerId: string) => Model[];
+}
+
+/**
+ * Resolve a ProviderConfig into usable providers and models
+ */
+export declare function resolveProviderConfig(config?: ProviderConfig): ResolvedConfig;
+
+/**
+ * 纯前端直连 AI 厂商进行聊天
+ * 注意: 这会将 API Key 暴露在浏览器中，仅适用于 Demo/测试场景
+ */
+export declare function sendDirectChat(options: DirectChatOptions): Promise<DirectChatResult>;
+
+export declare const STATIC_MODELS: Record<string, Model[]>;
+
+export declare interface StorageAdapter {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+}
+
+/**
+ * Create a config storage instance
+ */
+declare interface StorageOptions {
+    serialize?: (data: any) => string;
+    deserialize?: (data: string) => any;
+}
+
+export declare const strategyRegistry: Record<string, ProviderStrategy>;
+
+/**
+ * Test connection to an AI provider
+ */
+export declare function testConnection(options: TestConnectionOptions): Promise<TestConnectionResult>;
+
+export declare interface TestConnectionOptions {
+    provider: Provider;
+    apiKey: string;
+    model?: string;
+    baseUrl?: string;
+    proxyUrl?: string;
+}
+
+declare interface TestConnectionOptions_2 {
+    apiFormat: string;
+    baseUrl: string;
+    apiKey: string;
+    model: string;
+}
+
+export declare interface TestConnectionResult {
+    success: boolean;
+    latencyMs?: number;
+    message?: string;
+}
+
+declare interface TestConnectionResult_2 {
+    success: boolean;
+    latencyMs?: number;
+    message?: string;
+}
+
+/**
+ * 测试 AI 厂商连接 (通过发送一个简单的聊天请求)
+ */
+export declare function testDirectConnection(options: TestConnectionOptions_2): Promise<TestConnectionResult_2>;
+
+export { }