@flare-ai-sdk/server 1.0.0 → 1.0.1

package/dist/index.d.mts

@@ -840,10 +840,15 @@ interface AIProviderInterface {
 declare abstract class BaseProvider implements AIProviderInterface {
     protected config: ModelConfig;
     constructor(config: ModelConfig);
-    protected makeRequest(url: string, options: RequestInit, stream?: boolean): Promise<Response>;
+    /**
+     * Format messages for API request
+     * Handles system prompts and conversation history
+     */
     protected formatMessages(request: GenerateTextRequest): Message[];
-    protected getEndpoint(path: string): string;
-    protected abstract getDefaultBaseUrl(): string;
+    /**
+     * Validate configuration
+     */
+    protected validateConfig(): void;
     abstract generateText(request: GenerateTextRequest): Promise<GenerateTextResponse>;
     abstract streamText(request: GenerateTextRequest): AsyncIterable<any>;
     abstract generateObject<T>(request: GenerateObjectRequest<T>): Promise<GenerateObjectResponse<T>>;
@@ -856,10 +861,11 @@ declare abstract class BaseProvider implements AIProviderInterface {
 declare function createProvider(config: ModelConfig): AIProviderInterface;
 
 /**
- * Anthropic provider implementation
+ * Anthropic provider implementation using official SDK
  */
 declare class AnthropicProvider extends BaseProvider {
-    protected getDefaultBaseUrl(): string;
+    private client;
+    constructor(config: any);
     generateText(request: GenerateTextRequest): Promise<GenerateTextResponse>;
     streamText(request: GenerateTextRequest): AsyncIterable<any>;
     generateObject<T>(request: GenerateObjectRequest<T>): Promise<GenerateObjectResponse<T>>;
@@ -867,10 +873,11 @@ declare class AnthropicProvider extends BaseProvider {
 }
 
 /**
- * OpenAI provider implementation
+ * OpenAI provider implementation using official SDK
  */
 declare class OpenAIProvider extends BaseProvider {
-    protected getDefaultBaseUrl(): string;
+    private client;
+    constructor(config: any);
     generateText(request: GenerateTextRequest): Promise<GenerateTextResponse>;
     streamText(request: GenerateTextRequest): AsyncIterable<any>;
     generateObject<T>(request: GenerateObjectRequest<T>): Promise<GenerateObjectResponse<T>>;
@@ -879,7 +886,7 @@ declare class OpenAIProvider extends BaseProvider {
 
 /**
  * Google AI (Gemini) provider implementation
- * Supports Google's Gemini models via their API
+ * Supports Google's Gemini models via their official SDK
  *
  * @example
  * ```typescript
@@ -891,7 +898,9 @@ declare class OpenAIProvider extends BaseProvider {
  * ```
  */
 declare class GoogleProvider extends BaseProvider {
-    protected getDefaultBaseUrl(): string;
+    private genAI;
+    private model;
+    constructor(config: any);
     /**
      * Format messages for Google's API format
      */
@@ -900,10 +909,39 @@ declare class GoogleProvider extends BaseProvider {
     streamText(request: GenerateTextRequest): AsyncIterable<any>;
     generateObject<T>(request: GenerateObjectRequest<T>): Promise<GenerateObjectResponse<T>>;
     streamObject<T>(request: GenerateObjectRequest<T>): AsyncIterable<any>;
+    private mapGoogleFinishReason;
+}
+
+/**
+ * Base provider for custom/URL-based implementations
+ * @module providers/custom
+ */
+
+/**
+ * Base provider class for custom URL-based providers
+ * Use this for providers without official SDKs (Sarvam, Custom, etc.)
+ */
+declare abstract class CustomBaseProvider extends BaseProvider {
     /**
-     * Map Google's finish reason to standard format
+     * Make HTTP request with proper error handling
      */
-    private mapGoogleFinishReason;
+    protected makeRequest(url: string, options: RequestInit, stream?: boolean): Promise<Response>;
+    /**
+     * Get API endpoint URL
+     */
+    protected getEndpoint(path: string): string;
+    /**
+     * Get default base URL for provider
+     */
+    protected abstract getDefaultBaseUrl(): string;
+    /**
+     * Parse streaming SSE response
+     */
+    protected parseSSEStream(response: Response): AsyncIterable<any>;
+    /**
+     * Build request body with common parameters
+     */
+    protected buildRequestBody(request: GenerateTextRequest, stream?: boolean): any;
 }
 
 /**
@@ -919,58 +957,34 @@ declare class GoogleProvider extends BaseProvider {
  * });
  * ```
  */
-declare class SarvamProvider extends BaseProvider {
+declare class SarvamProvider extends CustomBaseProvider {
     protected getDefaultBaseUrl(): string;
     generateText(request: GenerateTextRequest): Promise<GenerateTextResponse>;
     streamText(request: GenerateTextRequest): AsyncIterable<any>;
     generateObject<T>(request: GenerateObjectRequest<T>): Promise<GenerateObjectResponse<T>>;
     streamObject<T>(request: GenerateObjectRequest<T>): AsyncIterable<any>;
-    /**
-     * Map Sarvam's finish reason to standard format
-     */
-    private mapSarvamFinishReason;
+    private mapFinishReason;
 }
 
 /**
- * Custom provider implementation
- * Allows integration with any OpenAI-compatible API
+ * Custom provider for any OpenAI-compatible API
  *
  * @example
  * ```typescript
  * const provider = new CustomProvider({
  *   provider: 'custom',
- *   model: 'llama-3-70b',
- *   baseUrl: 'https://your-api.com/v1',
+ *   model: 'your-model',
  *   apiKey: process.env.CUSTOM_API_KEY,
+ *   baseUrl: 'https://your-api.com/v1',
  * });
  * ```
  */
-declare class CustomProvider extends BaseProvider {
+declare class CustomProvider extends CustomBaseProvider {
     protected getDefaultBaseUrl(): string;
-    /**
-     * Request format for custom provider
-     */
-    private requestFormat;
-    /**
-     * Set request format for custom provider
-     */
-    setRequestFormat(format: 'openai' | 'anthropic' | 'custom'): void;
     generateText(request: GenerateTextRequest): Promise<GenerateTextResponse>;
     streamText(request: GenerateTextRequest): AsyncIterable<any>;
     generateObject<T>(request: GenerateObjectRequest<T>): Promise<GenerateObjectResponse<T>>;
     streamObject<T>(request: GenerateObjectRequest<T>): AsyncIterable<any>;
-    /**
-     * Format request body based on provider format
-     */
-    private formatRequestBody;
-    /**
-     * Parse text response based on provider format
-     */
-    private parseTextResponse;
-    /**
-     * Parse streaming response
-     */
-    private parseStreamResponse;
 }
 
 /**

package/dist/index.d.ts

@@ -840,10 +840,15 @@ interface AIProviderInterface {
 declare abstract class BaseProvider implements AIProviderInterface {
     protected config: ModelConfig;
     constructor(config: ModelConfig);
-    protected makeRequest(url: string, options: RequestInit, stream?: boolean): Promise<Response>;
+    /**
+     * Format messages for API request
+     * Handles system prompts and conversation history
+     */
     protected formatMessages(request: GenerateTextRequest): Message[];
-    protected getEndpoint(path: string): string;
-    protected abstract getDefaultBaseUrl(): string;
+    /**
+     * Validate configuration
+     */
+    protected validateConfig(): void;
     abstract generateText(request: GenerateTextRequest): Promise<GenerateTextResponse>;
     abstract streamText(request: GenerateTextRequest): AsyncIterable<any>;
     abstract generateObject<T>(request: GenerateObjectRequest<T>): Promise<GenerateObjectResponse<T>>;
@@ -856,10 +861,11 @@ declare abstract class BaseProvider implements AIProviderInterface {
 declare function createProvider(config: ModelConfig): AIProviderInterface;
 
 /**
- * Anthropic provider implementation
+ * Anthropic provider implementation using official SDK
  */
 declare class AnthropicProvider extends BaseProvider {
-    protected getDefaultBaseUrl(): string;
+    private client;
+    constructor(config: any);
     generateText(request: GenerateTextRequest): Promise<GenerateTextResponse>;
     streamText(request: GenerateTextRequest): AsyncIterable<any>;
     generateObject<T>(request: GenerateObjectRequest<T>): Promise<GenerateObjectResponse<T>>;
@@ -867,10 +873,11 @@ declare class AnthropicProvider extends BaseProvider {
 }
 
 /**
- * OpenAI provider implementation
+ * OpenAI provider implementation using official SDK
  */
 declare class OpenAIProvider extends BaseProvider {
-    protected getDefaultBaseUrl(): string;
+    private client;
+    constructor(config: any);
     generateText(request: GenerateTextRequest): Promise<GenerateTextResponse>;
     streamText(request: GenerateTextRequest): AsyncIterable<any>;
     generateObject<T>(request: GenerateObjectRequest<T>): Promise<GenerateObjectResponse<T>>;
@@ -879,7 +886,7 @@ declare class OpenAIProvider extends BaseProvider {
 
 /**
  * Google AI (Gemini) provider implementation
- * Supports Google's Gemini models via their API
+ * Supports Google's Gemini models via their official SDK
  *
  * @example
  * ```typescript
@@ -891,7 +898,9 @@ declare class OpenAIProvider extends BaseProvider {
  * ```
  */
 declare class GoogleProvider extends BaseProvider {
-    protected getDefaultBaseUrl(): string;
+    private genAI;
+    private model;
+    constructor(config: any);
     /**
      * Format messages for Google's API format
      */
@@ -900,10 +909,39 @@ declare class GoogleProvider extends BaseProvider {
     streamText(request: GenerateTextRequest): AsyncIterable<any>;
     generateObject<T>(request: GenerateObjectRequest<T>): Promise<GenerateObjectResponse<T>>;
     streamObject<T>(request: GenerateObjectRequest<T>): AsyncIterable<any>;
+    private mapGoogleFinishReason;
+}
+
+/**
+ * Base provider for custom/URL-based implementations
+ * @module providers/custom
+ */
+
+/**
+ * Base provider class for custom URL-based providers
+ * Use this for providers without official SDKs (Sarvam, Custom, etc.)
+ */
+declare abstract class CustomBaseProvider extends BaseProvider {
     /**
-     * Map Google's finish reason to standard format
+     * Make HTTP request with proper error handling
      */
-    private mapGoogleFinishReason;
+    protected makeRequest(url: string, options: RequestInit, stream?: boolean): Promise<Response>;
+    /**
+     * Get API endpoint URL
+     */
+    protected getEndpoint(path: string): string;
+    /**
+     * Get default base URL for provider
+     */
+    protected abstract getDefaultBaseUrl(): string;
+    /**
+     * Parse streaming SSE response
+     */
+    protected parseSSEStream(response: Response): AsyncIterable<any>;
+    /**
+     * Build request body with common parameters
+     */
+    protected buildRequestBody(request: GenerateTextRequest, stream?: boolean): any;
 }
 
 /**
@@ -919,58 +957,34 @@ declare class GoogleProvider extends BaseProvider {
  * });
  * ```
  */
-declare class SarvamProvider extends BaseProvider {
+declare class SarvamProvider extends CustomBaseProvider {
     protected getDefaultBaseUrl(): string;
     generateText(request: GenerateTextRequest): Promise<GenerateTextResponse>;
     streamText(request: GenerateTextRequest): AsyncIterable<any>;
     generateObject<T>(request: GenerateObjectRequest<T>): Promise<GenerateObjectResponse<T>>;
     streamObject<T>(request: GenerateObjectRequest<T>): AsyncIterable<any>;
-    /**
-     * Map Sarvam's finish reason to standard format
-     */
-    private mapSarvamFinishReason;
+    private mapFinishReason;
 }
 
 /**
- * Custom provider implementation
- * Allows integration with any OpenAI-compatible API
+ * Custom provider for any OpenAI-compatible API
  *
  * @example
  * ```typescript
  * const provider = new CustomProvider({
  *   provider: 'custom',
- *   model: 'llama-3-70b',
- *   baseUrl: 'https://your-api.com/v1',
+ *   model: 'your-model',
  *   apiKey: process.env.CUSTOM_API_KEY,
+ *   baseUrl: 'https://your-api.com/v1',
  * });
  * ```
  */
-declare class CustomProvider extends BaseProvider {
+declare class CustomProvider extends CustomBaseProvider {
     protected getDefaultBaseUrl(): string;
-    /**
-     * Request format for custom provider
-     */
-    private requestFormat;
-    /**
-     * Set request format for custom provider
-     */
-    setRequestFormat(format: 'openai' | 'anthropic' | 'custom'): void;
     generateText(request: GenerateTextRequest): Promise<GenerateTextResponse>;
     streamText(request: GenerateTextRequest): AsyncIterable<any>;
     generateObject<T>(request: GenerateObjectRequest<T>): Promise<GenerateObjectResponse<T>>;
     streamObject<T>(request: GenerateObjectRequest<T>): AsyncIterable<any>;
-    /**
-     * Format request body based on provider format
-     */
-    private formatRequestBody;
-    /**
-     * Parse text response based on provider format
-     */
-    private parseTextResponse;
-    /**
-     * Parse streaming response
-     */
-    private parseStreamResponse;
 }
 
 /**