Add tcg-card slash command and refactor services

Introduced a new `tcg-card` slash command for fetching and displaying Genius Invokation card details. Added autocomplete support via `CardAutocompleteProvider`.

Refactored `HoyolabHttpClientService` to improve modularity, including reusable query string helpers and type-safe method signatures. Added `GetActionSkillAsync` and renamed `GetActionsAsync` to `GetCardActionsAsync` for clarity.

Added `HoyolabCardActionService` with caching for card action data. Updated dependency injection to include the new service. Simplified `HoyolabResponseBase<T>` and `Response` for consistency.

Reorganized `using` directives and removed unused imports across files to improve code organization.

Author: pk9r

src/GitcgNetCord.MainApp/Commands/Autocompletes/CardAutocompleteProvider.cs

@@ -0,0 +1,46 @@
+using GitcgNetCord.MainApp.Infrastructure.HoyolabServices;
+using NetCord;
+using NetCord.Rest;
+using NetCord.Services.ApplicationCommands;
+
+namespace GitcgNetCord.MainApp.Commands.Autocompletes;
+
+public class CardAutocompleteProvider(
+    HoyolabCardActionService cardActionService
+) : IAutocompleteProvider<AutocompleteInteractionContext>
+{
+    public async ValueTask<
+        IEnumerable<ApplicationCommandOptionChoiceProperties>?
+    > GetChoicesAsync(
+        ApplicationCommandInteractionDataOption option,
+        AutocompleteInteractionContext context
+    )
+    {
+        var keyword = option.Value!;
+
+        var cardActions = await cardActionService.GetCardActionsAsync("vi-vn");
+
+        var suggestions = cardActions.Actions
+            .Where(x => StartsWith(x.Basic.Name, keyword) || Contains(x.Basic.Name, keyword))
+            .OrderBy(x => StartsWith(x.Basic.Name, keyword) ? 0 : 1)
+            .Select(x => new ApplicationCommandOptionChoiceProperties(x.Basic.Name, x.Basic.ItemId));
+
+        return suggestions.Take(25);
+
+        bool StartsWith(string x, string k)
+        {
+            return x.StartsWith(
+                value: k,
+                comparisonType: StringComparison.OrdinalIgnoreCase
+            );
+        }
+
+        bool Contains(string x, string k)
+        {
+            return x.Contains(
+                value: k,
+                comparisonType: StringComparison.OrdinalIgnoreCase
+            );
+        }
+    }
+}

src/GitcgNetCord.MainApp/Commands/Slash/DeckSlashCommand.cs

@@ -1,16 +1,15 @@
-using System.Collections.Immutable;
-using GitcgNetCord.MainApp.Commands.Autocompletes;
+using GitcgNetCord.MainApp.Commands.Autocompletes;
 using GitcgNetCord.MainApp.Commands.Interactions;
 using GitcgNetCord.MainApp.Entities.Repositories;
 using GitcgNetCord.MainApp.Enums;
 using GitcgNetCord.MainApp.Extensions;
 using GitcgNetCord.MainApp.Infrastructure.HoyolabServices;
 using GitcgNetCord.MainApp.Models;
-using GitcgPainter.ImageCreators.Deck.Abstractions;
 using HoyolabHttpClient;
 using NetCord;
 using NetCord.Rest;
 using NetCord.Services.ApplicationCommands;
+using System.Collections.Immutable;
 using Color = System.Drawing.Color;
 using IDeckImageCreationService = GitcgSharp.Shared.ImageCreators.Deck.Abstractions.IDeckImageCreationService;
 
