@umituz/react-native-ai-groq-provider 1.0.0

package/src/providers/ConfigBuilder.ts

@@ -0,0 +1,159 @@
+/**
+ * Configuration Builder
+ * Builder pattern for Groq configuration
+ */
+
+import type { GroqConfig, GroqGenerationConfig } from "../domain/entities";
+import { DEFAULT_MODELS } from "../domain/entities";
+
+/**
+ * Builder for Groq configuration
+ */
+export class ConfigBuilder {
+  private config: Partial<GroqConfig> = {};
+
+  /**
+   * Set API key
+   */
+  withApiKey(apiKey: string): ConfigBuilder {
+    this.config.apiKey = apiKey;
+    return this;
+  }
+
+  /**
+   * Set base URL
+   */
+  withBaseUrl(baseUrl: string): ConfigBuilder {
+    this.config.baseUrl = baseUrl;
+    return this;
+  }
+
+  /**
+   * Set timeout
+   */
+  withTimeout(timeoutMs: number): ConfigBuilder {
+    this.config.timeoutMs = timeoutMs;
+    return this;
+  }
+
+  /**
+   * Set default text model
+   */
+  withTextModel(model: string): ConfigBuilder {
+    this.config.textModel = model;
+    return this;
+  }
+
+  /**
+   * Build configuration
+   */
+  build(): GroqConfig {
+    if (!this.config.apiKey) {
+      throw new Error("API key is required. Use withApiKey() to set it.");
+    }
+
+    return {
+      apiKey: this.config.apiKey,
+      baseUrl: this.config.baseUrl,
+      timeoutMs: this.config.timeoutMs,
+      textModel: this.config.textModel || DEFAULT_MODELS.TEXT,
+    };
+  }
+
+  /**
+   * Create a new builder instance
+   */
+  static create(): ConfigBuilder {
+    return new ConfigBuilder();
+  }
+}
+
+/**
+ * Builder for generation configuration
+ */
+export class GenerationConfigBuilder {
+  private config: GroqGenerationConfig = {};
+
+  /**
+   * Set temperature
+   */
+  withTemperature(temperature: number): GenerationConfigBuilder {
+    this.config.temperature = temperature;
+    return this;
+  }
+
+  /**
+   * Set max tokens
+   */
+  withMaxTokens(maxTokens: number): GenerationConfigBuilder {
+    this.config.maxTokens = maxTokens;
+    return this;
+  }
+
+  /**
+   * Set top P
+   */
+  withTopP(topP: number): GenerationConfigBuilder {
+    this.config.topP = topP;
+    return this;
+  }
+
+  /**
+   * Set frequency penalty
+   */
+  withFrequencyPenalty(penalty: number): GenerationConfigBuilder {
+    this.config.frequencyPenalty = penalty;
+    return this;
+  }
+
+  /**
+   * Set presence penalty
+   */
+  withPresencePenalty(penalty: number): GenerationConfigBuilder {
+    this.config.presencePenalty = penalty;
+    return this;
+  }
+
+  /**
+   * Set stop sequences
+   */
+  withStop(stop: string[]): GenerationConfigBuilder {
+    this.config.stop = stop;
+    return this;
+  }
+
+  /**
+   * Build configuration
+   */
+  build(): GroqGenerationConfig {
+    return { ...this.config };
+  }
+
+  /**
+   * Create a new builder instance
+   */
+  static create(): GenerationConfigBuilder {
+    return new GenerationConfigBuilder();
+  }
+
+  /**
+   * Create a balanced configuration
+   */
+  static balanced(): GenerationConfigBuilder {
+    return new GenerationConfigBuilder().withTemperature(0.7);
+  }
+
+  /**
+   * Create a creative configuration
+   */
+  static creative(): GenerationConfigBuilder {
+    return new GenerationConfigBuilder().withTemperature(1.0);
+  }
+
+  /**
+   * Create a precise configuration
+   */
+  static precise(): GenerationConfigBuilder {
+    return new GenerationConfigBuilder().withTemperature(0.3);
+  }
+}

package/src/providers/ProviderFactory.ts

@@ -0,0 +1,98 @@
+/**
+ * Provider Factory
+ * Factory for creating configured Groq provider instances
+ */
+
+import type { GroqConfig, GroqGenerationConfig } from "../domain/entities";
+import { groqHttpClient } from "../infrastructure/services/GroqClient";
+import { ConfigBuilder, GenerationConfigBuilder } from "./ConfigBuilder";
+
+/**
+ * Provider configuration options
+ */
+export interface ProviderConfig {
+  apiKey: string;
+  baseUrl?: string;
+  timeoutMs?: number;
+  defaultModel?: string;
+}
+
+/**
+ * Provider factory options
+ */
+export interface ProviderFactoryOptions {
+  enableTelemetry?: boolean;
+  onError?: (error: Error) => void;
+}
+
+/**
+ * Initialize Groq provider with configuration
+ */
+export function initializeProvider(config: ProviderConfig): void {
+  groqHttpClient.initialize({
+    apiKey: config.apiKey,
+    baseUrl: config.baseUrl,
+    timeoutMs: config.timeoutMs,
+    textModel: config.defaultModel,
+  });
+}
+
+/**
+ * Provider factory - creates configured provider instances
+ */
+export const providerFactory = {
+  /**
+   * Create a new provider instance
+   */
+  create(config: ProviderConfig): void {
+    initializeProvider(config);
+  },
+
+  /**
+   * Create provider from environment variables
+   */
+  fromEnv(): void {
+    const apiKey = process.env.GROQ_API_KEY;
+
+    if (!apiKey) {
+      throw new Error("GROQ_API_KEY environment variable is not set");
+    }
+
+    initializeProvider({
+      apiKey,
+      baseUrl: process.env.GROQ_BASE_URL,
+      timeoutMs: process.env.GROQ_TIMEOUT_MS ? parseInt(process.env.GROQ_TIMEOUT_MS) : undefined,
+    });
+  },
+
+  /**
+   * Reset provider (clear configuration)
+   */
+  reset(): void {
+    groqHttpClient.reset();
+  },
+
+  /**
+   * Check if provider is initialized
+   */
+  isInitialized(): boolean {
+    return groqHttpClient.isInitialized();
+  },
+};
+
+/**
+ * Convenience function to initialize provider
+ */
+export function configureProvider(config: ProviderConfig): void {
+  providerFactory.create(config);
+}
+
+/**
+ * Convenience function to reset provider
+ */
+export function resetProvider(): void {
+  providerFactory.reset();
+}
+
+// Re-export builders
+export { ConfigBuilder, GenerationConfigBuilder };

package/src/providers/index.ts

@@ -0,0 +1,16 @@
+/**
+ * Providers
+ */
+
+export { ConfigBuilder, GenerationConfigBuilder } from "./ConfigBuilder";
+export {
+  providerFactory,
+  initializeProvider,
+  configureProvider,
+  resetProvider,
+} from "./ProviderFactory";
+
+export type {
+  ProviderConfig,
+  ProviderFactoryOptions,
+} from "./ProviderFactory";