import type { Manifest, Solution } from './manifest.js'

export type SolutionContext<TSolutionConfig> = {
  solutionUsage: Solution
  solutionDefinition: SolutionDefinition<TSolutionConfig>
  glob: (pattern: string) => string[]
  readStringFile: (relativePath: string) => Promise<string>
  writeStringFile: (relativePath: string, content: string) => Promise<void>
  readYamlFile: <T = Record<string, any>>(relativePath: string) => Promise<T>
  writeYamlFile: <T = Record<string, any>>(
    relativePath: string,
    data: T,
  ) => Promise<void>
  copyDir: (from: string, to: string) => Promise<void>
  runCommand: (command: string, argv: string[]) => Promise<void>
  addEntrypoint: (entrypoint: string) => string
  importModule: <T = any>(modulePath: string) => Promise<T>
}

export type SolutionScriptFunction = {
  run: <TParams = Record<string, any>>(params: TParams) => Promise<void>
  description?: string
  parameters?: {
    [key: string]: {
      type: 'string' | 'number' | 'boolean' | 'json' | 'enum'
      examples?: string[]
      acceptedValues?: any[]
      description?: string
      required?: boolean
    }
  }
}

export type Hook = {
  for: 'pre-deploy' | 'post-deploy' | 'pre-backfill' | 'post-backfill'
  id: string
  title: string
  run: <
    TParams = {
      autoApprove?: boolean
    },
  >(
    parameters?: TParams,
  ) => Promise<void>
}

export type SolutionDefinition<TSolutionConfig = Record<string, any>> = {
  prepareManifest?: (
    context: SolutionContext<TSolutionConfig>,
    config: TSolutionConfig,
    manifest: Manifest,
  ) => Promise<Manifest>
  registerScripts?: (
    context: SolutionContext<TSolutionConfig>,
    config: TSolutionConfig,
    manifest: Manifest,
  ) => Record<string, SolutionScriptFunction>
  registerHooks?: (
    context: SolutionContext<TSolutionConfig>,
    config: TSolutionConfig,
    manifest: Manifest,
  ) => Promise<Hook[]>
}