Support deprecating records

[bmeesters]

OpenAPI supports the possibility to deprecate a record by simply adding a field:

            "transportEquipment": {
                "deprecated": true,
                "example": {
                    "description": "Europallet with boxes of bananas",
                    "quantity": 3,
                    "loadMeters": {
                        "value": 3,
                        "unit": "m"
                    }
                },

As far as I know this is currently not possible in endpoints4s. It would be great if we add a method deprecateRecord to the JsonSchemas algebra. This method would simply return the same record in the json interpreters, but would tag the record in the OpenAPI interpreter as deprecated.

[bmeesters]

I would also like to deprecate variants of oneOf:

You can get this behavior by marking the type deprecated (which is not completely the same thing, but closest to what I would like to see)

[bmeesters]

Hey @julienrf, I see you gave a thumpsup. So, I can make a PR and you can make some time for the review (not in a hurry though, so if the timing is bad it can wait for a bit)?

[julienrf]

Yes, feel free to go ahead!