How to force using JSONSchema decorator from parent? about class-validator-jsonschema

[juiceo]

I know there's this section in the docs:

Alternatively JSONSchema can take a function of type (existingSchema: SchemaObject, options: IOptions) => SchemaObject. The return value of this function is then not automatically merged into existing schema (i.e. the one derived from class-validator decorators). Instead you can handle merging yourself in whichever way is preferred, the idea being that removal of existing keywords and other more complex overwrite scenarios can be implemented here.

However I'm a bit lost regarding how to actually use this, if you can help at all. Would be great to have a code example of this functionality in the docs as well.

[epiphone]

The example you posted doesn't contain any inheritance so the problem probably lies somewhere else.

Can you post the exact JSON Schema you're getting in your use case? My guess is that in your example case we end up with a Product schema of something like

{
  "properties": {
    "name": {
      "$ref": "<ref to LocalizedString schema>",
      "description": "The name of the product and its translations."
    }
  }
}

And since earlier JSON Schema drafts ignore all other than $ref properties in a reference schema (source), description gets dropped.

OpenAPI's reference objects likewise cannot be extended with additional properties and any properties added SHALL be ignored. https://swagger.io/specification/#reference-object

If that's the case, the solution is to either try some of the creative workarounds mentioned here https://stackoverflow.com/questions/33565090/json-schema-property-description-and-ref-usage or to introduce some sort of complex duplication logic into the library. Or we could wait for OpenAPI v3.1.0 which will finally support the latest JSON Schema draft in its entirety 🙂