Change response types to ensure proper status and headers are set

[luqasn]

Hi Henrik,

thanks again for your great library!

One thing that was bothering me when working with it was that I kept forgetting to set the correct content type for the responses and then diligent tools (like when using supertest I think) said "what body? there is no json here!".

So I thought "can't be too hard to fix this, we have the complete api definition!". Turns out my TypeScript foo is not as great as I hoped, so I employed ChatGPTs help for figuring out the correct shapes. It was a give and take though, as I manually had to fix a couple things.

So the type system now makes you return the complete response (statusCode, body, content-type), not only the body. And the type system enforces that those match the api definition.

Would love to get your thoughts on this experiment! It does make things a bit stiffer, but I think with the json helper I introduced it should not be much more verbose in most common api usecases.

[luqasn]

I would also be interested in your thoughts, @alabs-tomscholz

[henhal]

Perhaps stay consistent with naming OpName OperationId instead?

[henhal]

Matter of style, but personally I prefer to name keys in mapped types P or K or similar to make it clear, but no big deal.
I would perhaps also consider extracting a type alias such as:

type OperationResponseMap<OperationId extends keyof operations> = operations[OperationId]['responses'];

... to also make it clearer since this is duplicated several times.

[henhal]

why should the test script implicitly compile? Not that it hurts, but seems a bit unnecessary. Or at least move it to pretest?

(Or is ts-jest not used so jest runs on the transpiled files? Too long since I worked on this so I don't remember. If so perhaps a better solution is to fix the jest setup?)

[luqasn]

I added it because the tests would also pass when there were typescript errors between the handler implemented in the test and the generated code. But you are right in that calling tsc here manually seems random and like a crutch.