OpenAPI annotation support for DTO types

[thejhh]

Our DTOs are currently just pure TypeScript interfaces.

This is simple approach, but makes it quite hard to automatically detect the type of the DTO for example automatically documenting using the OpenAPI.

We should investigate ways to fix this issue. Maybe we should implement class based approach to write DTO classes? Then, those classes could use annotations which could document the DTO using OpenAPI.