feat: build initial prototype (#1)

### Explanation _No response_ ### Issue _No response_ ### Attestations - [x] I have read and agree to the [Code of Conduct](https://docs.nhcarrigan.com/community/coc/) - [x] I have read and agree to the [Community Guidelines](https://docs.nhcarrigan.com/community/guide/). - [x] My contribution complies with the [Contributor Covenant](https://docs.nhcarrigan.com/dev/covenant/). ### Dependencies - [x] I have pinned the dependencies to a specific patch version. ### Style - [x] I have run the linter and resolved any errors. - [x] My pull request uses an appropriate title, matching the conventional commit standards. - [x] My scope of feat/fix/chore/etc. correctly matches the nature of changes in my pull request. ### Tests - [x] My contribution adds new code, and I have added tests to cover it. - [ ] My contribution modifies existing code, and I have updated the tests to reflect these changes. - [x] All new and existing tests pass locally with my changes. - [x] Code coverage remains at or above the configured threshold. ### Documentation _No response_ ### Versioning _No response_ Reviewed-on: #1 Co-authored-by: Naomi Carrigan <commits@nhcarrigan.com> Co-committed-by: Naomi Carrigan <commits@nhcarrigan.com>
2025-07-19 16:11:39 -07:00
parent 46873b4598
commit 186fe97f30
29 changed files with 6543 additions and 0 deletions
@@ -0,0 +1,70 @@
+/**
+ * @copyright nhcarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+import {
+  MessageFlags,
+} from "discord.js";
+import { anime } from "../assets/anime.js";
+import { cats } from "../assets/cats.js";
+import { getArtComponents } from "../modules/getArtComponents.js";
+import { sendUnentitledResponse } from "../modules/sendUnentitledResponse.js";
+import { checkGuildEntitlement } from "../utils/checkEntitlement.js";
+import { errorHandler } from "../utils/errorHandler.js";
+import { getRandomValue } from "../utils/getRandomValue.js";
+import type { Ascii } from "../interfaces/ascii.js";
+import type { Command } from "../interfaces/command.js";
+
+type Category = "anime" | "cats";
+
+const isValidCategory = (category: string): category is Category => {
+  return [ "anime", "cats" ].includes(category);
+};
+
+const getCategoryList = (category: Category): Array<Ascii> => {
+  switch (category) {
+    case "anime":
+      return anime;
+    case "cats":
+      return cats;
+    default:
+      return [];
+  }
+};
+
+/**
+ * Handles the `/ascii` command interaction.
+ * @param chibika - Chibika's Discord instance (unused).
+ * @param interaction - The command interaction payload from Discord.
+ */
+export const ascii: Command = async(chibika, interaction) => {
+  try {
+    const isEntitled = await checkGuildEntitlement(chibika, interaction.guild);
+    if (!isEntitled) {
+      await sendUnentitledResponse(interaction);
+      return;
+    }
+    const category = interaction.options.getString("category", true);
+    if (!isValidCategory(category)) {
+      await interaction.reply({
+        content: `Invalid category: ${category}. Valid categories are: anime, cats.`,
+      });
+      return;
+    }
+    const components = getArtComponents(
+      getRandomValue(getCategoryList(category)),
+    );
+    await interaction.reply({
+      components: components,
+      flags:      MessageFlags.IsComponentsV2,
+    });
+  } catch (error) {
+    await errorHandler(error, "about command");
+    await interaction.reply({
+      content:
+        // eslint-disable-next-line stylistic/max-len -- Big boi string.
+        "An error occurred while processing your request. Please try again later.",
+    });
+  }
+};