feat: initial prototype (#7)

### Explanation _No response_ ### Issue _No response_ ### Attestations - [ ] I have read and agree to the [Code of Conduct](https://docs.nhcarrigan.com/community/coc/) - [ ] I have read and agree to the [Community Guidelines](https://docs.nhcarrigan.com/community/guide/). - [ ] My contribution complies with the [Contributor Covenant](https://docs.nhcarrigan.com/dev/covenant/). ### Dependencies - [ ] I have pinned the dependencies to a specific patch version. ### Style - [ ] I have run the linter and resolved any errors. - [ ] My pull request uses an appropriate title, matching the conventional commit standards. - [ ] My scope of feat/fix/chore/etc. correctly matches the nature of changes in my pull request. ### Tests - [ ] 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. - [ ] All new and existing tests pass locally with my changes. - [ ] Code coverage remains at or above the configured threshold. ### Documentation _No response_ ### Versioning _No response_ Reviewed-on: #7 Co-authored-by: Naomi Carrigan <commits@nhcarrigan.com> Co-committed-by: Naomi Carrigan <commits@nhcarrigan.com>
2025-09-27 16:58:54 -07:00
parent ad449e50a4
commit 64d5d4a9b5
21 changed files with 5618 additions and 0 deletions
@@ -0,0 +1,107 @@
+/**
+ * @copyright NHCarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
+import {
+  MessageFlags,
+  PermissionFlagsBits,
+  ChannelType,
+  type ChatInputCommandInteraction,
+} from "discord.js";
+import { about } from "../components/about.js";
+import { ask } from "../modals/ask.js";
+import type { Veluna } from "../interfaces/veluna.js";
+
+interface Query {
+  questionChannelId?: string;
+  answerChannelId?:   string;
+}
+
+const buildQuery = (type: string, id: string): Query => {
+  if (type === "question") {
+    return { questionChannelId: id };
+  }
+  if (type === "answer") {
+    return { answerChannelId: id };
+  }
+  return {};
+};
+
+/**
+ * Handles the logic for slash commands. Identifies the command name
+ * and responds accordingly.
+ * @param veluna - Veluna's instance.
+ * @param interaction - The interaction payload from Discord.
+ */
+// eslint-disable-next-line max-lines-per-function -- Big boi function.
+export const handleChatCommand = async(
+  veluna: Veluna,
+  interaction: ChatInputCommandInteraction<"cached">,
+): Promise<void> => {
+  const { commandName, options, guild, member } = interaction;
+
+  if (commandName === "about") {
+    await interaction.reply({
+      components: about,
+      flags:      [ MessageFlags.IsComponentsV2 ],
+    });
+    return;
+  }
+
+  if (commandName === "ask") {
+    await interaction.showModal(ask);
+    return;
+  }
+
+  // Permission gated commands w/ DB queries...
+
+  await interaction.deferReply({
+    flags: [ MessageFlags.Ephemeral ],
+  });
+
+  if (!member.permissions.has(PermissionFlagsBits.ManageGuild)) {
+    await interaction.editReply({
+      content: "You must be a server administrator to use this command.",
+    });
+    return;
+  }
+
+  // These both require a channel
+  const channel = options.
+    getChannel("channel", true, [ ChannelType.GuildText ]);
+
+  const me = await guild.members.fetchMe().
+    catch(() => {
+      return null;
+    });
+
+  if (me?.permissions.has([
+    PermissionFlagsBits.ViewChannel,
+    PermissionFlagsBits.SendMessages,
+    PermissionFlagsBits.EmbedLinks,
+  ]) !== true) {
+    await interaction.editReply({
+      content:
+        // eslint-disable-next-line stylistic/max-len -- Big boi string.
+        "I do not have permission to view and send messages in the channel provided. Please adjust my permissions and try again.",
+    });
+    return;
+  }
+
+  const query = buildQuery(commandName, channel.id);
+
+  await veluna.db.servers.upsert({
+    create: {
+      answerChannelId:   query.answerChannelId ?? "",
+      blockedUsers:      [],
+      questionChannelId: query.questionChannelId ?? "",
+      serverId:          guild.id,
+    },
+    update: buildQuery(commandName, channel.id),
+    where:  {
+      serverId: guild.id,
+    },
+  });
+};