OpenAPI schema out of date

[zregvart]

Description of Problem / Feature Request

I've noticed that the current published OpenAPI document is out of date. The SourcePackage's property source is declared as string, whereas in the claircore it is Package via recursive declaration of Package.

When I try to validate the Clair clair formatted report produced by clair-action with the JSON Schema generated using https://github.com/grantila/typeconv/, e.g. npx typeconv -f oapi -t jsc openapi.yaml, I get a schema violation like:

packages.02FzDBS76jWKACvjeaEWyg==.source.source: Invalid type. Expected: string, given: object

Expected Outcome

The OpenAPI schema should reflect the report generated from Clair.

Actual Outcome

See the description above

Environment

Using clair-action 0.0.10.

[crozzy]

I think the correct way to go is something like this where the Package refers to itself, this was an issue for a long time in the swagger UI but appears to have be fixed: swagger-api/swagger-ui#3325