/**
 * API 高频响应 schema 注册表（Task 27）。
 *
 * 为 task/result 核心响应与各业务模块注册字段 schema，供
 * createApiFieldCompatChecker 在契约测试与联调前做字段漂移检查。
 * 模块级 schema 目前复用 task+result 组合，后续某模块有独特字段时
 * 在其定义内覆盖/追加即可，无需改动检查器。
 */
import { createApiFieldCompatChecker, type ApiFieldSpec } from './api-field-compat.ts'

export interface ApiFieldSchemaDef {
  /** schema 版本号，变更时递增 */
  version: number
  /** 字段名 → 规格 */
  schema: Record<string, ApiFieldSpec>
}

/** task 核心响应字段 */
export const taskCoreSchema: Record<string, ApiFieldSpec> = {
  taskId: { type: 'number', required: true },
  status: { type: 'string', required: true },
  progress: { type: 'number' },
  message: { type: 'string' },
  resultId: { type: 'number' },
}

/** 结果文件阶段字段（与 ResultFilePhase 对应，全部可选） */
export const resultFileSchema: Record<string, ApiFieldSpec> = {
  fileStatus: { type: 'string' },
  fileReady: { type: 'boolean' },
  fileProgress: { type: 'number' },
  fileProgressLabel: { type: 'string' },
  fileProgressStage: { type: 'string' },
  downloadUrl: { type: 'string' },
  freshDownloadUrl: { type: 'string' },
}

/** task + result 组合 schema */
export const taskWithResultSchema: Record<string, ApiFieldSpec> = {
  ...taskCoreSchema,
  ...resultFileSchema,
}

const BUSINESS_MODULES = [
  'dedupe', 'split', 'convert', 'publish', 'similar-asin', 'appearance-patent',
  'delete-brand', 'price-track', 'shop-match', 'query-asin', 'withdraw',
  'collect-data', 'image-video',
] as const

export const apiFieldSchemas: Record<string, ApiFieldSchemaDef> = {
  task: { version: 1, schema: taskCoreSchema },
  result: { version: 1, schema: resultFileSchema },
  'task-result': { version: 1, schema: taskWithResultSchema },
}

for (const module of BUSINESS_MODULES) {
  apiFieldSchemas[module] = { version: 1, schema: taskWithResultSchema }
}

export function getApiFieldSchema(name: string): ApiFieldSchemaDef | null {
  return apiFieldSchemas[name] ?? null
}

export function createModuleFieldChecker(module: string) {
  const def = getApiFieldSchema(module)
  if (!def) {
    throw new Error(`未注册的模块: ${module}`)
  }
  return createApiFieldCompatChecker({ schema: def.schema })
}