feat: add Cat module with /cat and /catgif commands using TheCatAPI

src/commands/utility/cat.ts

@@ -0,0 +1,40 @@
+import { SlashCommandBuilder, EmbedBuilder } from 'discord.js';
+import { Command } from '../../structures/Command.js';
+import { CatManager } from '../../structures/CatManager.js';
+
+const command: Command = {
+    data: new SlashCommandBuilder()
+        .setName('cat')
+        .setDescription('Postet ein zufälliges Katzenbild oder Katzen-GIF.')
+        .addStringOption(option =>
+            option.setName('typ')
+                .setDescription('Wähle zwischen Bild oder GIF')
+                .setRequired(false)
+                .addChoices(
+                    { name: 'Bild', value: 'image' },
+                    { name: 'GIF', value: 'gif' }
+                ))
+        .setDMPermission(true),
+    category: 'Public',
+    async execute(interaction: any) {
+        const type = (interaction.options.getString('typ') as 'image' | 'gif') || 'image';
+        await interaction.deferReply();
+
+        const imageUrl = await CatManager.fetchCatImage(type);
+        if (!imageUrl) {
+            await interaction.editReply('❌ Konnte kein Katzenbild laden. Bitte versuche es später erneut.');
+            return;
+        }
+
+        const embed = new EmbedBuilder()
+            .setTitle(type === 'gif' ? '🐱 Zufälliges Katzen-GIF' : '🐱 Zufälliges Katzenbild')
+            .setURL(imageUrl)
+            .setImage(imageUrl)
+            .setColor(0xf39c12)
+            .setTimestamp();
+
+        await interaction.editReply({ embeds: [embed] });
+    },
+};
+
+export default command;

src/commands/utility/catgif.ts

@@ -0,0 +1,31 @@
+import { SlashCommandBuilder, EmbedBuilder } from 'discord.js';
+import { Command } from '../../structures/Command.js';
+import { CatManager } from '../../structures/CatManager.js';
+
+const command: Command = {
+    data: new SlashCommandBuilder()
+        .setName('catgif')
+        .setDescription('Postet direkt ein zufälliges Katzen-GIF.')
+        .setDMPermission(true),
+    category: 'Public',
+    async execute(interaction: any) {
+        await interaction.deferReply();
+
+        const imageUrl = await CatManager.fetchCatImage('gif');
+        if (!imageUrl) {
+            await interaction.editReply('❌ Konnte kein Katzen-GIF laden. Bitte versuche es später erneut.');
+            return;
+        }
+
+        const embed = new EmbedBuilder()
+            .setTitle('🐱 Zufälliges Katzen-GIF')
+            .setURL(imageUrl)
+            .setImage(imageUrl)
+            .setColor(0xf39c12)
+            .setTimestamp();
+
+        await interaction.editReply({ embeds: [embed] });
+    },
+};
+
+export default command;

src/structures/CatManager.ts

@@ -0,0 +1,26 @@
+export class CatManager {
+    static async fetchCatImage(type: 'image' | 'gif' = 'image'): Promise<string | null> {
+        const apiKey = process.env.THECATAPI_KEY || '';
+        const mimeTypes = type === 'gif' ? 'gif' : 'jpg,png';
+        const url = `https://api.thecatapi.com/v1/images/search?mime_types=${mimeTypes}`;
+
+        try {
+            const headers: Record<string, string> = {};
+            if (apiKey) {
+                headers['x-api-key'] = apiKey;
+            }
+
+            const response = await fetch(url, { headers });
+            if (!response.ok) return null;
+
+            const data: any = await response.json();
+            if (Array.isArray(data) && data.length > 0 && data[0].url) {
+                return data[0].url;
+            }
+            return null;
+        } catch (error) {
+            console.error('[CAT] Error fetching cat image:', error);
+            return null;
+        }
+    }
+}