@libredb/studio 0.9.7 → 0.9.13

package/dist/chunk-FYSE52VB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/llm/utils/retry.ts","../src/lib/llm/base-provider.ts","../src/lib/llm/utils/streaming.ts"],"names":["isRetryableError","LLMError","validateConfig","__spreadValues","getSafeConfigForLogging","LLMConfigError","logger","__forAwait","error","LLMStreamError"],"mappings":"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","file":"chunk-FYSE52VB.js","sourcesContent":["/**\n * Retry Utility with Exponential Backoff\n * Handles transient failures in LLM API calls\n */\n\nimport { isRetryableError, LLMError, type LLMProviderType } from '../types';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface RetryOptions {\n  /** Maximum number of retry attempts (default: 3) */\n  maxAttempts?: number;\n  /** Initial delay in milliseconds (default: 1000) */\n  initialDelay?: number;\n  /** Backoff multiplier (default: 2) */\n  backoffMultiplier?: number;\n  /** Maximum delay in milliseconds (default: 10000) */\n  maxDelay?: number;\n  /** Provider name for logging */\n  provider?: LLMProviderType;\n  /** Operation name for logging */\n  operation?: string;\n}\n\n// ============================================================================\n// Default Configuration\n// ============================================================================\n\nconst DEFAULT_MAX_ATTEMPTS = 3;\nconst DEFAULT_INITIAL_DELAY = 1000;\nconst DEFAULT_BACKOFF_MULTIPLIER = 2;\nconst DEFAULT_MAX_DELAY = 10000;\n\n// ============================================================================\n// Retry Implementation\n// ============================================================================\n\n/**\n * Execute a function with retry logic and exponential backoff\n * @param fn - Async function to execute\n * @param options - Retry configuration\n * @returns Result of the function\n * @throws Last error if all retries fail\n */\nexport async function withRetry<T>(\n  fn: () => Promise<T>,\n  options: RetryOptions = {}\n): Promise<T> {\n  const {\n    maxAttempts = DEFAULT_MAX_ATTEMPTS,\n    initialDelay = DEFAULT_INITIAL_DELAY,\n    backoffMultiplier = DEFAULT_BACKOFF_MULTIPLIER,\n    maxDelay = DEFAULT_MAX_DELAY,\n    provider,\n    operation = 'LLM request',\n  } = options;\n\n  let lastError: Error | undefined;\n  let delay = initialDelay;\n\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      lastError = error instanceof Error ? error : new Error(String(error));\n\n      // Check if error is retryable\n      if (!isRetryableError(error)) {\n        throw error;\n      }\n\n      // Don't retry on last attempt\n      if (attempt === maxAttempts) {\n        break;\n      }\n\n      // Log retry attempt\n      console.error(\n        `[LLM${provider ? `:${provider}` : ''}] ${operation} failed (attempt ${attempt}/${maxAttempts}): ${lastError.message}. Retrying in ${delay}ms...`\n      );\n\n      // Wait before retrying\n      await sleep(delay);\n\n      // Increase delay with exponential backoff\n      delay = Math.min(delay * backoffMultiplier, maxDelay);\n    }\n  }\n\n  // All retries exhausted\n  console.error(\n    `[LLM${provider ? `:${provider}` : ''}] ${operation} failed after ${maxAttempts} attempts: ${lastError?.message}`\n  );\n\n  throw lastError ?? new LLMError('Unknown error during retry', provider);\n}\n\n/**\n * Sleep for a specified duration\n */\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n// ============================================================================\n// Retry Decorators (for class methods)\n// ============================================================================\n\n/**\n * Create a retryable version of an async function\n */\nexport function makeRetryable<T extends unknown[], R>(\n  fn: (...args: T) => Promise<R>,\n  options: RetryOptions = {}\n): (...args: T) => Promise<R> {\n  return (...args: T) => withRetry(() => fn(...args), options);\n}\n","/**\n * Base LLM Provider\n * Abstract class implementing common provider functionality\n */\n\nimport {\n  type LLMConfig,\n  type LLMProvider,\n  type LLMProviderType,\n  type LLMStreamOptions,\n  LLMConfigError,\n} from './types';\nimport { validateConfig, getSafeConfigForLogging } from './utils/config';\nimport { withRetry, type RetryOptions } from './utils/retry';\n\n// ============================================================================\n// Base Provider Class\n// ============================================================================\n\nexport abstract class BaseLLMProvider implements LLMProvider {\n  public readonly name: LLMProviderType;\n  public readonly config: LLMConfig;\n\n  protected constructor(config: LLMConfig) {\n    this.name = config.provider;\n    this.config = config;\n  }\n\n  /**\n   * Validate provider configuration\n   * Can be overridden by subclasses for provider-specific validation\n   */\n  public validate(): void {\n    validateConfig(this.config);\n  }\n\n  /**\n   * Stream completion - must be implemented by subclasses\n   */\n  public abstract stream(options: LLMStreamOptions): Promise<ReadableStream<Uint8Array>>;\n\n  /**\n   * Execute stream with retry logic\n   */\n  protected async streamWithRetry(\n    streamFn: () => Promise<ReadableStream<Uint8Array>>,\n    retryOptions?: RetryOptions\n  ): Promise<ReadableStream<Uint8Array>> {\n    return withRetry(streamFn, {\n      provider: this.name,\n      operation: 'stream',\n      ...retryOptions,\n    });\n  }\n\n  /**\n   * Get the model to use (from options or config)\n   */\n  protected getModel(options: LLMStreamOptions): string {\n    return options.model ?? this.config.model;\n  }\n\n  /**\n   * Build system message from messages array\n   */\n  protected getSystemMessage(options: LLMStreamOptions): string | undefined {\n    const systemMessage = options.messages.find((m) => m.role === 'system');\n    return systemMessage?.content;\n  }\n\n  /**\n   * Build user/assistant messages (excluding system)\n   */\n  protected getNonSystemMessages(options: LLMStreamOptions): Array<{ role: 'user' | 'assistant'; content: string }> {\n    return options.messages\n      .filter((m) => m.role !== 'system')\n      .map((m) => ({\n        role: m.role as 'user' | 'assistant',\n        content: m.content,\n      }));\n  }\n\n  /**\n   * Log error with safe config\n   */\n  protected logError(operation: string, error: unknown): void {\n    const safeConfig = getSafeConfigForLogging(this.config);\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    console.error(`[LLM:${this.name}] ${operation} failed:`, errorMessage, safeConfig);\n  }\n\n  /**\n   * Ensure API key is available\n   */\n  protected ensureApiKey(): string {\n    if (!this.config.apiKey) {\n      throw new LLMConfigError(\n        `API key is required for ${this.name} provider`,\n        this.name\n      );\n    }\n    return this.config.apiKey;\n  }\n\n  /**\n   * Ensure API URL is available\n   */\n  protected ensureApiUrl(): string {\n    if (!this.config.apiUrl) {\n      throw new LLMConfigError(\n        `API URL is required for ${this.name} provider`,\n        this.name\n      );\n    }\n    return this.config.apiUrl;\n  }\n}\n","/**\n * Streaming Utilities for LLM Providers\n * SSE parsing and stream transformation helpers\n */\n\nimport { LLMStreamError, type LLMProviderType } from '../types';\nimport { logger } from '@/lib/logger';\n\n// ============================================================================\n// Text Encoding/Decoding\n// ============================================================================\n\nconst textEncoder = new TextEncoder();\nconst textDecoder = new TextDecoder();\n\nexport function encodeText(text: string): Uint8Array {\n  return textEncoder.encode(text);\n}\n\nexport function decodeText(bytes: Uint8Array): string {\n  return textDecoder.decode(bytes);\n}\n\n// ============================================================================\n// SSE (Server-Sent Events) Parser\n// ============================================================================\n\nexport interface SSEChunk {\n  data: string;\n  event?: string;\n  id?: string;\n}\n\n/**\n * Parse SSE formatted response for OpenAI-compatible APIs\n * Handles chunked responses and extracts content from delta objects\n */\nexport function createSSEParser(): TransformStream<Uint8Array, Uint8Array> {\n  let buffer = '';\n\n  return new TransformStream<Uint8Array, Uint8Array>({\n    transform(chunk, controller) {\n      buffer += decodeText(chunk);\n\n      // Process complete lines\n      const lines = buffer.split('\\n');\n      buffer = lines.pop() ?? ''; // Keep incomplete line in buffer\n\n      for (const line of lines) {\n        const trimmed = line.trim();\n\n        // Skip empty lines and comments\n        if (!trimmed || trimmed.startsWith(':')) {\n          continue;\n        }\n\n        // Handle data lines\n        if (trimmed.startsWith('data: ')) {\n          const data = trimmed.slice(6);\n\n          // Handle stream end marker\n          if (data === '[DONE]') {\n            return;\n          }\n\n          try {\n            const parsed = JSON.parse(data);\n            const content = extractContent(parsed);\n\n            if (content) {\n              controller.enqueue(encodeText(content));\n            }\n          } catch {\n            logger.debug('Skipping malformed JSON chunk in SSE stream');\n          }\n        }\n      }\n    },\n\n    flush(controller) {\n      // Process any remaining data in buffer\n      if (buffer.trim()) {\n        const trimmed = buffer.trim();\n        if (trimmed.startsWith('data: ') && trimmed.slice(6) !== '[DONE]') {\n          try {\n            const parsed = JSON.parse(trimmed.slice(6));\n            const content = extractContent(parsed);\n            if (content) {\n              controller.enqueue(encodeText(content));\n            }\n          } catch {\n            logger.debug('Skipping malformed JSON chunk in SSE stream flush');\n          }\n        }\n      }\n    },\n  });\n}\n\n/**\n * Extract content from parsed SSE data based on provider format\n */\nfunction extractContent(data: unknown): string | null {\n  if (!data || typeof data !== 'object') {\n    return null;\n  }\n\n  const obj = data as Record<string, unknown>;\n\n  // OpenAI format: choices[0].delta.content\n  if (Array.isArray(obj.choices) && obj.choices.length > 0) {\n    const choice = obj.choices[0] as Record<string, unknown>;\n    const delta = choice.delta as Record<string, unknown> | undefined;\n\n    if (delta && typeof delta.content === 'string') {\n      return delta.content;\n    }\n  }\n\n  return null;\n}\n\n// ============================================================================\n// Stream Utilities\n// ============================================================================\n\n/**\n * Create a ReadableStream from an async iterable\n */\nexport function streamFromAsyncIterable<T>(\n  iterable: AsyncIterable<T>,\n  transform: (item: T) => Uint8Array | null\n): ReadableStream<Uint8Array> {\n  return new ReadableStream<Uint8Array>({\n    async start(controller) {\n      try {\n        for await (const item of iterable) {\n          const chunk = transform(item);\n          if (chunk) {\n            controller.enqueue(chunk);\n          }\n        }\n        controller.close();\n      } catch (error) {\n        controller.error(error);\n      }\n    },\n  });\n}\n\n/**\n * Create a ReadableStream from a fetch Response with SSE parsing\n */\nexport function createStreamFromSSEResponse(\n  response: Response,\n  provider: LLMProviderType\n): ReadableStream<Uint8Array> {\n  const body = response.body;\n\n  if (!body) {\n    throw new LLMStreamError('Response body is empty', provider);\n  }\n\n  return body.pipeThrough(createSSEParser());\n}\n\n/**\n * Merge multiple streams into one (useful for multi-part responses)\n */\nexport function mergeStreams(\n  streams: ReadableStream<Uint8Array>[]\n): ReadableStream<Uint8Array> {\n  return new ReadableStream<Uint8Array>({\n    async start(controller) {\n      for (const stream of streams) {\n        const reader = stream.getReader();\n        try {\n          while (true) {\n            const { done, value } = await reader.read();\n            if (done) break;\n            controller.enqueue(value);\n          }\n        } finally {\n          reader.releaseLock();\n        }\n      }\n      controller.close();\n    },\n  });\n}\n\n/**\n * Create an error stream that emits a single error message\n */\nexport function createErrorStream(message: string): ReadableStream<Uint8Array> {\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      controller.enqueue(encodeText(`Error: ${message}`));\n      controller.close();\n    },\n  });\n}\n"]}