feat: add joke command

Author: virtual-designer

src/main/typescript/commands/fun/JokeCommand.ts

@@ -0,0 +1,94 @@
+import type { Buildable } from "@framework/commands/Command";
+import { Command } from "@framework/commands/Command";
+import type Context from "@framework/commands/Context";
+import { env } from "@main/env/env";
+import { getAxiosClient } from "@main/utils/axios";
+import { EmbedBuilder } from "discord.js";
+
+class JokeCommand extends Command {
+    public override readonly name = "joke";
+    public override readonly description: string = "Fetch a random joke.";
+    public override readonly usage = [""];
+    public override readonly aliases = ["dadjoke"];
+
+    public override build(): Buildable[] {
+        return [
+            this.buildChatInput().addStringOption(option =>
+                option
+                    .setName("type")
+                    .setDescription("The type of joke to fetch.")
+                    .setRequired(false)
+                    .setChoices(
+                        {
+                            name: "Default",
+                            value: "joke"
+                        },
+                        {
+                            name: "Dad Joke",
+                            value: "dad_joke"
+                        }
+                    )
+            )
+        ];
+    }
+
+    public override async execute(context: Context): Promise<void> {
+        const isDadJoke =
+            context.commandName === "dadjoke" ||
+            (context.isChatInput() && context.options.getString("type") === "dad_joke");
+
+        if (isDadJoke && !env.API_NINJAS_JOKE_API_KEY) {
+            await context.error("Dad jokes are disabled because the API key is not set.");
+            return;
+        }
+
+        const url: string = isDadJoke
+            ? "https://api.api-ninjas.com/v1/dadjokes?limit=1"
+            : "https://v2.jokeapi.dev/joke/Any?blacklistFlags=nsfw,religious,political,racist";
+
+        try {
+            const response = await getAxiosClient().get(url, {
+                headers: isDadJoke
+                    ? {
+                          Accept: "application/json",
+                          "X-Api-Key": process.env.API_NINJAS_JOKE_API_KEY
+                      }
+                    : undefined
+            });
+
+            const embed = new EmbedBuilder()
+                .setColor("#007bff")
+                .setTitle("Joke")
+                .setDescription(
+                    !isDadJoke
+                        ? response.data.type === "twopart"
+                            ? response.data.setup + "\n\n" + response.data.delivery
+                            : response.data.joke
+                        : response.data[0].joke
+                )
+                .addFields(
+                    ...(!isDadJoke
+                        ? [
+                              {
+                                  name: "Category",
+                                  value: response.data.category
+                              }
+                          ]
+                        : [])
+                )
+                .setFooter({
+                    text: !isDadJoke
+                        ? `ID: ${response.data.id}`
+                        : `Type: ${isDadJoke ? "Dad Joke" : "Regular"}`
+                });
+
+            await context.reply({ embeds: [embed] });
+        } catch (error) {
+            this.application.logger.error(error);
+            await context.error("Failed to fetch joke: Invalid API response");
+            return;
+        }
+    }
+}
+
+export default JokeCommand;

src/main/typescript/schemas/EnvironmentVariableSchema.ts

@@ -33,7 +33,8 @@ export const EnvironmentVariableSchema = z.object({
         .string()
         .optional()
         .nullable()
-        .transform(value => (value === "null" ? null : value))
+        .transform(value => (value === "null" ? null : value)),
+    API_NINJAS_JOKE_API_KEY: z.string().optional()
 });
 
 export type EnvironmentVariableRecord = z.infer<typeof EnvironmentVariableSchema>;