zero-cost로 구축하는 API 문서 스펙 자동 분석 및 Zod 동적 검증 폼 플레이그라운드

너는 입력된 AI 모델의 API 레퍼런스 문서를 분석해 프론트엔드 동적 폼 생성용 메타데이터를 출력하는 오케스트레이터다. 마크다운 같은 부가 설명 없이 오직 아래 지정된 순수 JSON 포맷으로만 응답해라.

[요구사항]
1. 이미지 생성에 필요한 필수 옵션인 경우 required: true로 지정하고, 선택 옵션은 required: false로 지정해라.
2. 각 필드의 데이터 성격에 따라 type을 지정하되, 선택지가 고정된 경우 enum 타입과 options 배열을 제공해라.
3. type은 반드시 'string' | 'number' | 'boolean' | 'enum' 중 하나여야 한다.
4. description은 해당 필드에 대한 한글 설명을 명확하게 작성해라.

[출력 JSON 포맷]
{
  "fields": {
    "필드명": {
      "type": "string" | "number" | "boolean" | "enum",
      "required": true | false,
      "options": ["enum일 경우에만 가용한 문자열 배열 제공"],
      "description": "해당 필드에 대한 한글 설명"
    }
  }
}

// server/src/registry.ts 중 일부
public register(modelName: string, fields: Record<string, FieldMeta>): void {
  const zodShape: Record<string, any> = {};

  for (const [key, info] of Object.entries(fields)) {
    let baseType: any;

    switch (info.type) {
      case 'number':
        baseType = z.number({
          invalid_type_error: `${key} must be a number`,
          required_error: `${key} is required`
        });
        break;
      case 'boolean':
        baseType = z.boolean({
          invalid_type_error: `${key} must be a boolean`,
          required_error: `${key} is required`
        });
        break;
      case 'enum':
        if (info.options && info.options.length > 0) {
          const [first, ...rest] = info.options;
          baseType = z.enum([first, ...rest] as [string, ...string[]], {
            invalid_type_error: `${key} must be one of: ${info.options.join(', ')}`,
            required_error: `${key} is required`
          });
        } else {
          baseType = z.string({ required_error: `${key} is required` });
        }
        break;
      case 'string':
      default:
        baseType = z.string({
          invalid_type_error: `${key} must be a string`,
          required_error: `${key} is required`
        });
        if (info.required) {
          baseType = baseType.min(1, { message: `${key} is required` });
        }
        break;
    }

    zodShape[key] = info.required 
      ? baseType 
      : baseType.optional().nullable();
  }

  this.registry[modelName] = {
    schema: z.object(zodShape),
    meta: fields
  };
}