2021.09 improvements

[gkama]

General improvements

kamafi.core.data

• Add Roles to Constants.cs. Admin, etc.
• To camel case extension method. public static string ToCamelCase(this string s) (Source kamafi-liability)
• Remove white spaces extension method. public static string RemoveWhitespace(this string s) (Source kamafi-liability)
• Add FluentValidation camel case resolved CamelCasePropertyNameResolver (Source kamafi-liability)

kamafi.core.middleware

Improvements for the middleware package

OpenApi

• Add support to take in string[] ApiSupportedVersions. Example is as follows

public static string[] ApiSupportedVersions
    => new string[]
    {
        "v1.0"
    };

• Add support to take in optional DefaultUnsupportedApiVersionMessage

Example of a message

public static string DefaultUnsupportedApiVersionMessage = $"Unsupported API version specified. The supported versions are {string.Join(", ", ApiSupportedVersions)}";

This (DefaultUnsupportedApiVersionMessage) needs to be replaced in the following middleware (which is being called by the Versioning one)

public class ApiVersioningErrorResponseProvider : DefaultErrorResponseProvider
{
    public override IActionResult CreateResponse(ErrorResponseContext context)
    {
        var problem = new KamafiProblemDetailBase
        {
            Code = StatusCodes.Status400BadRequest,
            Message = Constants.DefaultUnsupportedApiVersionMessage
        };

        return new ObjectResult(problem)
        {
            StatusCode = StatusCodes.Status400BadRequest
        };
    }
}

The solution would be to add more optional configuration in KamafiConfiguration object. Then pass down the configuration to the ApiVersioningErrorResponseProvider. The message will be inherited from the ApiSupportedVersions string array

public class KamafiConfiguration : IKamafiConfiguration
{
    public IConfiguration Config { get; set; }
    public string OpenApiName { get; set; }
    public string OpenApiVersion { get; set; }
    public string DefaultApiVersion { get; set; }
    public string XmlCommentsPath { get; set; }

    // Something along the lines of
    public string[] ApiSupportedVersions { get; set; } = null;
}

Eventing

• Rename AddEventingRestClient to AddKamafiEventingRestClient