Export getOpenAPIMetadata and setOpenAPIMetadata

[bagbyte]

Those 2 methods can be useful to create custom decorators and enrich existing spec

[epiphone]

Thanks! Was there a specific use case you had in mind that requires these methods? I'm curious if it could be achieved using one of the already exposed extension points. Did you try passing a function to OpenAPI as in the 2nd example here #21 (comment) ?

[bagbyte]

@epiphone

I would like to create my own decorator, i.e. @Authorization defined as:

function Authorization(roleOrRoles?: any | any[]): Function {
  ...
  return function(clsOrObject: Function | Object, method?: string) {
    // Adding validation
    getMetadataArgsStorage().responseHandlers.push({
      type: 'authorized',
      target: method ? clsOrObject.constructor : (clsOrObject as Function),
      method: method,
      value: roles,
    });

    // Adding documentation
    const spec = { security: [{ AccessToken: roles.map(r => `ROLE_${AuthUserRole.role(r)}`) }] };

    if (method) {
      setOpenAPIMetadata([spec, ...getOpenAPIMetadata(clsOrObject, method)], clsOrObject, method);
    } else {
      setOpenAPIMetadata([spec, ...getOpenAPIMetadata(clsOrObject)], clsOrObject);
    }
  }
}

[epiphone]

Alright, published in v2.2.0. Let's leave this undocumented for now.