Introduce the following helpers:

• getModelSchemaRef returning OpenAPI spec
• getJsonSchemaRef returning JSON Schema

Example usage in controllers:

class MyController {
  @get('/my', {
    responses: {
      '200': {
        description: 'Array of MyModel model instances',
        content: {
          'application/json': {
            schema: getModelSchemaRef(MyModel),
          },
        },
      },
    },
  })
  async find(): Promise<MyModel[]> {
    // etc.
  }
}

Resolve #2631.

See also #1352, #2652 and #2653.

Checklist

👉 Read and sign the CLA (Contributor License Agreement) 👈

• npm test passes on your machine
• New tests added or existing tests modified to cover all changes
• Code conforms with the style guide
• API Documentation in code was updated
• Documentation in /docs/site was updated
• Affected artifact templates in packages/cli were updated
• Affected example projects in examples/* were updated

👉 Check out how to submit a PR 👈