Support ability to include Tags in the OpenAPI spec generation

[denniswieczorek]

Problem

As far as I can tell, it is not currently possible to create operations in a way so that they can be grouped in the generated OpenAPI spec.

Suggested solution

Use Tags

OpenAPI's Operation Object supports the concept of tags to organize operations.

From the docs:

A list of tags for API documentation control. 
Tags can be used for logical grouping of operations by resources or any other qualifier.

Implementation

An optional tags parameter on createOperation.query, createOperation.mutation, createOperation.subscribe that is consumed in the OpenApiBuilder to add tags to the generated spec.

e.g.

// foo/bar.ts
export default createOperation.query({
  input,
  tags: ['Foo'],
  handler: () => {...},
})

Would produce something like

...
"paths": {
    "/foo/bar": {
      "get": {
        "tags": ["Foo"],
        "operationId": "...",
        "parameters": [...],
        "responses": {...},
      },
    },
...

Alternatives

None that I can think of.

Additional context

[acdn-tsmith]

PR: #1382