구성 API 문서

interface ConfigManager {
  // 구성 값 가져오기
  get<T>(key: string): T | undefined
  get<T>(key: string, defaultValue: T): T

  // 구성 값 설정
  set(key: string, value: any): void

  // 구성 항목 삭제
  delete(key: string): void

  // 구성 항목이 존재하는지 확인
  has(key: string): boolean

  // 모든 구성 가져오기
  getAll(): Record<string, any>

  // 구성 다시 로드
  reload(): Promise<void>

  // 구성을 파일에 저장
  save(): Promise<void>

  // 구성 변경 감시
  watch(key: string, callback: (value: any) => void): void

  // 구성 변경 감시 중지
  unwatch(key: string, callback?: (value: any) => void): void

  // 구성 검증
  validate(): ConfigValidationResult
}

// 구성 검증 규칙
const configSchema = {
  api: {
    key: {
      type: 'string',
      required: true,
      minLength: 10,
      pattern: /^[A-Za-z0-9_-]+$/
    },
    model: {
      type: 'string',
      enum: ['gemini-pro', 'gemini-pro-vision'],
      default: 'gemini-pro'
    },
    temperature: {
      type: 'number',
      min: 0,
      max: 1,
      default: 0.7
    }
  },
  session: {
    max_history: {
      type: 'number',
      min: 1,
      max: 1000,
      default: 100
    },
    storage_path: {
      type: 'string',
      required: true
    }
  }
}

// 구성 검증
function validateConfig(config: any): ConfigValidationResult {
  const errors: ConfigError[] = []

  // API 구성 검증
  if (!config.api?.key) {
    errors.push({
      path: 'api.key',
      message: 'API key is required'
    })
  }

  if (config.api?.temperature < 0 || config.api?.temperature > 1) {
    errors.push({
      path: 'api.temperature',
      message: 'Temperature must be between 0 and 1'
    })
  }

  return {
    isValid: errors.length === 0,
    errors
  }
}