undefined type yields unknown - can it yield never instead?

[hesxenon]

Sometimes specs aren't properly written and e.g.

      parameters:
        - in: query
          name: foo
          schema:
            type: array
            description: foos

transforms to
unknown[] - which allows to pass any items. I think it would be better if that was typed as never[], so that we could notice such errors.

Is there already a way to achieve this or should I open an issue?

[drwpow]

Yeah that’s a good suggestion! I would support adding this as a flag, perhaps. This is an opinionated take—we get requests from so many people both asking openapi-typescript to be more flexible in generated types, and people like yourself that request more strictness. We generally try and err on the side of strictness, but never[] may be a little too restrictive for some folks as default behavior.

For things like this, I can’t recommend Redocly’s linting API enough—it can improve quality and consistency of OpenAPI schemas far better than openapi-typescript can. Agree that often people can find ways to improve their schemas when the generated types turn out to be different than expected, but linting is a way to shorten the feedback loop and catch other issues as well.

[hesxenon]

true, and a good enough solution for my use case, thx for answering :)