feat: add webhooks

[null8626]

The following pull request is a toned down version of #29. This pull request focuses solely on adding a webhooks wrapper for ASP.NET Core/Blazor.

[velddev]

This is not how a ASP.NET Core webhook endpoint should look like. Prefer using the minimal API to create a route at build-time. This will let the internal ASP.NET core router handle all of the actual context.

public static class RoutingExtension {
  public static void UseVoteWebhook(IRouteEndpointBuilder router, string path, ...) {
    router.MapGet(path, (req) => {
      ...
    });  
  }
}

[null8626]

Will work on it.

[null8626]

Done. Made it more similar to Node.js SDK' webhooks wrapper.

Example usage:

using DiscordBotsList.Api.Webhooks;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => "Hello World!");

var webhooks = new Webhooks("my webhook secret");

app.MapPost("/webhooks", webhooks.Listener((context, vote) =>
{
    Console.WriteLine($"A user with the ID of {vote.VoterId} has voted us on Top.gg!");

    return Task.CompletedTask;
}));

app.Run();

[williamdevgg]

looks good to me

[velddev]

Most of this wouldn't work with the actual api. Refer to the docs here for more information.

https://docs.top.gg/docs/API/v1/webhooks/
https://docs.top.gg/docs/API/v1/integrations

[velddev]

This can be done without an allocation an hmac object every request by using

HMACSHA256.HashData(authorization, data);

[null8626]

Done. See this commit.

[velddev]

This would break on additional other values. See; https://docs.top.gg/docs/API/v1/webhooks/

[velddev]

Look into https://learn.microsoft.com/en-us/dotnet/standard/serialization/system-text-json/polymorphism

[null8626]

Done. What do you think of this diff?

[velddev]

Wrong Type, this is the legacy payload

[null8626]

Done. Check this diff.

[null8626]

Most of this wouldn't work with the actual api. Refer to the docs here for more information.

https://docs.top.gg/docs/API/v1/webhooks/ https://docs.top.gg/docs/API/v1/integrations

So sorry! I was too fixated on top-gg/webhooks-v2-nodejs-example that I didn't notice the new webhook events. My bad. I've addressed them now.

[velddev]

LGTM, few small nits and naming recommendations

[velddev]

Could you avoid adding scope for namespaces? This is no longer required

[null8626]

Done.

[velddev]

nit: Could we call it something like WebhookEventListener. Webhooks feels like a constant class with readonly properties (e.g. Webhooks.VoteCreate)

[null8626]

Done.

[velddev]

what happens if this returns false?

[null8626]

Sorry! Forgot about that one. Should be resolved by now.