@@ -63,7 +62,7 @@ await HoyolabAccountsSlashCommand
         }
 
         await context.Interaction.SendResponseAsync(
-            callback: InteractionCallback.DeferredMessage(MessageFlags.IsComponentsV2)
+            callback: InteractionCallback.DeferredMessage()
         );
 
         var decodeResult = await decoder.DecodeAsync(

src/GitcgNetCord.MainApp/Commands/Slash/TcgCardSlashCommand.cs

@@ -0,0 +1,163 @@
+using GitcgNetCord.MainApp.Commands.Autocompletes;
+using GitcgNetCord.MainApp.Extensions;
+using GitcgNetCord.MainApp.Infrastructure.HoyolabServices;
+using HoyolabHttpClient;
+using NetCord;
+using NetCord.Rest;
+using NetCord.Services.ApplicationCommands;
+using System.Collections.Immutable;
+using System.Text.RegularExpressions;
+using Color = System.Drawing.Color;
+
+namespace GitcgNetCord.MainApp.Commands.Slash;
+
+public partial class TcgCardSlashCommand
+{
+    public static async Task ExecuteAsync(
+        HoyolabHttpClientService hoyolab,
+        IServiceProvider serviceProvider,
+        ApplicationCommandContext context,
+        [
+            SlashCommandParameter(
+                Description = "Card ID.",
+                AutocompleteProviderType = typeof(CardAutocompleteProvider)
+            )
+        ]
+        int cardId,
+        [
+            SlashCommandParameter(
+                Description = "Language. Default: `en-us`.",
+                AutocompleteProviderType = typeof(LanguageAutocompleteProvider)
+            )
+        ]
+        string lang = "en-us"
+    )
+    {
+        var cardActionService = serviceProvider
+            .GetRequiredService<HoyolabCardActionService>();
+
+        await context.Interaction.SendResponseAsync(
+            callback: InteractionCallback.DeferredMessage()
+        );
+
+        HoyolabHttpClient.Responses.ActionSkill.Data data;
+
+        try
+        {
+            data = await hoyolab.GetActionSkillAsync(cardId, lang);
+        }
+        catch (Exception e)
+        {
+            await context.Interaction.ModifyResponseAsync(message =>
+            {
+                //message.WithFlags(MessageFlags.IsComponentsV2);
+                message.AddEmbeds(new EmbedProperties()
+                    .WithTitle("Error")
+                    .WithDescription(e.Message)
+                    .WithColor(Color.Red.ToNetCordColor())
+                );
+            });
+            return;
+        }
+
+        var appEmojis = await context.Client.Rest
+            .GetApplicationEmojisAsync(context.Client.Id);
+        var emojis = appEmojis.ToImmutableDictionary(x => x.Name);
+
+        var cardActions = await cardActionService
+            .GetCardActionsAsync(lang);
+        var action = cardActions.Actions
+            .First(x => x.Basic.ItemId == cardId);
+
+        await context.Interaction.ModifyResponseAsync(message =>
+        {
+            message.WithFlags(MessageFlags.IsComponentsV2);
+            message.AddComponents([new ComponentContainerProperties()
+                .WithAccentColor(Color.Purple.ToNetCordColor())
+                .AddComponents(
+                    new TextDisplayProperties(
+                        $"""
+                        ## {GetName(cardId)}
+                        """
+                    ),
+                    new MediaGalleryProperties().AddItems(
+                        new MediaGalleryItemProperties(
+                            new ComponentMediaProperties(action.Basic.Icon))
+                    ),
+                    new TextDisplayProperties(
+                        $"{GetDesc(data.Desc)}"
+                    )
+                )
+            ]);
+        });
+
+        return;
+
+        string GetName(int cardId)
+        {
+            return GetDesc(
+                $"{data.Cost1Raw}" +
+                $"<img src='{data.Cost2TypeIcon}' /> - " +
+                $"{action.Basic.Name}"
+            );
+        }
+
+        string GetDesc(string desc)
+        {
+            var result = desc;
+
+            result = result.Replace("\\n", "\n");
+            result = result.Replace(
+                "<img src='https://act-webstatic.hoyoverse.com/hk4e/e20200928calculate/item_icon/67c7f71f/e25f04745615df9e779831a1c1354e38.png' />",
+                emojis["food"].ToString()
+            );
+            result = result.Replace(
+                "<img src='https://act-webstatic.hoyoverse.com/hk4e/e20200928calculate/item_icon/67c7f71f/d92127a21b942663e6ed0717cef1086e.png' />",
+                emojis["location"].ToString()
+            );
+            result = result.Replace(
+                "<img src='https://act-webstatic.hoyoverse.com/hk4e/e20200928calculate/item_icon/67c7f71f/377c4198e3072e9c68066736be5b790c.png' />",
+                emojis["item"].ToString()
+            );
+            result = result.Replace(
+                "<img src='https://act-webstatic.hoyoverse.com/hk4e/e20200928calculate/item_icon/67c7f71f/1643452964b58e2e69e64e2b5d3b5878.png' />",
+                emojis["catalyst"].ToString()
+            );
+            result = result.Replace(
+                "<img src='https://act-webstatic.hoyoverse.com/hk4e/e20200928calculate/item_icon/67c7f71f/49acb071b0d634ded17cb788d9f520ed.png' />",
+                emojis["weapon"].ToString()
+            );
+            result = result.Replace(
+                "<img src='https://act-webstatic.hoyoverse.com/hk4e/e20200928calculate/item_icon/67c7f719/e1430a8775eb864ed0617b7ef516e608.png' />",
+                emojis["physical_dmg"].ToString()
+            );
+            result = result.Replace(
+                "<img src='https://act-webstatic.hoyoverse.com/hk4e/e20200928calculate/item_icon/67c7f719/8401f5013a7c381edb6cd088b207bb9f.png' />",
+                emojis["omni"].ToString()
+            );
+            result = result.Replace(
+                "<img src='https://act-webstatic.hoyoverse.com/hk4e/e20200928calculate/' />",
+                emojis["aligned"].ToString()
+            );
+            result = result.Replace(
+                "<img src='https://act-webstatic.hoyoverse.com/hk4e/e20200928calculate/item_icon/67c7f719/39de35b178b080a090ac95622bbbf0df.png' />",
+                emojis["unaligned"].ToString()
+            );
+
+            while (ColorTagRegex().IsMatch(result))
+            {
+                result = ColorTagRegex().Replace(result, "**$1**");
+            }
+
+            return result;
+        }
+    }
+
+    [
+        GeneratedRegex(
+            pattern: @"<color\b[^>]*>(.*?)</color>",
+            options: RegexOptions.IgnoreCase | RegexOptions.Singleline
+        )
+    ]
+    private static partial Regex ColorTagRegex();
+}

src/GitcgNetCord.MainApp/Extensions/Extensions.cs

@@ -64,6 +64,7 @@ this IServiceCollection services
     {
         services.AddHoyolabHttpClient();
         services.AddSingleton<HoyolabCardRoleService>();
+        services.AddSingleton<HoyolabCardActionService>();
         services.AddSingleton<HoyolabDecoder>();
         services.AddSingleton<HoyolabDeckAccountService>();
         services.AddSingleton<HoyolabGcgBasicInfoService>();

src/GitcgNetCord.MainApp/Infrastructure/HoyolabServices/HoyolabCardActionService.cs

@@ -0,0 +1,38 @@
+using HoyolabHttpClient;
+using HoyolabHttpClient.Responses.CardActions;
+using Microsoft.Extensions.Caching.Hybrid;
+
+namespace GitcgNetCord.MainApp.Infrastructure.HoyolabServices;
+
+public class HoyolabCardActionService(
+    HoyolabCardRoleService cardRoleService,
+    HoyolabHttpClientService hoyolab,
+    HybridCache cache
+)
+{
+    public async Task<Data>
+        GetCardActionsAsync(string lang = "en-us")
+    {
+        var cacheKey = $"card-action:{lang}";
+        var cached = await cache
+            .GetOrCreateAsync(
+                key: cacheKey,
+                factory: FetchAsync
+            );
+
+        return cached;
+
+        async ValueTask<Data> FetchAsync(
+            CancellationToken cancellationToken = default
+        )
+        {
+            var roleData = await cardRoleService.GetCardRolesAsync(lang);
+            var roleIds = roleData.Roles
+                .Select(x => x.Basic.ItemId);
+
+            var cardActions = await hoyolab
+                .GetCardActionsAsync(roleIds, lang);
+            return cardActions;
+        }
+    }
+}

src/GitcgNetCord.MainApp/Modules/Feats/HoyolabGcgModule.cs

@@ -31,5 +31,17 @@ public static void AddHoyolabGcgModule(this IHost host)
                 InteractionContextType.DMChannel
             ]
         );
+
+        host.AddSlashCommand(
+            name: "tcg-card",
+            description: "Information about a specific Genius Invokation card.",
+            handler: TcgCardSlashCommand.ExecuteAsync,
+            contexts:
+            [
+                InteractionContextType.Guild,
+                InteractionContextType.BotDMChannel,
+                InteractionContextType.DMChannel
+            ]
+        );
     }
 }

src/HoyolabHttpClient/Extensions/HoyolabServiceExtension.cs

@@ -1,12 +1,11 @@
-using System.Threading.Tasks;
-using HoyolabHttpClient.Models;
-using HoyolabHttpClient.Responses.Skills;
+using HoyolabHttpClient.Models;
+using System.Threading.Tasks;
 
 namespace HoyolabHttpClient.Extensions;
 
 public static class HoyolabServiceExtension
 {
-    public static Task<Data>
+    public static Task<Responses.Skills.Data>
         GetRoleSkillAsync(
             this HoyolabHttpClientService hoyolabService,
             Role role,