Extract serialization from Middleware into Serializer object about saunter

[bbattah]

Agreed. I have just begun playing with Saunter and ran into the same challenge.

Ideally I would like to easily include a "Swashbuckle" style endpoint with an HTML UI.
However, in the mean-time I can settle for generating a static html file I can commit with the application source.

En-route to this I am writing test code that uses Saunter to scan a specific assembly for relevant message formats and plug them into a "Skeleton" AsyncApiDocument. Then the json\yaml must be serialized in order to feed the standard generator with html template.

I had to lift exactly the same code as above into my own project to get this close to working.
Additionally, the serialization needs to ensure proper lower-casing of the serialized asyncapi.json document AND ensure that the asyncapi attribute is tagged with a proper version value.
Relevant code snippets here:

private static void ConvertToHtml(AsyncApiDocument doc)
        {
            string json = AsyncApiDocToString(doc);

            File.WriteAllText("asyncapi.json", json);

            using (Process compiler = new Process())
            {
                compiler.StartInfo.FileName = "ag";
                compiler.StartInfo.Arguments = $" asyncapi.json @asyncapi/html-template -o output --force-write --param singleFile=true";
                compiler.StartInfo.UseShellExecute = true;
                compiler.StartInfo.RedirectStandardOutput = false;
                compiler.Start();
                compiler.WaitForExit();
            }
        }
        
        private static string AsyncApiDocToString(AsyncApiDocument doc)
        {
            string docString = JsonSerializer.Serialize(
                doc,
                new JsonSerializerOptions
                {
                    PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
                    WriteIndented = true,
                    IgnoreNullValues = true,
                    Converters =
                    {
                        new DictionaryKeyToStringConverter(),
                        new InterfaceImplementationConverter(),
                    },
                }
            );

            return docString.Replace("\"asyncApi\": 0,", "\"asyncapi\": \"2.0.0\",");
        }

Please consider this an "up-vote" for the suggested solution and related issues.