feat: initial prototype

.gitea/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: Node.js CI
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  lint:
+    name: Lint and Test
+
+    steps:
+      - name: Checkout Source Files
+        uses: actions/checkout@v4
+
+      - name: Use Node.js v24
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 10
+
+      - name: Install Dependencies
+        run: pnpm install
+
+      - name: Verify Build
+        run: pnpm run build
+
+      - name: Lint Source Files
+        run: pnpm run lint
+
+      - name: Run Tests
+        run: pnpm run test

.gitignore

@@ -0,0 +1,2 @@
+node_modules
+prod

.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+    "editor.codeActionsOnSave": {
+      "source.fixAll.eslint": "explicit"
+    },
+    "eslint.validate": ["typescript"]
+  }
+  

eslint.config.js

@@ -0,0 +1,3 @@
+import NaomisConfig from "@nhcarrigan/eslint-config";
+
+export default NaomisConfig;

package.json

@@ -0,0 +1,29 @@
+{
+  "name": "tyche",
+  "version": "0.0.0",
+  "description": "Discord bot to roll dice.",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint src --max-warnings 0",
+    "start": "op run --env-file=prod.env -- node prod/index.js",
+    "test": "echo \"Error: no test specified\" && exit 0"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "packageManager": "pnpm@10.20.0",
+  "devDependencies": {
+    "@nhcarrigan/eslint-config": "5.2.0",
+    "@nhcarrigan/typescript-config": "4.0.0",
+    "@types/node": "24.10.0",
+    "eslint": "9.39.1",
+    "typescript": "5.9.3"
+  },
+  "dependencies": {
+    "@nhcarrigan/discord-analytics": "0.0.6",
+    "@nhcarrigan/logger": "1.1.1",
+    "discord.js": "14.24.2",
+    "fastify": "5.6.1"
+  }
+}

prod.env

@@ -0,0 +1,2 @@
+BOT_TOKEN="op://Environment Variables - Naomi/Tyche/bot token"
+LOG_TOKEN="op://Environment Variables - Naomi/Alert Server/api_auth"

src/commands/roll.ts

@@ -0,0 +1,97 @@
+/**
+ * @copyright nhcarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
+import { SlashCommandBuilder } from "discord.js";
+
+const roll = new SlashCommandBuilder().setName("roll").
+  setDescription("Roll the dice!").
+  addIntegerOption(
+    (option) => {
+      return option.setName("count").setDescription("How many dice to roll").
+        setMinValue(1).
+        setMaxValue(100).
+        setRequired(true);
+    },
+  ).
+  addStringOption(
+    (option) => {
+      return option.setName("die").setDescription("What kind of dice to roll.").
+        setRequired(true).
+        addChoices(
+          [
+            {
+              name:  "d2",
+              value: "2",
+            },
+            {
+              name:  "d3",
+              value: "3",
+            },
+            {
+              name:  "d4",
+              value: "4",
+            },
+            {
+              name:  "d6",
+              value: "6",
+            },
+            {
+              name:  "d8",
+              value: "8",
+            },
+            {
+              name:  "d10",
+              value: "10",
+            },
+            {
+              name:  "d12",
+              value: "12",
+            },
+            {
+              name:  "d20",
+              value: "20",
+            },
+            {
+              name:  "d100",
+              value: "100",
+            },
+          ],
+        );
+    },
+  ).
+  addNumberOption(
+    (option) => {
+      return option.setName("modifier").
+        setDescription("What modifier to apply to the roll").
+        setRequired(false);
+    },
+  ).
+  addStringOption(
+    (option) => {
+      return option.setName("type").
+        setDescription("What type of roll to perform").
+        setRequired(true).
+        addChoices(
+          [
+            {
+              name:  "Normal Roll",
+              value: "normal",
+            },
+            {
+              name:  "Advantage Roll - roll twice and take the higher result",
+              value: "advantage",
+            },
+            {
+              name:  "Disadvantage Roll - roll twice and take the lower result",
+              value: "disadvantage",
+            },
+          ],
+        );
+    },
+  );
+
+// eslint-disable-next-line no-console -- We only use this file to generate the command JSON for the Discord API.
+console.log(JSON.stringify(roll.toJSON(), null, 2));

src/index.ts

@@ -0,0 +1,34 @@
+/**
+ * @copyright NHCarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
+import { DiscordAnalytics } from "@nhcarrigan/discord-analytics";
+import { Client, Events, GatewayIntentBits } from "discord.js";
+import { roll } from "./modules/roll.js";
+import { instantiateServer } from "./server/serve.js";
+import { logger } from "./utils/logger.js";
+
+const client = new Client({
+  intents: [
+    GatewayIntentBits.Guilds,
+  ],
+});
+
+const analytics = new DiscordAnalytics(client, logger);
+
+client.once(Events.ClientReady, () => {
+  void logger.log("debug", "Authenticated with Discord.");
+  analytics.startCron();
+});
+
+client.on(Events.InteractionCreate, (interaction) => {
+  if (!interaction.isChatInputCommand()) {
+    return;
+  }
+  void roll(interaction);
+});
+
+await client.login(process.env.BOT_TOKEN ?? "");
+instantiateServer();

src/modules/roll.ts

@@ -0,0 +1,65 @@
+/**
+ * @copyright nhcarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
+import { randomInt } from "node:crypto";
+import type { ChatInputCommandInteraction } from "discord.js";
+
+/**
+ * Rolls dice and returns the result.
+ * @param interaction -- The interaction payload from the Discord API.
+ */
+export const roll
+= async(interaction: ChatInputCommandInteraction): Promise<void> => {
+  const count = interaction.options.getInteger("count", true);
+  const die = interaction.options.getString("die", true);
+  const sides = Number.parseInt(die, 10);
+  const modifier = interaction.options.getNumber("modifier") ?? 0;
+  const type = interaction.options.getString("type", true);
+
+  const firstResult = Array.from({ length: count }, () => {
+    return randomInt(1, sides + 1);
+  });
+
+  if (type === "normal") {
+    const result = firstResult.reduce((a, b) => {
+      return a + b;
+    }, 0);
+    await interaction.reply(`Rolled ${String(count)}d${die}${modifier >= 0
+      ? `+${String(modifier)}`
+      : String(modifier)}:
+${firstResult.join(" + ")}
+Modifier: ${modifier >= 0
+  ? `+${String(modifier)}`
+  : `-${String(modifier)}`}
+Total: **${String(result + modifier)}**`);
+    return;
+  }
+
+  const secondResult = Array.from({ length: count }, () => {
+    return randomInt(1, sides + 1);
+  });
+
+  const firstTotal = firstResult.reduce((a, b) => {
+    return a + b;
+  }, 0);
+  const secondTotal = secondResult.reduce((a, b) => {
+    return a + b;
+  }, 0);
+
+  const result = type === "advantage"
+    ? Math.max(firstTotal, secondTotal)
+    : Math.min(firstTotal, secondTotal);
+
+  await interaction.reply(`Rolled ${String(count)}d${die}${modifier >= 0
+    ? `+${String(modifier)}`
+    : String(modifier)} with ${type}:
+${firstResult.join(" + ")}
+${secondResult.join(" + ")}
+Modifier: ${modifier >= 0
+  ? `+${String(modifier)}`
+  : String(modifier)}
+Total: **${String(result + modifier)}**`);
+};

