Copy for AI

operationToAiText(endpoint) is een pure functie (geen I/O, geen React) die een genormaliseerd endpoint omzet naar het tekstblok achter de Copy for AI-knop.

operationToAiText

Gedefinieerd in src/transformers/copy-for-ai.ts. Outputstructuur: Purpose → Request → Responses → Error Responses → Validation.

Edge cases

Edge cases worden expliciet afgehandeld in plaats van geraden:

  • Geen requestBody → geen Request-sectie.
  • Geen 4xx/5xx gedeclareerd → geen Error Responses-sectie.
  • oneOf/anyOf-schema's → geannoteerd als (one of N possible shapes) in plaats van willekeurig één te kiezen.
  • Schema zonder beperkingen → geen Validation-sectie.
  • Lange beschrijving zonder summary → afgekapt tot twee zinnen in Purpose.

Performance en cycli

Generatie blijft consequent ruim onder 100ms (er verschijnt geen spinner), en recursieve/circulaire DTO's worden veilig afgehandeld.