src/server/serve.ts

@@ -0,0 +1,79 @@
+/**
+ * @copyright nhcarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
+import fastify from "fastify";
+import { logger } from "../utils/logger.js";
+
+const html = `<!DOCTYPE html>
+<html>
+  <head>
+    <title>Tyche</title>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="description" content="Discord bot that rolls dice." />
+    <script src="https://cdn.nhcarrigan.com/headers/index.js" async defer></script>
+  </head>
+  <body>
+    <main>
+    <h1>Tyche</h1>
+    <img src="https://cdn.nhcarrigan.com/new-avatars/tyche-full.png" width="250" alt="Tyche" />
+    <section>
+      <p>Discord bot that rolls dice.</p>
+      <a href="https://discord.com/oauth2/authorize?client_id=1436837822656020663" class="social-button discord-button" style="display: inline-block; background-color: #5865F2; color: white; padding: 10px 20px; text-decoration: none; border-radius: 4px; margin: 5px;">
+        <i class="fab fa-discord"></i> Add to Discord
+      </a>
+    </section>
+    <section>
+        <h2>Links</h2>
+        <p>
+            <a href="https://git.nhcarrigan.com/nhcarrigan/tyche">
+                <i class="fa-solid fa-code"></i> Source Code
+            </a>
+        </p>
+        <p>
+            <a href="https://docs.nhcarrigan.com/">
+                <i class="fa-solid fa-book"></i> Documentation
+            </a>
+        </p>
+        <p>
+            <a href="https://chat.nhcarrigan.com">
+                <i class="fa-solid fa-circle-info"></i> Support
+            </a>
+        </p>
+    </section>
+    </main>
+  </body>
+</html>`;
+
+/**
+ * Starts up a web server for health monitoring.
+ */
+export const instantiateServer = (): void => {
+  try {
+    const server = fastify({
+      logger: false,
+    });
+
+    server.get("/", (_request, response) => {
+      response.header("Content-Type", "text/html");
+      response.send(html);
+    });
+
+    server.listen({ port: 8123 }, (error) => {
+      if (error) {
+        void logger.error("instantiate server", error);
+        return;
+      }
+      void logger.log("debug", "Server listening on port 8123.");
+    });
+  } catch (error) {
+    if (error instanceof Error) {
+      void logger.error("instantiate server", error);
+      return;
+    }
+    void logger.error("instantiate server", new Error(String(error)));
+  }
+};

src/utils/logger.ts

@@ -0,0 +1,12 @@
+/**
+ * @copyright NHCarrigan
+ * @license Naomi's Public License
+ * @author Naomi Carrigan
+ */
+
+import { Logger } from "@nhcarrigan/logger";
+
+export const logger = new Logger(
+  "Tyche",
+  process.env.LOG_TOKEN ?? "",
+);

tsconfig.json

@@ -0,0 +1,7 @@
+{
+    "extends": "@nhcarrigan/typescript-config",
+    "compilerOptions": {
+        "outDir": "./prod",
+        "rootDir": "./src"
+    }
+}