Merge pull request #15 from tresabhi/1.9.2

.github/workflows/cd-docs.yml

@@ -0,0 +1,64 @@
+name: CD Docs
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    strategy:
+      matrix:
+        node-version: [18.x]
+
+    steps:
+      - name: Get code
+        uses: actions/checkout@v3
+
+      - name: Use node
+        uses: actions/setup-node@v3
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install Yarn
+        run: npm install --location=global yarn
+
+      - name: Use node_modules cache
+        uses: actions/cache@v3
+        with:
+          path: '**/node_modules'
+          key: ${{ runner.os }}-modules-${{ hashFiles('**/yarn.lock') }}
+
+      - name: Install dependencies
+        run: yarn
+
+      - name: Build docs
+        run: yarn build:docs
+
+      - name: Configure pages
+        uses: actions/configure-pages@v2
+
+      - name: Upload pages artifact
+        uses: actions/upload-pages-artifact@v1
+        with:
+          path: docs/.vitepress/dist
+
+      - name: Deploy
+        id: deployment
+        uses: actions/deploy-pages@v1
+
+      - name: Archive build
+        uses: actions/upload-artifact@v3
+        with:
+          name: dist
+          path: docs/.vitepress/dist

.github/workflows/host.yml

@@ -3,9 +3,6 @@ name: Host
 on:
   schedule:
     - cron: '0 */5 * * *'
-  push:
-    branches:
-      - 'main'
   workflow_dispatch:
 
 concurrency:
@@ -34,5 +31,5 @@ jobs:
           curl -L -o dist.zip $DOWNLOAD_URL
           unzip dist.zip
 
-      - name: Run index.cjs
+      - name: Run bot
-        run: NODE_ENV=production DISCORD_TOKEN=${{ secrets.DISCORD_TOKEN }} WARGAMING_APPLICATION_ID=${{ secrets.WARGAMING_APPLICATION_ID }} node --enable-source-maps index.cjs
+        run: NODE_ENV=production DISCORD_TOKEN=${{ secrets.DISCORD_TOKEN }} WARGAMING_APPLICATION_ID=${{ secrets.WARGAMING_APPLICATION_ID }} node --enable-source-maps --trace-warnings bot.cjs

.gitignore

@@ -7,3 +7,7 @@ package-lock.json
 dist/
 yarn-error.log
 dist.zip
+commands.txt
+/test.*
+/docs/.vitepress/dist
+/docs/.vitepress/cache

.vscode/settings.json

@@ -3,7 +3,10 @@
     "Abhi",
     "accountinfo",
     "bepaint",
+    "blitzstars",
     "cleandist",
+    "customperiod",
+    "Everytime",
     "fuzzysort",
     "kranvagn",
     "outfile",
@@ -11,18 +14,22 @@
     "playerachievements",
     "playerinfo",
     "Resvg",
+    "roboto",
     "searchclans",
     "searchplayers",
     "searchtanks",
     "SKLLD",
     "Smri",
     "startcase",
+    "statsfull",
     "strvk",
+    "tankaverages",
     "tankopedia",
     "tankstats",
     "Unicum",
     "Unregistering",
     "vickers",
+    "vitepress",
     "wargaming",
     "winrate"
   ],

docs/.vitepress/config.ts

@@ -0,0 +1,25 @@
+import { DefaultTheme, defineConfig } from 'vitepress';
+import { getSidebar } from 'vitepress-plugin-auto-sidebar';
+
+export default defineConfig({
+  title: 'blitzkrieg',
+  description: '🎉 All-in-one Discord bot for everything World of Tanks Blitz',
+  base: '/blitzkrieg/',
+
+  themeConfig: {
+    nav: [
+      { text: 'Home', link: '/' },
+      { text: 'Examples', link: '/markdown-examples' },
+    ],
+
+    sidebar: getSidebar({
+      collapsed: false,
+      contentDirs: ['guide', 'legal', 'changelogs'],
+      contentRoot: '/docs/',
+    }) as DefaultTheme.Sidebar,
+
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/vuejs/vitepress' },
+    ],
+  },
+});

docs/.vitepress/theme/index.ts

@@ -0,0 +1,16 @@
+// https://vitepress.dev/guide/custom-theme
+import { h } from 'vue'
+import Theme from 'vitepress/theme'
+import './style.css'
+
+export default {
+  extends: Theme,
+  Layout: () => {
+    return h(Theme.Layout, null, {
+      // https://vitepress.dev/guide/extending-default-theme#layout-slots
+    })
+  },
+  enhanceApp({ app, router, siteData }) {
+    // ...
+  }
+}

docs/.vitepress/theme/style.css

@@ -0,0 +1,91 @@
+/**
+ * Customize default theme styling by overriding CSS variables:
+ * https://github.com/vuejs/vitepress/blob/main/src/client/theme-default/styles/vars.css
+ */
+
+/**
+ * Colors
+ * -------------------------------------------------------------------------- */
+
+ :root {
+  --vp-c-brand: #646cff;
+  --vp-c-brand-light: #747bff;
+  --vp-c-brand-lighter: #9499ff;
+  --vp-c-brand-lightest: #bcc0ff;
+  --vp-c-brand-dark: #535bf2;
+  --vp-c-brand-darker: #454ce1;
+  --vp-c-brand-dimm: rgba(100, 108, 255, 0.08);
+}
+
+/**
+ * Component: Button
+ * -------------------------------------------------------------------------- */
+
+:root {
+  --vp-button-brand-border: var(--vp-c-brand-light);
+  --vp-button-brand-text: var(--vp-c-white);
+  --vp-button-brand-bg: var(--vp-c-brand);
+  --vp-button-brand-hover-border: var(--vp-c-brand-light);
+  --vp-button-brand-hover-text: var(--vp-c-white);
+  --vp-button-brand-hover-bg: var(--vp-c-brand-light);
+  --vp-button-brand-active-border: var(--vp-c-brand-light);
+  --vp-button-brand-active-text: var(--vp-c-white);
+  --vp-button-brand-active-bg: var(--vp-button-brand-bg);
+}
+
+/**
+ * Component: Home
+ * -------------------------------------------------------------------------- */
+
+:root {
+  --vp-home-hero-name-color: transparent;
+  --vp-home-hero-name-background: -webkit-linear-gradient(
+    120deg,
+    #bd34fe 30%,
+    #41d1ff
+  );
+
+  --vp-home-hero-image-background-image: linear-gradient(
+    -45deg,
+    #bd34fe 50%,
+    #47caff 50%
+  );
+  --vp-home-hero-image-filter: blur(40px);
+}
+
+@media (min-width: 640px) {
+  :root {
+    --vp-home-hero-image-filter: blur(56px);
+  }
+}
+
+@media (min-width: 960px) {
+  :root {
+    --vp-home-hero-image-filter: blur(72px);
+  }
+}
+
+/**
+ * Component: Custom Block
+ * -------------------------------------------------------------------------- */
+
+:root {
+  --vp-custom-block-tip-border: var(--vp-c-brand);
+  --vp-custom-block-tip-text: var(--vp-c-brand-darker);
+  --vp-custom-block-tip-bg: var(--vp-c-brand-dimm);
+}
+
+.dark {
+  --vp-custom-block-tip-border: var(--vp-c-brand);
+  --vp-custom-block-tip-text: var(--vp-c-brand-lightest);
+  --vp-custom-block-tip-bg: var(--vp-c-brand-dimm);
+}
+
+/**
+ * Component: Algolia
+ * -------------------------------------------------------------------------- */
+
+.DocSearch {
+  --docsearch-primary-color: var(--vp-c-brand) !important;
+}
+

docs/changelogs/1.3.0.md

@@ -0,0 +1,9 @@
+# Blitzkrieg 1.3.0
+
+This release of Blitzkrieg focuses mainly on **performance**. Blitzkrieg now uses **Satori** and **resvg** under the hood to render images resulting in a solid **2x to 8x performance boost** depending on the situation.
+
+This only applies to `/today` and /stats` as they're the only commands that render an image currently.
+
+We're working further on **performance optimizations**. Our goal is to deliver a message within **3 seconds or less**. We're close and we'll get there!
+
+**Thank you to ba·ka**, the creator of aftermath, for telling me about Satori!

docs/changelogs/1.3.1.md

@@ -0,0 +1,8 @@
+# Blitzkrieg 1.3.1
+
+In this **minor update**, Blitzkrieg received several little **safety features** and **bug fixes**!
+
+- The bot is now more verbose
+  - Every time you use a command, the bot will now store data on what parameters you provided and if any errors were caused
+- This update also eliminates the redundant usage of truthy type checking after API calls
+  - _Hopefully_ the bot let you know why it won't respond to you

docs/changelogs/1.3.2.md

@@ -0,0 +1,5 @@
+# Blitzkrieg 1.3.2
+
+From now on, I **won't be pinging** the Blitzkrieg role for minor updates. Anyway, this **minor update** includes an optimization for `/today`. The tank icons on the left were fetched every time someone used the command. The bot now caches those images allowing for an instantaneous load.
+
+I noticed rendering times up to `3000ms` for rendering stats of about 10 tanks. Cached images should now be indifferent to this.

docs/changelogs/1.3.3.md

@@ -0,0 +1,8 @@
+# Blitzkrieg 1.3.3
+
+This **minor update** fixes a few things :partying_face:
+
+- Rating battles now no longer count in `/today`
+  - This resolves the issue where some tanks had `NaN` stats
+- Stats with the value of `-Infinity` are now ommited
+- Images are not longer cached in `dev` `env`

docs/changelogs/1.4.0.md

@@ -0,0 +1,28 @@
+# Blitzkrieg 1.4.0
+
+A **few features** :star: and a **few much needed fixes** :wrench:!
+
+## Changes
+
+- Added an "today" row to `/today` which displays your overall statistics
+- Gave `/tankstats` the new blitzkrieg look
+  - Also added "today", "60 days", and "career" stats
+- Added a beta warning to generated images
+- Updated the logo for match the new slate theme
+  - Canary versions now use the canary logo variant
+- Added subtle polka dots to the background
+
+## Fixes
+
+- Rewrote `/stats` to precisely calculate stats on a per-tank basis
+  - This should stop the bot from hallucinating about stats
+  - This should also stop the bot from giving stats from like a week ago
+  - Also added "60 day" stats
+- Tank autocomplete is now more human-tolerant just like username autocomplete
+- Titlebar discriminators are now truncated on overflow
+
+## Technical Changes
+
+- The bot now uses `bepaint`, a library that I made that standardizes the color palette
+  - Also updated the logo to follow this
+- Optimized how fonts are imported by fetching them all asynchronously

docs/changelogs/1.4.1.md

@@ -0,0 +1,3 @@
+# Blitzkrieg 1.4.1
+
+A quick fix for the `/help` command not accepting the new theme colors.

docs/changelogs/1.5.0.md

@@ -0,0 +1,23 @@
+# Blitzkrieg 1.5.0
+
+So so many **quality-of-life** changes and nasty **bug squashes**!
+
+## Changes
+
+- Added WN8 to `/today`, `/stats`, and `/tankstats`
+- Added average tier to `/stats` and `/tankstats`
+  - Average tier in `/tankstats` is simply the tier of the tank that you are looking up
+- Added an indicator of WN8 ranging from "very bad" (gray) to "super unicum" (purple)
+- Replaced ellipses with simple clipping
+- Added a "large image" warning to `/today` if displaying `6` or more tanks
+
+## Fixes
+
+- Removed random 0 that'd show up in `/today` where there was no difference between career and today's stats
+- Added stricter checks for username autocomplete via a new REGEX pattern
+- Fixed wonky ellipses that'd cut off usernames, tank names, and clan names unnecessarily
+- Fixed the delta indicator showing up in battle counts
+
+## Technical Changes
+
+- Optimized and cleaned up tankopedia cache

docs/changelogs/1.5.1.md

@@ -0,0 +1,3 @@
+# Blitzkrieg 1.5.1
+
+An emergency patch that fixes failed image caching.

docs/changelogs/1.5.2.md

@@ -0,0 +1,14 @@
+# Blitzkrieg 1.5.2
+
+Quite a few **bug fixes** with a **bunch more** on their way next update!
+
+## Fixes
+
+- Disabled image encoding as it seems to have broken in `1.5.0` and simply spams the console now
+- `/stats` now ignores tanks that don't have any averages
+  - Tanks may not have averages registered in Blitz Stars because they are new or are in testing
+  - Take a look at \_34's testing tanks in the image below
+- Fixed the "large image" prompt by simply removing the whole prompt
+  - _Kaboom? Yes Rico, kaboom._
+- `/today` now displays `--` when there is no WN8 to display
+  - This is unlike `/stats` which just shows 0 (this will be fixed soon)

docs/changelogs/1.5.3.md

@@ -0,0 +1,10 @@
+# Blitzkrieg 1.5.3
+
+Just a few more fixes that weren't that important so were deffered to this update.
+
+## Fixes
+
+- `/stats` now uses `--` just like `/today` when WN8 is not available
+- Removed an unnecessary try/catch during the execution of a command
+- Added error handling for an edge case where accounts with 0 battles were looked up
+  - This only applies to when `api/tanks/stats` is fetched; most other commands still need this fix

docs/changelogs/1.5.4.md

@@ -0,0 +1,8 @@
+# Blitzkrieg 1.5.4
+
+A last batch of fixes before the next update!
+
+## Fixes
+
+- Career WN8 in the `/today` command now accumulates the WN8 for all tanks instead of just the ones shown
+- WN8 and average tiers are now displayed in `/stats` in the `career` period

docs/changelogs/1.6.0.md

@@ -0,0 +1,25 @@
+# Blitzkrieg 1.6.0
+
+Spread the beauty! Spread the ease!
+
+## Features
+
+- Commands no longer require you to provide an username
+  - They are automatically inferred from your Discord nickname
+- Re-implemented the `/eligible` command
+  - This command checks a player's eligibility for any of the Skilled clans
+  - This command is only available in the [Skilled](https://discord.gg/ZPvcEG7DS8) and [TresAbhi Discord](https://discord.gg/nDt7AjGJQH) servers
+- Gave `/ownedtanks` and `/inactive` the new Blitzkrieg look
+- Added "Powered by Wargaming" to commands where Blitz Stars is not utilized
+
+## Fixes
+
+- Removed image encoding all together
+  - As it turns out, encoding them in `base64` made rendering slower!
+- Tank images in `/today` now don't make parent rows incorrectly taller
+- Added a "No tanks found" when a player does not own tanks in a tier
+
+## Technical Changes
+
+- Added a mature error handling system
+  - Commands can now just `throw errorWithCause(...)` without caring about the error reporting to the user

docs/changelogs/1.7.0.md

@@ -0,0 +1,20 @@
+# Blitzkrieg 1.7.0
+
+This is mostly a technical update to make migrating to cyclic.sh easier.
+
+## Changes
+
+- The bot's new deferred caching approach allows the bot to start up almost `4x` as fast
+
+## Technical Changes
+
+- Made numerous caches non-blocking
+  - Removed an unnecessary root-blocking await where fonts are imported
+    - Further improved performance by deferring font imports until after the declaration
+  - Tank averages and tankopedia are now declared fully empty only to be populated after a deferred fetch
+- Reordered error handler, client login, and client event listener registration orders
+- Removed `vite` all together
+  - This reduces bundle sizes
+  - To do this, a more primitive way of importing commands is used
+- Removed the redundant usage of `args` to get the Discord token and Wargaming Application ID on each use
+- Added a build script using `esbuild`

docs/changelogs/1.7.1.md

@@ -0,0 +1,3 @@
+# Blitzkrieg 1.7.1
+
+A hot fix to bring the bot back online with `vite-node`.

docs/changelogs/1.7.2.md

@@ -0,0 +1,7 @@
+# Blitzkrieg 1.7.2
+
+A quick, tiny, cute bug fix
+
+## Fixes
+
+- Tanks now once again show up in `/tankstats`

docs/changelogs/1.7.3-1.7.4.md

@@ -0,0 +1,3 @@
+# Blitzkrieg 1.7.3 & 1.7.4
+
+These minor updates fix compatibility issues with cyclic.

docs/changelogs/1.7.5.md

@@ -0,0 +1,11 @@
+# Blitzkrieg 1.7.5
+
+This minor release aids the migration to build-based hosting.
+
+## Technical Changes
+
+- Removed `env` logging
+- Fixed constant IDs and token naming conventions
+- Moved `esbuild` to a `js` script
+- Updated the workflow to use the latest binaries
+- Added a `zip` command for `dist`

docs/changelogs/1.7.6.md

@@ -0,0 +1,14 @@
+# Blitzkrieg 1.7.6
+
+Public service announcements and a few developer quality-of-life changes.
+
+## Changes
+
+- Added a PSA system
+  - Lets me create announcements without having to release a new update every single time
+- Added fixed choices for tank stats instead of typing in numbers like before
+
+## Technical Changes
+
+- Command executions now return a payload and the executor now fully handles the interaction replies
+- The build script now skips certain steps to speed up building time when building in dev mode

docs/changelogs/1.7.7.md

@@ -0,0 +1,7 @@
+# Blitzkrieg 1.7.7
+
+A tiny fix related to hosting.
+
+## Technical Changes
+
+- `index.cjs` is now run at root instead of `dist`

docs/changelogs/1.8.0.md

@@ -0,0 +1,26 @@
+# Blitzkrieg 1.8.0
+
+A slick new command and new potentials unlocked.
+
+## Changes
+
+- Added `/ping`
+  - Allows you to see if the bot and Blitz are alive
+- Added custom periods for `/stats`
+  - To do this, `/stats` received two sub command groups: `/stats player` and `/stats tank` (hence merging the two)
+  - All periods, including cusotm ones, now live as subcommands
+- Added tier weights to `/stats`
+- Added `/evolution`
+  - Shows your winrate and battles over a period
+
+## Fixes
+
+- `Infinity` and `NaN` values now show up as `--` in `/stats`
+- WN8 shortcomings in `/eligible` now rounds to nearest integer
+- Average tiers now, once again, show up in `/stats`
+
+## Technical Changes
+
+- Dev command names are implemented centrally in `interactionCreated`
+- Abstracted the renderers of `/stats`, `/evolution`, and `/today`
+- The bot now logs the number of server it's in on start up

docs/changelogs/1.8.1.md

@@ -0,0 +1,7 @@
+# Blitzkrieg 1.8.1
+
+A tiny oversight fixed.
+
+# Fixes
+
+- The min and max dates now show up in `/evolution`

docs/changelogs/1.9.0.md

@@ -0,0 +1,32 @@
+# Blitzkrieg 1.9.0
+
+The biggest, the baddest update yet!
+
+## Changes
+
+- Spiced up `/stats` with a graphics update
+  - This command now only shows a few of the stats as most of them were pretty pointless
+- Renamed the old `/stats` to `/statsfull`
+- Added embeds for `/stats`
+  - This is a URL that can be visited to load a "naked" variant of the command that auto-refreshes with the latest data every `60` seconds meant to be used the streamers
+- Added refresh buttons to a few commands
+  - This lets you reuse a command on the click of a button
+- Fixed many readibility issues with `/evolution` thanks to @heldenklage
+
+## Fixes
+
+- Fixed several type issues for compatibility with `express`
+
+## Technical Changes
+
+- Added a seperate `server.ts` from `bot.ts`
+  - Split builds appropriately
+- Added the ability for routes to respond with svg counterparts of commands
+- Cached `tankopedia.json` and `tankaverages.json` at build time
+  - This may be reverted in a minor release i favor of `Promise<Tankopedia>`
+- Organized files as it was important to seperate the server and the bot code
+- Split `resolvePeriod` and `resolvePlayer` for command, button, and express counterparts
+- Switched a few instances of `Number(...)` to `parseInt(...)` and `parseLong(...)`
+- Disabled canary commands for the public
+- Merged `poweredBy` footers
+- `dist` now ships with a `package.json` for Cyclic

docs/changelogs/1.9.1.md

@@ -0,0 +1,3 @@
+# Blitzkrieg 1.9.1
+
+Created a website for Blitzkrieg! Check it out: https://tresabhi.github.io/blitzkrieg/

docs/changelogs/1.9.2.md

@@ -0,0 +1,5 @@
+# Blitzkrieg 1.9.2
+
+## Fixes
+
+- Implemented `/blitzkrieg/` as the base path

docs/guide/install.md

@@ -0,0 +1,17 @@
+# Installing Blitzkrieg
+
+It's easy as 1, 2, 3!
+
+## Step 1
+
+Join a server that already has Blitzkrieg or [join our official Discord server](https://discord.gg/nDt7AjGJQH).
+
+## Step 2
+
+View the bot's profile and click "Add to Server".
+
+<video src="https://i.imgur.com/Zq0P3m2.mp4" autoplay loop muted width=320 title="how to install"></video>
+
+## Step 3
+
+Review the permissions the bot is asking for and add it to your server!

docs/guide/permissions.md

@@ -0,0 +1,6 @@
+# Permissions
+
+The following Discord permissions are required by the bot to ensure full functionality:
+
+- Attach files
+- View channels

docs/index.md

@@ -0,0 +1,30 @@
+---
+# https://vitepress.dev/reference/default-theme-home-page
+layout: home
+
+hero:
+  name: 'blitzkrieg'
+  text: Everything Blitz, right in Discord
+  tagline: All-in-one Discord bot for everything World of Tanks Blitz
+  image:
+    src: '/assets/images/hero.png'
+    alt: 'blitzkrieg'
+  actions:
+    - theme: brand
+      text: Add to Discord Server
+      link: guide/install
+    - theme: alt
+      text: Guide
+      link: /guide
+
+features:
+  - title: Clean and Efficient UI
+    icon: 🚀
+    details: Blitzkrieg is where concise meets efficient. Get the information you need in the way you want.
+  - title: Endless Possibilities
+    icon: 🛠
+    details: With endless ways to customize the output, it's guaranteed that you'll always get the information you need.
+  - title: Easy to Use
+    icon: 💻
+    details: Leveraging Discord's, Blitz Stars', and Wargaming's powerful APIS, Blitzkrieg does all the hard work for you.
+---

docs/legal/privacy-policy.md

@@ -0,0 +1,23 @@
+# Blitzkrieg Privacy Policy
+
+Blitzkrieg collects little to no data. Regardless, here is an exhaustive list of Blitzkrieg's data collection practices.
+
+## Logs
+
+All Blitzkrieg logs are available to the public as an effort for open source transparency. A history of all logs [can be found on GitHub](https://github.com/tresabhi/blitzkrieg/actions/workflows/host.yml). All logs expire automatically and are permanently deleted after 30 days. However, anyone may chose to save a local copy of the logs which is not tracked by GitHub.
+
+## Commands
+
+Everytime a command a command is used, the command name and parameters provided is logged. Any identifying information like manually provided in-game usernames are also recorded.
+
+## Errors
+
+Everytime an error occurs, a detailed stack trace, scope of the error, and the error message is logged both in the GitHub logs and in the public channel [#🔲︱blitzkrieg-logs](https://discord.com/channels/734786591205359697/880650462540476416) in [the official Discord server](https://discord.gg/nDt7AjGJQH).
+
+## Databases
+
+No databases are used by Blitzkrieg meaning that no data is collected outside of what has already been mentioned above. This is no permanent state.
+
+## 3rd Party
+
+The privacy policies of Discord, Wargaming, and Blitz Stars apply too since they are utilized by the bot.

docs/legal/terms-of-service.md

@@ -0,0 +1,13 @@
+# Blitzkrieg Terms of Service
+
+## About
+
+Blitzkrieg is a multi-function Discord bot that serves users with needs specific to the game World of Tanks Blitz.
+
+## License
+
+Blitzkrieg is licensed under the MIT License.
+
+## 3rd Party
+
+The terms of services of Discord, Wargaming, and Blitz Stars apply too since they are utilized by the bot.

package.dist.json

@@ -1,6 +1,6 @@
 {
-  "main": "server.js",
+  "main": "server.cjs",
   "scripts": {
-    "start": "node --enable-source-maps server.cjs"
+    "start": "node --enable-source-maps --trace-warnings server.cjs"
   }
 }

package.json

@@ -1,15 +1,22 @@
 {
   "name": "blitzkrieg",
-  "version": "1.7.7",
+  "version": "1.9.0",
   "description": "",
-  "main": "src/index.ts",
+  "main": "src/server.ts",
   "type": "module",
   "scripts": {
-    "dev": "yarn build --dev && yarn start",
+    "build:bot": "node scripts/build --build=bot",
-    "start": "node --enable-source-maps --trace-warnings dist/index.cjs",
+    "build:server": "node scripts/build --build=server",
+    "build:docs": "vitepress build docs",
+    "build": "node scripts/build --build=all",
+    "dev:bot": "yarn build:bot --dev && yarn start:bot",
+    "dev:server": "yarn build:server --dev && yarn start:server",
+    "dev:docs": "vitepress dev docs",
+    "start:bot": "node --enable-source-maps --trace-warnings dist/bot.cjs",
+    "start:server": "node --enable-source-maps --trace-warnings dist/server.cjs",
+    "host:docs": "vitepress preview docs",
     "zip": "zip -r dist.zip dist",
-    "build": "node scripts/build",
+    "lint": "npx tsc"
-    "lint": "tsc"
   },
   "license": "MIT",
   "dependencies": {
@@ -17,21 +24,25 @@
     "@resvg/resvg-js": "^2.4.1",
     "bepaint": "^0.1.0-beta.3",
     "discord.js": "^14.9.0",
+    "esbuild": "^0.18.10",
     "escape-html": "^1.0.3",
+    "express": "^4.18.2",
     "fuzzysort": "^2.0.4",
-    "lodash.startcase": "^4.4.0",
+    "lodash": "^4.17.21",
     "markdown-escape": "^2.0.0",
     "react": "^18.2.0",
-    "satori": "^0.9.1"
+    "satori": "^0.9.1",
+    "vitepress-plugin-auto-sidebar": "^1.1.0"
   },
   "devDependencies": {
     "@total-typescript/ts-reset": "^0.4.2",
     "@types/escape-html": "^1.0.2",
-    "@types/lodash.startcase": "^4.4.7",
+    "@types/express": "^4.17.17",
+    "@types/lodash": "^4.14.195",
     "@types/markdown-escape": "^1.1.0",
     "@types/node": "^20.2.1",
     "@types/react": "^18.2.7",
-    "esbuild": "^0.17.19",
+    "typescript": "^5.0.4",
-    "typescript": "^5.0.4"
+    "vitepress": "^1.0.0-beta.3"
   }
 }

scripts/build.js

@@ -1,27 +1,87 @@
 import { build } from 'esbuild';
-import { rmSync } from 'fs';
+import { copyFile, mkdir, rm, writeFile } from 'fs/promises';
 import { argv } from 'process';
 
-const isDev = argv.includes('--dev');
+const isProd = !argv.includes('--dev');
-const isProd = !isDev;
+const buildAll = argv.includes('--build=all');
+const buildBot = argv.includes('--build=bot') | buildAll;
+const buildServer = argv.includes('--build=server') | buildAll;
 
-console.log('Removing dist...');
+if (isProd) {
-rmSync('dist', { recursive: true, force: true });
+  // only remove in production to ensure no time is wasted in dev
+  console.log('🟡 Removing dist...');
+  await rm('dist', { recursive: true, force: true });
+  console.log('✅ Dist removed');
 
-console.log('Building...');
+  console.log('🟡 Creating dist...');
-build({
+  await mkdir('dist');
-  entryPoints: ['src/index.ts'],
+  console.log('✅ Dist created');
-  outfile: 'dist/index.cjs',
 
+  console.log('🟡 Caching tankopedia...');
+  fetch('https://www.blitzstars.com/bs-tankopedia.json')
+    .then((response) => response.text())
+    .then((tankopedia) => writeFile('./dist/tankopedia.json', tankopedia))
+    .then(() => console.log('✅ Tankopedia cached'));
+
+  console.log('🟡 Caching tank averages...');
+  fetch('https://www.blitzstars.com/api/tankaverages.json')
+    .then((response) => response.json())
+    .then((individualTankAverages) => {
+      const tankAverages = {};
+
+      individualTankAverages.forEach((individualTankAverage) => {
+        tankAverages[individualTankAverage.tank_id] = individualTankAverage;
+      });
+
+      return writeFile(
+        './dist/tankaverages.json',
+        JSON.stringify(tankAverages),
+      );
+    })
+    .then(() => console.log('✅ Tank averages cached'));
+
+  console.log('🟡 Copying package.json...');
+  copyFile('package.dist.json', 'dist/package.json').then(() =>
+    console.log('✅ package.json copied'),
+  );
+}
+
+const commonOptions = {
   platform: 'node',
   loader: {
     '.node': 'copy',
     '.ttf': 'file',
   },
 
-  bundle: isProd,
+  bundle: true,
-  sourcemap: isProd,
+  sourcemap: true,
   minifyIdentifiers: false, // causes errors
   minifySyntax: isProd,
   minifyWhitespace: isProd,
-});
+
+  logLevel: isProd ? 'info' : 'silent',
+};
+
+if (buildBot) {
+  console.log('🟡 Building bot...');
+  build({
+    ...commonOptions,
+
+    entryPoints: ['src/bot.ts'],
+    outfile: 'dist/bot.cjs',
+  }).then(() => {
+    console.log('✅ Bot built');
+  });
+}
+
+if (buildServer) {
+  console.log('🟡 Building server...');
+  build({
+    ...commonOptions,
+
+    entryPoints: ['src/server.ts'],
+    outfile: 'dist/server.cjs',
+  }).then(() => {
+    console.log('✅ Server built');
+  });
+}

src/bot.ts

@@ -1,8 +1,8 @@
 import { Client, GatewayIntentBits } from 'discord.js';
-import { DISCORD_TOKEN } from './core/process/args.js';
+import { DISCORD_TOKEN } from './core/node/arguments.js';
 import { registerErrorHandlers } from './events/error.js';
 import guildMemberAdd from './events/guildMemberAdd.js';
-import interactionCreate from './events/interactionCreate.js';
+import interactionCreate from './events/interactionCreate/index.js';
 import ready from './events/ready.js';
 
 export const client = new Client({

src/commands/debug.ts

@@ -1,13 +1,12 @@
 import { SlashCommandBuilder } from 'discord.js';
 import packageJSON from '../../package.json' assert { type: 'json' };
+import { client } from '../bot.js';
 import { tankopedia } from '../core/blitz/tankopedia.js';
 import { tankAverages } from '../core/blitzstars/tankAverages.js';
-import cleanTable from '../core/interaction/cleanTable.js';
+import embedInfo from '../core/discord/embedInfo.js';
-import cmdName from '../core/interaction/cmdName.js';
+import markdownTable from '../core/discord/markdownTable.js';
-import infoEmbed from '../core/interaction/infoEmbed.js';
+import getClientId from '../core/node/getClientId.js';
-import getClientId from '../core/process/getClientId.js';
+import { CommandRegistry } from '../events/interactionCreate/index.js';
-import { CommandRegistry } from '../events/interactionCreate.js';
-import { client } from '../index.js';
 
 const executionStart = new Date().getTime();
 
@@ -17,16 +16,16 @@ export default {
   inPublic: true,
 
   command: new SlashCommandBuilder()
-    .setName(cmdName('debug'))
+    .setName('debug')
     .setDescription('Debug information about the bot'),
 
-  execute(interaction) {
+  handler(interaction) {
     const currentTime = new Date().getTime();
     const uptime = currentTime - executionStart;
 
-    return infoEmbed(
+    return embedInfo(
       `${client.user?.username} debug information`,
-      cleanTable([
+      markdownTable([
         ['Version', packageJSON.version],
         ['Client ID', getClientId()],
         ['Tag', interaction.client.user.tag],

src/commands/eligible.ts

@@ -1,20 +1,19 @@
 import { SlashCommandBuilder } from 'discord.js';
-import getBlitzAccount from '../core/blitz/getBlitzAccount.js';
+import calculateWN8 from '../core/blitz/calculateWN8.js';
-import getWN8 from '../core/blitz/getWN8.js';
 import getWargamingResponse from '../core/blitz/getWargamingResponse.js';
 import sumStats from '../core/blitz/sumStats.js';
 import { tankopedia } from '../core/blitz/tankopedia.js';
 import getPeriodNow from '../core/blitzstars/getPeriodNow.js';
-import getPeriodicStart from '../core/blitzstars/getPeriodStart.js';
+import getPeriodStart from '../core/blitzstars/getPeriodStart.js';
-import getTankStatsOverTime from '../core/blitzstars/getTankStatsOverTime.js';
+import getTankStatsDiffed from '../core/blitzstars/getTankStatsDiffed.js';
 import { tankAverages } from '../core/blitzstars/tankAverages.js';
-import cleanTable, { TableInput } from '../core/interaction/cleanTable.js';
+import addUsernameChoices from '../core/discord/addUsernameChoices.js';
-import cmdName from '../core/interaction/cmdName.js';
+import embedNegative from '../core/discord/embedNegative.js';
-import negativeEmbed from '../core/interaction/negativeEmbed.js';
+import embedPositive from '../core/discord/embedPositive.js';
-import positiveEmbed from '../core/interaction/positiveEmbed.js';
+import markdownTable, { TableInput } from '../core/discord/markdownTable.js';
-import addUsernameOption from '../core/options/addUsernameOption.js';
+import resolvePlayerFromCommand from '../core/discord/resolvePlayerFromCommand.js';
-import { WARGAMING_APPLICATION_ID } from '../core/process/args.js';
+import { WARGAMING_APPLICATION_ID } from '../core/node/arguments.js';
-import { CommandRegistry } from '../events/interactionCreate.js';
+import { CommandRegistry } from '../events/interactionCreate/index.js';
 import { AccountInfo } from '../types/accountInfo.js';
 
 export type SkilledClan = 'SKLLD' | 'SMRI';
@@ -30,7 +29,7 @@ export default {
   inPublic: false,
 
   command: new SlashCommandBuilder()
-    .setName(cmdName('eligible'))
+    .setName('eligible')
     .setDescription('Checks eligibility for any Skilled clan')
     .addStringOption((option) =>
       option
@@ -45,11 +44,11 @@ export default {
         )
         .setRequired(true),
     )
-    .addStringOption(addUsernameOption),
+    .addStringOption(addUsernameChoices),
 
-  async execute(interaction) {
+  async handler(interaction) {
     const clan = interaction.options.getString('clan') as SkilledClan;
-    const { id, server } = await getBlitzAccount(interaction);
+    const { id, server } = await resolvePlayerFromCommand(interaction);
     const accountInfo = await getWargamingResponse<AccountInfo>(
       `https://api.wotblitz.${server}/wotb/account/info/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${id}`,
     );
@@ -59,11 +58,10 @@ export default {
     let body = '';
 
     if (clan === 'SKLLD') {
-      const tankStatsOverTime = await getTankStatsOverTime(
+      const tankStatsOverTime = await getTankStatsDiffed(
-        interaction,
         server,
         id,
-        getPeriodicStart('30'),
+        getPeriodStart('30'),
         getPeriodNow(),
       );
       const entries = Object.entries(tankStatsOverTime);
@@ -81,7 +79,7 @@ export default {
 
           // edge case where new tanks don't have averages
           if (tankAverages[tankId]) {
-            const tankWN8 = getWN8(tankAverages[tankId].all, stats);
+            const tankWN8 = calculateWN8(tankAverages[tankId].all, stats);
 
             if (isNaN(tankWN8)) return accumulator;
             return accumulator + tankWN8 * stats.battles;
@@ -124,7 +122,10 @@ export default {
         ]);
       }
       if (WN8 < 2450) {
-        problems.push(['WN8', `${WN8.toFixed(0)} (${WN8 - 2450})`]);
+        problems.push([
+          'WN8',
+          `${WN8.toFixed(0)} (${(WN8 - 2450).toFixed(0)})`,
+        ]);
       }
       if (tier10Damage < 1250) {
         problems.push([
@@ -136,7 +137,7 @@ export default {
       isEligible = problems.length === 0;
       body = isEligible
         ? 'Player is fully eligible.'
-        : `Player is not eligible. Shortcomings in 30-day statistics:\n\n${cleanTable(
+        : `Player is not eligible. Shortcomings in 30-day statistics:\n\n${markdownTable(
             problems,
           )}`;
     } else if (clan === 'SMRI') {
@@ -161,11 +162,11 @@ export default {
       isEligible = problems.length === 0;
       body = isEligible
         ? 'Player is fully eligible.'
-        : `Player is not eligible. Shortcomings in career statistics:\n\n${cleanTable(
+        : `Player is not eligible. Shortcomings in career statistics:\n\n${markdownTable(
             problems,
           )}`;
     }
 
-    return (isEligible ? positiveEmbed : negativeEmbed)(title, body);
+    return (isEligible ? embedPositive : embedNegative)(title, body);
   },
 } satisfies CommandRegistry;

src/commands/evolution.tsx

@@ -0,0 +1,86 @@
+import { SlashCommandBuilder } from 'discord.js';
+import { CYCLIC_API } from '../constants/cyclic.js';
+import getWargamingResponse from '../core/blitz/getWargamingResponse.js';
+import resolveTankId from '../core/blitz/resolveTankId.js';
+import addStatTypeSubCommandGroups from '../core/discord/addStatTypeSubCommandGroups.js';
+import autocompleteTanks from '../core/discord/autocompleteTanks.js';
+import autocompleteUsername from '../core/discord/autocompleteUsername.js';
+import interactionToURL from '../core/discord/interactionToURL.js';
+import linkButton from '../core/discord/linkButton.js';
+import primaryButton from '../core/discord/primaryButton.js';
+import resolvePeriodFromButton from '../core/discord/resolvePeriodFromButton.js';
+import resolvePeriodFromCommand from '../core/discord/resolvePeriodFromCommand.js';
+import resolvePlayerFromButton from '../core/discord/resolvePlayerFromButton.js';
+import resolvePlayerFromCommand from '../core/discord/resolvePlayerFromCommand.js';
+import { WARGAMING_APPLICATION_ID } from '../core/node/arguments.js';
+import { CommandRegistry } from '../events/interactionCreate/index.js';
+import evolution from '../renderers/evolution.js';
+import { StatType } from '../renderers/statsfull.js';
+import { AccountInfo } from '../types/accountInfo.js';
+
+export default {
+  inProduction: true,
+  inDevelopment: true,
+  inPublic: true,
+
+  command: addStatTypeSubCommandGroups(
+    new SlashCommandBuilder()
+      .setName('evolution')
+      .setDescription('Evolution of statistics'),
+  ),
+
+  async handler(interaction) {
+    const commandGroup = interaction.options.getSubcommandGroup(
+      true,
+    ) as StatType;
+    const player = await resolvePlayerFromCommand(interaction);
+    const period = resolvePeriodFromCommand(interaction);
+    const tankIdRaw = interaction.options.getString('tank')!;
+    const tankId = commandGroup === 'tank' ? resolveTankId(tankIdRaw) : null;
+    const start = interaction.options.getInteger('start');
+    const end = interaction.options.getInteger('end');
+    const { nickname } = (
+      await getWargamingResponse<AccountInfo>(
+        `https://api.wotblitz.${player.server}/wotb/account/info/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${player.id}`,
+      )
+    )[player.id];
+    const path = interactionToURL(interaction, {
+      ...player,
+      tankId,
+      start,
+      end,
+    });
+
+    return [
+      await evolution(commandGroup, period, player, tankId),
+      primaryButton(path, 'Refresh'),
+      // linkButton(`${CYCLIC_API}/${path}`, 'Embed'),
+      linkButton(
+        `https://www.blitzstars.com/player/${player.server}/${nickname}${
+          commandGroup === 'tank' ? `/tank/${tankId!}` : ''
+        }`,
+        'BlitzStars',
+      ),
+    ];
+  },
+
+  autocomplete: (interaction) => {
+    autocompleteUsername(interaction);
+    autocompleteTanks(interaction);
+  },
+
+  async button(interaction) {
+    const url = new URL(`${CYCLIC_API}/${interaction.customId}`);
+    const path = url.pathname.split('/').filter(Boolean);
+    const commandGroup = path[1] as StatType;
+    const period = resolvePeriodFromButton(interaction);
+    const player = await resolvePlayerFromButton(interaction);
+
+    return await evolution(
+      commandGroup,
+      period,
+      player,
+      parseInt(url.searchParams.get('tankId')!),
+    );
+  },
+} satisfies CommandRegistry;

src/commands/help.ts

@@ -1,13 +1,12 @@
 import { SlashCommandBuilder } from 'discord.js';
 import discord from '../../discord.json' assert { type: 'json' };
-import cmdName from '../core/interaction/cmdName.js';
+import { client } from '../bot.js';
-import infoEmbed from '../core/interaction/infoEmbed.js';
+import embedInfo from '../core/discord/embedInfo.js';
 import {
   CommandRegistry,
   guildCommands,
   publicCommands,
-} from '../events/interactionCreate.js';
+} from '../events/interactionCreate/index.js';
-import { client } from '../index.js';
 
 export default {
   inProduction: true,
@@ -15,11 +14,11 @@ export default {
   inPublic: true,
 
   command: new SlashCommandBuilder()
-    .setName(cmdName('help'))
+    .setName('help')
     .setDescription('All the help you need about the bot'),
 
-  execute(interaction) {
+  handler(interaction) {
-    return infoEmbed(
+    return embedInfo(
       `${client.user?.username} help`,
       `**About**\n${
         client.user?.username

src/commands/inactive.tsx

@@ -1,17 +1,16 @@
 import { SlashCommandBuilder } from 'discord.js';
 import GenericStats from '../components/GenericStats/index.js';
 import NoData, { NoDataType } from '../components/NoData.js';
-import PoweredByWargaming from '../components/PoweredByWargaming.js';
+import PoweredBy, { PoweredByType } from '../components/PoweredBy.js';
 import TitleBar from '../components/TitleBar.js';
 import Wrapper from '../components/Wrapper.js';
 import { BLITZ_SERVERS } from '../constants/servers.js';
-import clanAutocomplete from '../core/autocomplete/clan.js';
 import getBlitzClan from '../core/blitz/getBlitzClan.js';
 import getWargamingResponse from '../core/blitz/getWargamingResponse.js';
-import cmdName from '../core/interaction/cmdName.js';
+import addClanChoices from '../core/discord/addClanChoices.js';
-import addClanChoices from '../core/options/addClanChoices.js';
+import autocompleteClan from '../core/discord/autocompleteClan.js';
-import { WARGAMING_APPLICATION_ID } from '../core/process/args.js';
+import { WARGAMING_APPLICATION_ID } from '../core/node/arguments.js';
-import { CommandRegistry } from '../events/interactionCreate.js';
+import { CommandRegistry } from '../events/interactionCreate/index.js';
 import { AccountInfo } from '../types/accountInfo.js';
 import { ClanInfo } from '../types/clanInfo.js';
 
@@ -23,7 +22,7 @@ export default {
   inPublic: true,
 
   command: new SlashCommandBuilder()
-    .setName(cmdName('inactive'))
+    .setName('inactive')
     .setDescription('Lists all inactive players')
     .addStringOption(addClanChoices)
     .addNumberOption((option) =>
@@ -35,9 +34,9 @@ export default {
         .setMinValue(0),
     ),
 
-  async execute(interaction) {
+  async handler(interaction) {
     const clanName = interaction.options.getString('clan')!;
-    const { server, id } = await getBlitzClan(interaction, clanName);
+    const { server, id } = await getBlitzClan(clanName);
     const threshold =
       interaction.options.getNumber('threshold')! ?? DEFAULT_THRESHOLD;
     const time = new Date().getTime() / 1000;
@@ -80,10 +79,10 @@ export default {
         {!hasInactiveMembers && <NoData type={NoDataType.PlayersInPeriod} />}
         {hasInactiveMembers && <GenericStats stats={inactive} />}
 
-        <PoweredByWargaming />
+        <PoweredBy type={PoweredByType.Wargaming} />
       </Wrapper>
     );
   },
 
-  autocomplete: clanAutocomplete,
+  autocomplete: autocompleteClan,
 } satisfies CommandRegistry;

src/commands/ownedtanks.tsx

@@ -1,19 +1,22 @@
 import { SlashCommandBuilder } from 'discord.js';
 import NoData, { NoDataType } from '../components/NoData.js';
-import PoweredByWargaming from '../components/PoweredByWargaming.js';
+import PoweredBy, { PoweredByType } from '../components/PoweredBy.js';
 import * as Tanks from '../components/Tanks/index.js';
 import TitleBar from '../components/TitleBar.js';
 import Wrapper from '../components/Wrapper.js';
 import { BLITZ_SERVERS } from '../constants/servers.js';
-import usernameAutocomplete from '../core/autocomplete/username.js';
-import getBlitzAccount from '../core/blitz/getBlitzAccount.js';
 import getTankStats from '../core/blitz/getTankStats.js';
 import getWargamingResponse from '../core/blitz/getWargamingResponse.js';
-import { TIER_ROMAN_NUMERALS, tankopedia } from '../core/blitz/tankopedia.js';
+import {
-import cmdName from '../core/interaction/cmdName.js';
+  TIER_ROMAN_NUMERALS,
-import addUsernameOption from '../core/options/addUsernameOption.js';
+  Tier,
-import { WARGAMING_APPLICATION_ID } from '../core/process/args.js';
+  tankopedia,
-import { CommandRegistry } from '../events/interactionCreate.js';
+} from '../core/blitz/tankopedia.js';
+import addUsernameChoices from '../core/discord/addUsernameChoices.js';
+import autocompleteUsername from '../core/discord/autocompleteUsername.js';
+import resolvePlayerFromCommand from '../core/discord/resolvePlayerFromCommand.js';
+import { WARGAMING_APPLICATION_ID } from '../core/node/arguments.js';
+import { CommandRegistry } from '../events/interactionCreate/index.js';
 import { AccountInfo } from '../types/accountInfo.js';
 import { PlayerClanData } from '../types/playerClanData.js';
 
@@ -44,7 +47,7 @@ export default {
   inPublic: true,
 
   command: new SlashCommandBuilder()
-    .setName(cmdName('ownedtanks'))
+    .setName('ownedtanks')
     .setDescription("Shows a player's owned tanks")
     .addStringOption((option) =>
       option
@@ -64,16 +67,16 @@ export default {
         )
         .setRequired(true),
     )
-    .addStringOption(addUsernameOption),
+    .addStringOption(addUsernameChoices),
 
-  async execute(interaction) {
+  async handler(interaction) {
     const tier = Number(interaction.options.getString('tier'));
-    const account = await getBlitzAccount(interaction);
+    const account = await resolvePlayerFromCommand(interaction);
     const { id, server } = account;
     const accountInfo = await getWargamingResponse<AccountInfo>(
       `https://api.wotblitz.${server}/wotb/account/info/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${id}`,
     );
-    const tankStats = await getTankStats(interaction, server, id);
+    const tankStats = await getTankStats(server, id);
     const tanks = tankStats
       .map((tankData) => tankopedia[tankData.tank_id])
       .filter((tank) => tank?.tier === tier);
@@ -86,7 +89,7 @@ export default {
         {/* TODO: integrate some of these into title bar */}
         <TitleBar
           name={accountInfo[id].nickname}
-          nameDiscriminator={`(Tier ${TIER_ROMAN_NUMERALS[tier]})`}
+          nameDiscriminator={`(Tier ${TIER_ROMAN_NUMERALS[tier as Tier]})`}
           image={
             clanData[id]?.clan
               ? `https://wotblitz-gc.gcdn.co/icons/clanEmblems1x/clan-icon-v2-${clanData[id]?.clan?.emblem_set_id}.png`
@@ -112,10 +115,10 @@ export default {
           </Tanks.Root>
         )}
 
-        <PoweredByWargaming />
+        <PoweredBy type={PoweredByType.Wargaming} />
       </Wrapper>
     );
   },
 
-  autocomplete: usernameAutocomplete,
+  autocomplete: autocompleteUsername,
 } satisfies CommandRegistry;

src/commands/ping.ts

@@ -0,0 +1,33 @@
+import { SlashCommandBuilder } from 'discord.js';
+import { CommandRegistry } from '../events/interactionCreate/index.js';
+
+export default {
+  inProduction: true,
+  inDevelopment: false,
+  inPublic: true,
+  handlesInteraction: true,
+
+  command: new SlashCommandBuilder()
+    .setName('ping')
+    .setDescription('Check if the bot is alive')
+    .addSubcommand((option) =>
+      option.setName('blitzkrieg').setDescription('Ping Blitzkrieg'),
+    )
+    .addSubcommand((option) =>
+      option.setName('blitz').setDescription('Ping Blitz'),
+    ),
+
+  async handler(interaction) {
+    const subcommand = interaction.options.getSubcommand();
+    const executionStart = Date.now();
+
+    if (subcommand === 'blitzkrieg') {
+      await interaction.editReply('Pong 🏓');
+    } else {
+      await fetch('https://api.wotblitz.com/');
+    }
+
+    const executionTime = Date.now() - executionStart;
+    interaction.editReply(`Pong 🏓 - ${executionTime}ms`);
+  },
+} satisfies CommandRegistry<true>;

src/commands/playerachievements.ts

@@ -1,15 +1,16 @@
 import { SlashCommandBuilder } from 'discord.js';
-import startCase from 'lodash.startcase';
+import { startCase } from 'lodash';
 import markdownEscape from 'markdown-escape';
-import usernameAutocomplete from '../core/autocomplete/username.js';
-import getBlitzAccount from '../core/blitz/getBlitzAccount.js';
 import getWargamingResponse from '../core/blitz/getWargamingResponse.js';
-import cleanTable, { TableInputEntry } from '../core/interaction/cleanTable.js';
+import addUsernameChoices from '../core/discord/addUsernameChoices.js';
-import cmdName from '../core/interaction/cmdName.js';
+import autocompleteUsername from '../core/discord/autocompleteUsername.js';
-import infoEmbed from '../core/interaction/infoEmbed.js';
+import embedInfo from '../core/discord/embedInfo.js';
-import addUsernameOption from '../core/options/addUsernameOption.js';
+import markdownTable, {
-import { WARGAMING_APPLICATION_ID } from '../core/process/args.js';
+  TableInputEntry,
-import { CommandRegistry } from '../events/interactionCreate.js';
+} from '../core/discord/markdownTable.js';
+import resolvePlayerFromCommand from '../core/discord/resolvePlayerFromCommand.js';
+import { WARGAMING_APPLICATION_ID } from '../core/node/arguments.js';
+import { CommandRegistry } from '../events/interactionCreate/index.js';
 import { AccountAchievements } from '../types/accountAchievements.js';
 import { AccountInfo } from '../types/accountInfo.js';
 
@@ -21,9 +22,9 @@ export default {
   inPublic: true,
 
   command: new SlashCommandBuilder()
-    .setName(cmdName('playerachievements'))
+    .setName('playerachievements')
     .setDescription("All the player's achievements")
-    .addStringOption(addUsernameOption)
+    .addStringOption(addUsernameChoices)
     .addStringOption((option) =>
       option
         .setName('sort')
@@ -34,9 +35,9 @@ export default {
         ),
     ),
 
-  async execute(interaction) {
+  async handler(interaction) {
     const sortBy = (interaction.options.getString('sort') ?? 'name') as SortBy;
-    const account = await getBlitzAccount(interaction);
+    const account = await resolvePlayerFromCommand(interaction);
     const { id, server } = account;
     const accounts = await getWargamingResponse<AccountInfo>(
       `https://api.wotblitz.${server}/wotb/account/info/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${id}`,
@@ -51,10 +52,10 @@ export default {
       ...accountAchievements.max_series,
     };
 
-    return infoEmbed(
+    return embedInfo(
       `${markdownEscape(accounts[id].nickname)}'s information`,
 
-      cleanTable(
+      markdownTable(
         Object.keys(compound)
           .filter((achievement) => compound[achievement] > 0)
           .sort(
@@ -73,5 +74,5 @@ export default {
     );
   },
 
-  autocomplete: usernameAutocomplete,
+  autocomplete: autocompleteUsername,
 } satisfies CommandRegistry;

src/commands/playerinfo.ts

@@ -1,14 +1,13 @@
 import { SlashCommandBuilder } from 'discord.js';
 import markdownEscape from 'markdown-escape';
-import usernameAutocomplete from '../core/autocomplete/username.js';
-import getBlitzAccount from '../core/blitz/getBlitzAccount.js';
 import getWargamingResponse from '../core/blitz/getWargamingResponse.js';
-import cleanTable from '../core/interaction/cleanTable.js';
+import addUsernameChoices from '../core/discord/addUsernameChoices.js';
-import cmdName from '../core/interaction/cmdName.js';
+import autocompleteUsername from '../core/discord/autocompleteUsername.js';
-import infoEmbed from '../core/interaction/infoEmbed.js';
+import embedInfo from '../core/discord/embedInfo.js';
-import addUsernameOption from '../core/options/addUsernameOption.js';
+import markdownTable from '../core/discord/markdownTable.js';
-import { WARGAMING_APPLICATION_ID } from '../core/process/args.js';
+import resolvePlayerFromCommand from '../core/discord/resolvePlayerFromCommand.js';
-import { CommandRegistry } from '../events/interactionCreate.js';
+import { WARGAMING_APPLICATION_ID } from '../core/node/arguments.js';
+import { CommandRegistry } from '../events/interactionCreate/index.js';
 import { AccountInfo } from '../types/accountInfo.js';
 
 export default {
@@ -17,22 +16,22 @@ export default {
   inPublic: true,
 
   command: new SlashCommandBuilder()
-    .setName(cmdName('playerinfo'))
+    .setName('playerinfo')
     .setDescription('Basic information about a player')
-    .addStringOption(addUsernameOption),
+    .addStringOption(addUsernameChoices),
 
-  async execute(interaction) {
+  async handler(interaction) {
-    const account = await getBlitzAccount(interaction);
+    const account = await resolvePlayerFromCommand(interaction);
     const { id, server } = account;
     const accounts = await getWargamingResponse<AccountInfo>(
       `https://api.wotblitz.${server}/wotb/account/info/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${id}`,
     );
     const accountInfo = accounts[id];
 
-    return infoEmbed(
+    return embedInfo(
       `${markdownEscape(accountInfo.nickname)}'s information`,
 
-      cleanTable([
+      markdownTable([
         ['Nickname', `${accountInfo.nickname}`],
         ['Battles', `${accountInfo.statistics.all.battles}`],
         [
@@ -57,5 +56,5 @@ export default {
     );
   },
 
-  autocomplete: usernameAutocomplete,
+  autocomplete: autocompleteUsername,
 } satisfies CommandRegistry;

src/commands/searchclans.ts

@@ -2,12 +2,11 @@ import { SlashCommandBuilder } from 'discord.js';
 import markdownEscape from 'markdown-escape';
 import { BLITZ_SERVERS, BlitzServer } from '../constants/servers.js';
 import getWargamingResponse from '../core/blitz/getWargamingResponse.js';
-import cmdName from '../core/interaction/cmdName.js';
+import addClanChoices from '../core/discord/addClanChoices.js';
-import infoEmbed from '../core/interaction/infoEmbed.js';
+import addServerChoices from '../core/discord/addServerChoices.js';
-import addClanChoices from '../core/options/addClanChoices.js';
+import embedInfo from '../core/discord/embedInfo.js';
-import addServerChoices from '../core/options/addServerChoices.js';
+import { WARGAMING_APPLICATION_ID } from '../core/node/arguments.js';
-import { WARGAMING_APPLICATION_ID } from '../core/process/args.js';
+import { CommandRegistry } from '../events/interactionCreate/index.js';
-import { CommandRegistry } from '../events/interactionCreate.js';
 import { ClanList } from '../types/clanList.js';
 
 export default {
@@ -16,7 +15,7 @@ export default {
   inPublic: true,
 
   command: new SlashCommandBuilder()
-    .setName(cmdName('searchclans'))
+    .setName('searchclans')
     .setDescription('Search clans')
     .addStringOption(addServerChoices)
     .addStringOption((option) => addClanChoices(option).setAutocomplete(false))
@@ -28,7 +27,7 @@ export default {
         .setMaxValue(100),
     ),
 
-  async execute(interaction) {
+  async handler(interaction) {
     const server = interaction.options.getString('server') as BlitzServer;
     const clan = interaction.options.getString('clan')!;
     const limit = interaction.options.getInteger('limit') ?? 25;
@@ -36,7 +35,7 @@ export default {
       `https://api.wotblitz.${server}/wotb/clans/list/?application_id=${WARGAMING_APPLICATION_ID}&search=${clan}&limit=${limit}`,
     );
 
-    return infoEmbed(
+    return embedInfo(
       `Clan search for "${markdownEscape(clan)}" in ${BLITZ_SERVERS[server]}`,
       clanList.length === 0
         ? 'No clans found.'

src/commands/searchplayers.ts

@@ -2,13 +2,12 @@ import { SlashCommandBuilder } from 'discord.js';
 import markdownEscape from 'markdown-escape';
 import { BLITZ_SERVERS, BlitzServer } from '../constants/servers.js';
 import getWargamingResponse from '../core/blitz/getWargamingResponse.js';
-import { usernamePattern } from '../core/blitz/listAccountsPanServer.js';
+import { usernamePattern } from '../core/blitz/listPlayers.js';
-import cmdName from '../core/interaction/cmdName.js';
+import addServerChoices from '../core/discord/addServerChoices.js';
-import infoEmbed from '../core/interaction/infoEmbed.js';
+import addUsernameChoices from '../core/discord/addUsernameChoices.js';
-import addServerChoices from '../core/options/addServerChoices.js';
+import embedInfo from '../core/discord/embedInfo.js';
-import addUsernameOption from '../core/options/addUsernameOption.js';
+import { WARGAMING_APPLICATION_ID } from '../core/node/arguments.js';
-import { WARGAMING_APPLICATION_ID } from '../core/process/args.js';
+import { CommandRegistry } from '../events/interactionCreate/index.js';
-import { CommandRegistry } from '../events/interactionCreate.js';
 import { AccountList } from '../types/accountList.js';
 
 export default {
@@ -17,11 +16,11 @@ export default {
   inPublic: true,
 
   command: new SlashCommandBuilder()
-    .setName(cmdName('searchplayers'))
+    .setName('searchplayers')
     .setDescription('Search players in a Blitz server')
     .addStringOption(addServerChoices)
     .addStringOption((option) =>
-      addUsernameOption(option).setAutocomplete(false).setRequired(true),
+      addUsernameChoices(option).setAutocomplete(false).setRequired(true),
     )
     .addIntegerOption((option) =>
       option
@@ -31,7 +30,7 @@ export default {
         .setMaxValue(100),
     ),
 
-  async execute(interaction) {
+  async handler(interaction) {
     const server = interaction.options.getString('server') as BlitzServer;
     const name = interaction.options.getString('username')!;
     const limit = interaction.options.getInteger('limit') ?? 25;
@@ -44,7 +43,7 @@ export default {
         )
       : [];
 
-    return infoEmbed(
+    return embedInfo(
       `Player search for "${markdownEscape(name)}" in ${BLITZ_SERVERS[server]}`,
       `\`\`\`${
         players.length === 0

src/commands/searchtanks.ts

@@ -2,10 +2,9 @@ import { SlashCommandBuilder } from 'discord.js';
 import { go } from 'fuzzysort';
 import markdownEscape from 'markdown-escape';
 import { TANK_NAMES } from '../core/blitz/tankopedia.js';
-import cmdName from '../core/interaction/cmdName.js';
+import addTankChoices from '../core/discord/addTankChoices.js';
-import infoEmbed from '../core/interaction/infoEmbed.js';
+import embedInfo from '../core/discord/embedInfo.js';
-import addTankChoices from '../core/options/addTankChoices.js';
+import { CommandRegistry } from '../events/interactionCreate/index.js';
-import { CommandRegistry } from '../events/interactionCreate.js';
 
 export default {
   inProduction: true,
@@ -13,7 +12,7 @@ export default {
   inPublic: true,
 
   command: new SlashCommandBuilder()
-    .setName(cmdName('searchtanks'))
+    .setName('searchtanks')
     .setDescription('Search tanks')
     .addStringOption((option) => addTankChoices(option).setAutocomplete(false))
     .addIntegerOption((option) =>
@@ -24,14 +23,14 @@ export default {
         .setMaxValue(100),
     ),
 
-  async execute(interaction) {
+  async handler(interaction) {
     const tank = interaction.options.getString('tank')!;
     const limit = interaction.options.getInteger('limit') ?? 25;
     const results = go(tank, TANK_NAMES, { limit }).map(
       (result) => result.target,
     );
 
-    return infoEmbed(
+    return embedInfo(
       `Tank search for "${markdownEscape(tank)}"`,
       results.length === 0
         ? 'No tanks found.'

src/commands/stats.tsx

@@ -1,165 +1,84 @@
 import { SlashCommandBuilder } from 'discord.js';
-import GenericAllStats from '../components/GenericAllStats.js';
+import { CYCLIC_API } from '../constants/cyclic.js';
-import NoData, { NoDataType } from '../components/NoData.js';
-import PoweredByBlitzStars from '../components/PoweredByBlitzStars.js';
-import TitleBar from '../components/TitleBar.js';
-import Wrapper from '../components/Wrapper.js';
-import { BLITZ_SERVERS } from '../constants/servers.js';
-import usernameAutocomplete from '../core/autocomplete/username.js';
-import getBlitzAccount from '../core/blitz/getBlitzAccount.js';
-import getTankStats from '../core/blitz/getTankStats.js';
-import getWN8 from '../core/blitz/getWN8.js';
 import getWargamingResponse from '../core/blitz/getWargamingResponse.js';
-import sumStats from '../core/blitz/sumStats.js';
+import resolveTankId from '../core/blitz/resolveTankId.js';
-import { tankopedia } from '../core/blitz/tankopedia.js';
+import addStatTypeSubCommandGroups from '../core/discord/addStatTypeSubCommandGroups.js';
-import getPeriodNow from '../core/blitzstars/getPeriodNow.js';
+import autocompleteTanks from '../core/discord/autocompleteTanks.js';
-import getPeriodicStart from '../core/blitzstars/getPeriodStart.js';
+import autocompleteUsername from '../core/discord/autocompleteUsername.js';
-import getTankStatsOverTime from '../core/blitzstars/getTankStatsOverTime.js';
+import interactionToURL from '../core/discord/interactionToURL.js';
-import { tankAverages } from '../core/blitzstars/tankAverages.js';
+import linkButton from '../core/discord/linkButton.js';
-import cmdName from '../core/interaction/cmdName.js';
+import primaryButton from '../core/discord/primaryButton.js';
-import fullBlitzStarsStats from '../core/interaction/fullBlitzStarsStats.js';
+import resolvePeriodFromButton from '../core/discord/resolvePeriodFromButton.js';
-import { supportBlitzStars } from '../core/interaction/supportBlitzStars.js';
+import resolvePeriodFromCommand from '../core/discord/resolvePeriodFromCommand.js';
-import addStatPeriodChoices, {
+import resolvePlayerFromButton from '../core/discord/resolvePlayerFromButton.js';
-  StatPeriod,
+import resolvePlayerFromCommand from '../core/discord/resolvePlayerFromCommand.js';
-  statPeriodNames,
+import { WARGAMING_APPLICATION_ID } from '../core/node/arguments.js';
-} from '../core/options/addStatPeriodChoices.js';
+import { CommandRegistry } from '../events/interactionCreate/index.js';
-import addUsernameOption from '../core/options/addUsernameOption.js';
+import stats from '../renderers/stats.js';
-import { WARGAMING_APPLICATION_ID } from '../core/process/args.js';
+import { StatType } from '../renderers/statsfull.js';
-import { CommandRegistry } from '../events/interactionCreate.js';
+import { AccountInfo } from '../types/accountInfo.js';
-import {
-  AccountInfo,
-  AllStats,
-  SupplementaryStats,
-} from '../types/accountInfo.js';
-import { PlayerClanData } from '../types/playerClanData.js';
 
 export default {
   inProduction: true,
-  inDevelopment: false,
+  inDevelopment: true,
   inPublic: true,
 
-  command: new SlashCommandBuilder()
+  command: addStatTypeSubCommandGroups(
-    .setName(cmdName('stats'))
+    new SlashCommandBuilder()
-    .setDescription("Gets the user's in-game statistics")
+      .setName('stats')
-    .addStringOption(addStatPeriodChoices)
+      .setDescription('In-game statistics'),
-    .addStringOption(addUsernameOption),
+  ),
 
-  async execute(interaction) {
+  async handler(interaction) {
-    const period = interaction.options.getString('period') as StatPeriod;
+    const commandGroup = interaction.options.getSubcommandGroup(
-    const { id, server } = await getBlitzAccount(interaction);
+      true,
-    const accountInfo = await getWargamingResponse<AccountInfo>(
+    ) as StatType;
-      `https://api.wotblitz.${server}/wotb/account/info/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${id}`,
+    const player = await resolvePlayerFromCommand(interaction);
-    );
+    const period = resolvePeriodFromCommand(interaction);
-    const clanData = await getWargamingResponse<PlayerClanData>(
+    const tankIdRaw = interaction.options.getString('tank')!;
-      `https://api.wotblitz.${server}/wotb/clans/accountinfo/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${id}&extra=clan`,
+    const tankId = commandGroup === 'tank' ? resolveTankId(tankIdRaw) : null;
-    );
+    const start = interaction.options.getInteger('start');
-    const tankStats = await getTankStats(interaction, server, id);
+    const end = interaction.options.getInteger('end');
-    let stats: AllStats;
+    const path = interactionToURL(interaction, {
-    let supplementaryStats: SupplementaryStats | undefined;
+      ...player,
-    let hasWN8AccumulatedAtAll = false;
+      tankId,
-
+      start,
-    if (period === 'career') {
+      end,
-      stats = accountInfo[id].statistics.all;
+    });
-      const totalBattles = tankStats.reduce(
+    const { nickname } = (
-        (accumulator, { all }) => accumulator + all.battles,
+      await getWargamingResponse<AccountInfo>(
-        0,
+        `https://api.wotblitz.${player.server}/wotb/account/info/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${player.id}`,
-      );
+      )
-
+    )[player.id];
-      supplementaryStats = {
-        tier:
-          tankStats.reduce(
-            (accumulator, { tank_id, all }) =>
-              accumulator + tankopedia[tank_id].tier * all.battles,
-            0,
-          ) / totalBattles,
-        WN8:
-          tankStats.reduce((accumulator, { tank_id, all }) => {
-            if (tankAverages[tank_id]) {
-              const tankWN8 = getWN8(tankAverages[tank_id].all, all);
-
-              if (isNaN(tankWN8)) return accumulator;
-
-              hasWN8AccumulatedAtAll = true;
-
-              return accumulator + tankWN8 * all.battles;
-            } else return accumulator;
-          }, 0) / totalBattles,
-      };
-    } else {
-      const tankStatsOverTime = await getTankStatsOverTime(
-        interaction,
-        server,
-        id,
-        getPeriodicStart(period),
-        getPeriodNow(),
-      );
-      const entries = Object.entries(tankStatsOverTime);
-      const totalBattles = entries.reduce(
-        (accumulator, [, stats]) => accumulator + stats.battles,
-        0,
-      );
-
-      supplementaryStats = {
-        tier:
-          entries.reduce((accumulator, [tankIdString, stats]) => {
-            const tankId = parseInt(tankIdString);
-            const tankTier = tankopedia[tankId].tier;
-
-            return accumulator + tankTier * stats.battles;
-          }, 0) / totalBattles,
-        WN8:
-          entries.reduce((accumulator, [tankIdString, stats]) => {
-            const tankId = parseInt(tankIdString);
-
-            // edge case where new tanks don't have averages
-            if (tankAverages[tankId]) {
-              const tankWN8 = getWN8(tankAverages[tankId].all, stats);
-
-              if (isNaN(tankWN8)) return accumulator;
-
-              hasWN8AccumulatedAtAll = true;
-
-              return accumulator + tankWN8 * stats.battles;
-            } else return accumulator;
-          }, 0) / totalBattles,
-      };
-
-      stats = sumStats(entries.map(([, stats]) => stats));
-    }
-
-    if (!hasWN8AccumulatedAtAll) supplementaryStats.WN8 = undefined;
 
     return [
-      <Wrapper>
+      await stats(commandGroup, period, player, tankId),
-        <TitleBar
+      primaryButton(path, 'Refresh'),
-          name={accountInfo[id].nickname}
+      linkButton(`${CYCLIC_API}/${path}`, 'Embed'),
-          nameDiscriminator={
+      linkButton(
-            clanData[id]?.clan ? `[${clanData[id]?.clan?.tag}]` : undefined
+        `https://www.blitzstars.com/player/${player.server}/${nickname}`,
-          }
+        'BlitzStars',
-          image={
+      ),
-            clanData[id]?.clan
-              ? `https://wotblitz-gc.gcdn.co/icons/clanEmblems1x/clan-icon-v2-${clanData[id]?.clan?.emblem_set_id}.png`
-              : undefined
-          }
-          description={`${
-            statPeriodNames[period]
-          } • ${new Date().toDateString()} • ${BLITZ_SERVERS[server]}`}
-        />
-
-        {stats.battles === 0 && <NoData type={NoDataType.BattlesInPeriod} />}
-        {stats.battles > 0 && (
-          <GenericAllStats
-            stats={stats}
-            supplementaryStats={supplementaryStats}
-          />
-        )}
-
-        <PoweredByBlitzStars />
-      </Wrapper>,
-      fullBlitzStarsStats(server, accountInfo[id].nickname),
-      supportBlitzStars,
     ];
   },
 
-  autocomplete: usernameAutocomplete,
+  autocomplete: (interaction) => {
+    autocompleteUsername(interaction);
+    autocompleteTanks(interaction);
+  },
+
+  async button(interaction) {
+    const url = new URL(`${CYCLIC_API}/${interaction.customId}`);
+    const path = url.pathname.split('/').filter(Boolean);
+    const commandGroup = path[1] as StatType;
+    const period = resolvePeriodFromButton(interaction);
+    const player = await resolvePlayerFromButton(interaction);
+
+    return await stats(
+      commandGroup,
+      period,
+      player,
+      parseInt(url.searchParams.get('tankId')!),
+    );
+  },
 } satisfies CommandRegistry;

src/commands/statsfull.tsx

@@ -0,0 +1,83 @@
+import { SlashCommandBuilder } from 'discord.js';
+import { CYCLIC_API } from '../constants/cyclic.js';
+import getWargamingResponse from '../core/blitz/getWargamingResponse.js';
+import resolveTankId from '../core/blitz/resolveTankId.js';
+import addStatTypeSubCommandGroups from '../core/discord/addStatTypeSubCommandGroups.js';
+import autocompleteTanks from '../core/discord/autocompleteTanks.js';
+import autocompleteUsername from '../core/discord/autocompleteUsername.js';
+import interactionToURL from '../core/discord/interactionToURL.js';
+import linkButton from '../core/discord/linkButton.js';
+import primaryButton from '../core/discord/primaryButton.js';
+import resolvePeriodFromButton from '../core/discord/resolvePeriodFromButton.js';
+import resolvePeriodFromCommand from '../core/discord/resolvePeriodFromCommand.js';
+import resolvePlayerFromButton from '../core/discord/resolvePlayerFromButton.js';
+import resolvePlayerFromCommand from '../core/discord/resolvePlayerFromCommand.js';
+import { WARGAMING_APPLICATION_ID } from '../core/node/arguments.js';
+import { CommandRegistry } from '../events/interactionCreate/index.js';
+import statsfull, { StatType } from '../renderers/statsfull.js';
+import { AccountInfo } from '../types/accountInfo.js';
+
+export default {
+  inProduction: true,
+  inDevelopment: false,
+  inPublic: true,
+
+  command: addStatTypeSubCommandGroups(
+    new SlashCommandBuilder()
+      .setName('statsfull')
+      .setDescription('Full in-game statistics'),
+  ),
+
+  async handler(interaction) {
+    const commandGroup = interaction.options.getSubcommandGroup(
+      true,
+    ) as StatType;
+    const player = await resolvePlayerFromCommand(interaction);
+    const period = resolvePeriodFromCommand(interaction);
+    const tankIdRaw = interaction.options.getString('tank')!;
+    const tankId = commandGroup === 'tank' ? resolveTankId(tankIdRaw) : null;
+    const start = interaction.options.getInteger('start');
+    const end = interaction.options.getInteger('end');
+    const path = interactionToURL(interaction, {
+      ...player,
+      tankId,
+      start,
+      end,
+    });
+    const { nickname } = (
+      await getWargamingResponse<AccountInfo>(
+        `https://api.wotblitz.${player.server}/wotb/account/info/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${player.id}`,
+      )
+    )[player.id];
+
+    return [
+      await statsfull(commandGroup, period, player, tankId),
+      primaryButton(path, 'Refresh'),
+      // linkButton(`${CYCLIC_API}/${path}`, 'Embed'),
+      linkButton(
+        `https://www.blitzstars.com/player/${player.server}/${nickname}`,
+        'BlitzStars',
+      ),
+    ];
+  },
+
+  autocomplete: (interaction) => {
+    autocompleteUsername(interaction);
+    autocompleteTanks(interaction);
+  },
+
+  async button(interaction) {
+    const url = new URL(`${CYCLIC_API}/${interaction.customId}`);
+    const path = url.pathname.split('/').filter(Boolean);
+    const commandGroup = path[1] as StatType;
+    const period = resolvePeriodFromButton(interaction);
+    const player = await resolvePlayerFromButton(interaction);
+
+    return await statsfull(
+      commandGroup,
+      period,
+      player,
+      parseInt(url.searchParams.get('tankId')!),
+    );
+  },
+} satisfies CommandRegistry;

src/commands/tankstats.tsx

@@ -1,112 +0,0 @@
-import { SlashCommandBuilder } from 'discord.js';
-import GenericAllStats from '../components/GenericAllStats.js';
-import NoData, { NoDataType } from '../components/NoData.js';
-import PoweredByBlitzStars from '../components/PoweredByBlitzStars.js';
-import TitleBar from '../components/TitleBar.js';
-import Wrapper from '../components/Wrapper.js';
-import { BLITZ_SERVERS } from '../constants/servers.js';
-import tanksAutocomplete from '../core/autocomplete/tanks.js';
-import usernameAutocomplete from '../core/autocomplete/username.js';
-import getBlitzAccount from '../core/blitz/getBlitzAccount.js';
-import getTankStats from '../core/blitz/getTankStats.js';
-import getWN8 from '../core/blitz/getWN8.js';
-import getWargamingResponse from '../core/blitz/getWargamingResponse.js';
-import resolveTankId from '../core/blitz/resolveTankId.js';
-import resolveTankName from '../core/blitz/resolveTankName.js';
-import { tankopedia } from '../core/blitz/tankopedia.js';
-import getPeriodNow from '../core/blitzstars/getPeriodNow.js';
-import getPeriodicStart from '../core/blitzstars/getPeriodStart.js';
-import getTankStatsOverTime, {
-  emptyAllStats,
-} from '../core/blitzstars/getTankStatsOverTime.js';
-import { tankAverages } from '../core/blitzstars/tankAverages.js';
-import cmdName from '../core/interaction/cmdName.js';
-import fullBlitzStarsStats from '../core/interaction/fullBlitzStarsStats.js';
-import { supportBlitzStars } from '../core/interaction/supportBlitzStars.js';
-import addStatPeriodChoices, {
-  StatPeriod,
-  statPeriodNames,
-} from '../core/options/addStatPeriodChoices.js';
-import addTankChoices from '../core/options/addTankChoices.js';
-import addUsernameOption from '../core/options/addUsernameOption.js';
-import { WARGAMING_APPLICATION_ID } from '../core/process/args.js';
-import { CommandRegistry } from '../events/interactionCreate.js';
-import { AccountInfo, AllStats } from '../types/accountInfo.js';
-
-export default {
-  inProduction: true,
-  inDevelopment: false,
-  inPublic: true,
-
-  command: new SlashCommandBuilder()
-    .setName(cmdName('tankstats'))
-    .setDescription('Stats for a tank over a period')
-    .addStringOption(addTankChoices)
-    .addStringOption(addStatPeriodChoices)
-    .addStringOption(addUsernameOption),
-
-  async execute(interaction) {
-    const tank = await resolveTankId(
-      interaction,
-      interaction.options.getString('tank')!,
-    );
-    const period = interaction.options.getString('period') as StatPeriod;
-    const blitzAccount = await getBlitzAccount(interaction);
-    const { id, server } = blitzAccount;
-    const accountInfo = await getWargamingResponse<AccountInfo>(
-      `https://api.wotblitz.${server}/wotb/account/info/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${id}`,
-    );
-    const tankStats = await getTankStats(interaction, server, id);
-    let stats: AllStats;
-    const tankId = Number(tank);
-
-    if (period === 'career') {
-      stats =
-        tankStats.find((stats) => stats.tank_id === tankId)?.all ??
-        emptyAllStats;
-    } else {
-      const tankStatsOverTime = await getTankStatsOverTime(
-        interaction,
-        server,
-        id,
-        getPeriodicStart(period),
-        getPeriodNow(),
-      );
-
-      stats = tankStatsOverTime[tankId] ?? emptyAllStats;
-    }
-
-    return [
-      <Wrapper>
-        <TitleBar
-          name={accountInfo[id].nickname}
-          nameDiscriminator={`(${resolveTankName(tankId)})`}
-          image={tankopedia[tankId].images.normal}
-          description={`${
-            statPeriodNames[period]
-          } • ${new Date().toDateString()} • ${BLITZ_SERVERS[server]}`}
-        />
-
-        {stats.battles === 0 && <NoData type={NoDataType.BattlesInPeriod} />}
-        {stats.battles > 0 && (
-          <GenericAllStats
-            stats={stats}
-            supplementaryStats={{
-              tier: tankopedia[tankId].tier,
-              WN8: getWN8(tankAverages[tankId].all, stats),
-            }}
-          />
-        )}
-
-        <PoweredByBlitzStars />
-      </Wrapper>,
-      fullBlitzStarsStats(server, accountInfo[id].nickname),
-      supportBlitzStars,
-    ];
-  },
-
-  autocomplete: (interaction) => {
-    tanksAutocomplete(interaction);
-    usernameAutocomplete(interaction);
-  },
-} satisfies CommandRegistry;

src/commands/today.tsx

@@ -1,29 +1,16 @@
 import { SlashCommandBuilder } from 'discord.js';
-import * as Breakdown from '../components/Breakdown/index.js';
-import NoData, { NoDataType } from '../components/NoData.js';
-import PoweredByBlitzStars from '../components/PoweredByBlitzStars.js';
-import TitleBar from '../components/TitleBar.js';
-import Wrapper from '../components/Wrapper.js';
-import { BLITZ_SERVERS } from '../constants/servers.js';
-import usernameAutocomplete from '../core/autocomplete/username.js';
-import getBlitzAccount from '../core/blitz/getBlitzAccount.js';
-import getTankStats from '../core/blitz/getTankStats.js';
-import getWN8 from '../core/blitz/getWN8.js';
 import getWargamingResponse from '../core/blitz/getWargamingResponse.js';
-import resolveTankName from '../core/blitz/resolveTankName.js';
+import addUsernameChoices from '../core/discord/addUsernameChoices.js';
-import sumStats from '../core/blitz/sumStats.js';
+import autocompleteUsername from '../core/discord/autocompleteUsername.js';
-import { tankopedia } from '../core/blitz/tankopedia.js';
+import interactionToURL from '../core/discord/interactionToURL.js';
-import getTankStatsOverTime from '../core/blitzstars/getTankStatsOverTime.js';
+import linkButton from '../core/discord/linkButton.js';
-import last5AM from '../core/blitzstars/last5AM.js';
+import primaryButton from '../core/discord/primaryButton.js';
-import { tankAverages } from '../core/blitzstars/tankAverages.js';
+import resolvePlayerFromButton from '../core/discord/resolvePlayerFromButton.js';
-import cmdName from '../core/interaction/cmdName.js';
+import resolvePlayerFromCommand from '../core/discord/resolvePlayerFromCommand.js';
-import fullBlitzStarsStats from '../core/interaction/fullBlitzStarsStats.js';
+import { WARGAMING_APPLICATION_ID } from '../core/node/arguments.js';
-import { supportBlitzStars } from '../core/interaction/supportBlitzStars.js';
+import { CommandRegistry } from '../events/interactionCreate/index.js';
-import addUsernameOption from '../core/options/addUsernameOption.js';
+import today from '../renderers/today.js';
-import { WARGAMING_APPLICATION_ID } from '../core/process/args.js';
+import { AccountInfo } from '../types/accountInfo.js';
-import { CommandRegistry } from '../events/interactionCreate.js';
-import { AccountInfo, AllStats } from '../types/accountInfo.js';
-import { PlayerClanData } from '../types/playerClanData.js';
 
 export default {
   inProduction: true,
@@ -31,155 +18,35 @@ export default {
   inPublic: true,
 
   command: new SlashCommandBuilder()
-    .setName(cmdName('today'))
+    .setName('today')
     .setDescription('A general daily breakdown of your performance')
-    .addStringOption(addUsernameOption),
+    .addStringOption(addUsernameChoices),
 
-  async execute(interaction) {
+  async handler(interaction) {
-    const { id, server } = await getBlitzAccount(interaction);
+    const player = await resolvePlayerFromCommand(interaction);
-    const tankStatsOverTime = await getTankStatsOverTime(
+    const { nickname } = (
-      interaction,
+      await getWargamingResponse<AccountInfo>(
-      server,
+        `https://api.wotblitz.${player.server}/wotb/account/info/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${player.id}`,
-      id,
+      )
-      last5AM().getTime() / 1000,
+    )[player.id];
-      new Date().getTime() / 1000,
+    const path = interactionToURL(interaction, player);
-    );
-    const accountInfo = await getWargamingResponse<AccountInfo>(
-      `https://api.wotblitz.${server}/wotb/account/info/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${id}`,
-    );
-    const clanData = await getWargamingResponse<PlayerClanData>(
-      `https://api.wotblitz.${server}/wotb/clans/accountinfo/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${id}&extra=clan`,
-    );
-    const careerTankStatsRaw = await getTankStats(interaction, server, id);
-    const careerStats: Record<number, AllStats> = {
-      0: accountInfo[id].statistics.all,
-    };
-    const allStatsToAccumulate: AllStats[] = [];
-
-    Object.entries(tankStatsOverTime).forEach(([, tankStats]) => {
-      allStatsToAccumulate.push(tankStats);
-    });
-    Object.entries(careerTankStatsRaw).forEach(([, tankStats]) => {
-      careerStats[tankStats.tank_id] = tankStats.all;
-    });
-
-    const accumulatedStats = sumStats(allStatsToAccumulate);
-
-    if (Object.keys(tankStatsOverTime).length > 0) {
-      tankStatsOverTime[0] = accumulatedStats;
-    }
-
-    const tankStatsOverTimeEntries = Object.entries(tankStatsOverTime);
-    const todayWN8s = tankStatsOverTimeEntries.reduce<Record<number, number>>(
-      (accumulator, [tankIdString, tankStats]) => {
-        const tankId = Number(tankIdString);
-
-        return tankId === 0 || tankAverages[tankId] === undefined
-          ? accumulator
-          : {
-              ...accumulator,
-              [tankId]: getWN8(tankAverages[tankId].all, tankStats),
-            };
-      },
-      {},
-    );
-    const careerWN8s = careerTankStatsRaw.reduce<Record<number, number>>(
-      (accumulator, { tank_id }) => {
-        return tank_id === 0 || tankAverages[tank_id] === undefined
-          ? accumulator
-          : {
-              ...accumulator,
-              [tank_id]: getWN8(
-                tankAverages[tank_id].all,
-                careerStats[tank_id],
-              ),
-            };
-      },
-      {},
-    );
-    const todayWN8sEntries = Object.entries(todayWN8s);
-    const careerWN8sEntries = Object.entries(careerWN8s);
-
-    todayWN8s[0] =
-      todayWN8sEntries.reduce(
-        (accumulator, [tankIdString, wn8]) =>
-          accumulator + wn8 * tankStatsOverTime[Number(tankIdString)].battles,
-        0,
-      ) /
-      todayWN8sEntries.reduce(
-        (accumulator, [tankIdString]) =>
-          accumulator + tankStatsOverTime[Number(tankIdString)].battles,
-        0,
-      );
-    careerWN8s[0] =
-      careerWN8sEntries.reduce(
-        (accumulator, [tankIdString, WN8]) =>
-          isNaN(WN8)
-            ? accumulator
-            : accumulator + WN8 * careerStats[Number(tankIdString)].battles,
-        0,
-      ) /
-      careerWN8sEntries.reduce(
-        (accumulator, [tankIdString, WN8]) =>
-          isNaN(WN8)
-            ? accumulator
-            : accumulator + careerStats[Number(tankIdString)].battles,
-        0,
-      );
-
-    const rows = tankStatsOverTimeEntries.map(([tankIdString, tankStats]) => {
-      const tankId = Number(tankIdString);
-      const career = careerStats[tankId];
-
-      return (
-        <Breakdown.Row
-          key={tankId}
-          name={tankId === 0 ? 'Total' : resolveTankName(Number(tankIdString))}
-          winrate={tankStats.wins / tankStats.battles}
-          careerWinrate={career.wins / career.battles}
-          WN8={isNaN(todayWN8s[tankId]) ? undefined : todayWN8s[tankId]}
-          careerWN8={isNaN(careerWN8s[tankId]) ? undefined : careerWN8s[tankId]}
-          damage={tankStats.damage_dealt / tankStats.battles}
-          careerDamage={career.damage_dealt / career.battles}
-          survival={tankStats.survived_battles / tankStats.battles}
-          careerSurvival={career.survived_battles / career.battles}
-          battles={tankStats.battles}
-          careerBattles={career.battles}
-          icon={
-            tankId === 0
-              ? undefined
-              : tankopedia[tankIdString as unknown as number].images.normal
-          }
-        />
-      );
-    });
 
     return [
-      <Wrapper>
+      await today(player),
-        <TitleBar
+      primaryButton(path, 'Refresh'),
-          name={accountInfo[id].nickname}
+      // linkButton(`${CYCLIC_API}/${path}`, 'Embed'),
-          nameDiscriminator={
+      linkButton(
-            clanData[id]?.clan ? `[${clanData[id]?.clan?.tag}]` : undefined
+        `https://www.blitzstars.com/player/${player.server}/${nickname}`,
-          }
+        'BlitzStars',
-          image={
+      ),
-            clanData[id]?.clan
-              ? `https://wotblitz-gc.gcdn.co/icons/clanEmblems1x/clan-icon-v2-${clanData[id]?.clan?.emblem_set_id}.png`
-              : undefined
-          }
-          description={`Today's breakdown • ${new Date().toDateString()} • ${
-            BLITZ_SERVERS[server]
-          }`}
-        />
-
-        {rows.length === 0 && <NoData type={NoDataType.BattlesInPeriod} />}
-        {rows.length > 0 && <Breakdown.Root>{rows}</Breakdown.Root>}
-
-        <PoweredByBlitzStars />
-      </Wrapper>,
-      fullBlitzStarsStats(server, accountInfo[id].nickname),
-      supportBlitzStars,
     ];
   },
 
-  autocomplete: usernameAutocomplete,
+  autocomplete: autocompleteUsername,
+
+  async button(interaction) {
+    const player = await resolvePlayerFromButton(interaction);
+
+    return await today(player);
+  },
 } satisfies CommandRegistry;

src/commands/verify.ts

@@ -1,15 +1,14 @@
 import { SlashCommandBuilder } from 'discord.js';
 import markdownEscape from 'markdown-escape';
 import discord from '../../discord.json' assert { type: 'json' };
-import usernameAutocomplete from '../core/autocomplete/username.js';
-import getBlitzAccount from '../core/blitz/getBlitzAccount.js';
 import getWargamingResponse from '../core/blitz/getWargamingResponse.js';
-import cmdName from '../core/interaction/cmdName.js';
+import addUsernameChoices from '../core/discord/addUsernameChoices.js';
-import negativeEmbed from '../core/interaction/negativeEmbed.js';
+import autocompleteUsername from '../core/discord/autocompleteUsername.js';
-import positiveEmbed from '../core/interaction/positiveEmbed.js';
+import embedNegative from '../core/discord/embedNegative.js';
-import addUsernameOption from '../core/options/addUsernameOption.js';
+import embedPositive from '../core/discord/embedPositive.js';
-import { WARGAMING_APPLICATION_ID } from '../core/process/args.js';
+import resolvePlayerFromCommand from '../core/discord/resolvePlayerFromCommand.js';
-import { CommandRegistry } from '../events/interactionCreate.js';
+import { WARGAMING_APPLICATION_ID } from '../core/node/arguments.js';
+import { CommandRegistry } from '../events/interactionCreate/index.js';
 import { AccountInfo } from '../types/accountInfo.js';
 import { PlayerClanData } from '../types/playerClanData.js';
 
@@ -19,12 +18,12 @@ export default {
   inPublic: true,
 
   command: new SlashCommandBuilder()
-    .setName(cmdName('verify'))
+    .setName('verify')
     .setDescription("Set's the user's username to their in-game name")
-    .addStringOption((option) => addUsernameOption(option).setRequired(true)),
+    .addStringOption((option) => addUsernameChoices(option).setRequired(true)),
 
-  async execute(interaction) {
+  async handler(interaction) {
-    const blitzAccount = await getBlitzAccount(interaction);
+    const blitzAccount = await resolvePlayerFromCommand(interaction);
     const { id, server } = blitzAccount;
     const accountInfo = await getWargamingResponse<AccountInfo>(
       `https://api.wotblitz.${server}/wotb/account/info/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${id}`,
@@ -39,13 +38,13 @@ export default {
       interaction.guild?.members.cache.get(interaction.member?.user.id);
 
     if (!interaction.guild?.members.me?.permissions.has('ManageNicknames')) {
-      return negativeEmbed(
+      return embedNegative(
         `${markdownEscape(interaction.user.username)} failed to verify`,
         "I don't have the permission to change your nickname.",
       );
     }
     if (!interaction.member || !member) {
-      return negativeEmbed(
+      return embedNegative(
         `${interaction.user.username} is not in this server`,
         "I couldn't find this person in this server. Did they leave?",
       );
@@ -56,7 +55,7 @@ export default {
 
       if (interaction.guildId === discord.sklld_guild_id) {
         if (!interaction.guild?.members.me?.permissions.has('ManageRoles')) {
-          return negativeEmbed(
+          return embedNegative(
             `${markdownEscape(interaction.user.username)} failed to verify`,
             "I don't have the permission to change your manage roles.",
           );
@@ -66,19 +65,19 @@ export default {
         await member.roles.add(discord.sklld_peasant_role);
       }
 
-      return positiveEmbed(
+      return embedPositive(
         `${interaction.user.username} is verified`,
         `The user is now verified as ${markdownEscape(
           accountInfo[id].nickname,
         )}${markdownEscape(clanTag)}`,
       );
     } catch (error) {
-      return negativeEmbed(
+      return embedNegative(
         `${interaction.user.username} failed to verify`,
         "I can't change your nickname because you have higher permissions than me. Try setting your nickname to your Blitz username manually.",
       );
     }
   },
 
-  autocomplete: usernameAutocomplete,
+  autocomplete: autocompleteUsername,
 } satisfies CommandRegistry;

src/components/AllStatsOverview/components/WN8Display/components/Glow.tsx

@@ -0,0 +1,39 @@
+import { Percentile } from '../../../../../constants/percentiles.js';
+import hslToHex from '../../../../../core/node/hslToHex.js';
+import { PERCENTILE_COLORS } from '../../../../PercentileIndicator.js';
+
+export enum GlowSide {
+  Top,
+  Bottom,
+}
+
+export interface GlowProps {
+  percentile: Percentile;
+  side: GlowSide;
+}
+
+export function Glow({ percentile, side }: GlowProps) {
+  const color = PERCENTILE_COLORS[percentile];
+  const color1 = hslToHex(color);
+  const color2 = `${color1}00`;
+
+  const background = `linear-gradient(${
+    side === GlowSide.Top ? 0 : 180
+  }deg, ${color1} 0%, ${color2} 100%)`;
+
+  return (
+    <div
+      style={{
+        display: 'flex',
+        alignItems: side === GlowSide.Top ? 'flex-end' : 'flex-start',
+        justifyContent: 'center',
+      }}
+    >
+      <div style={{ height: 54, width: 16, background }} />
+      <div style={{ height: 72, width: 16, background }} />
+      <div style={{ height: 80, width: 16, background }} />
+      <div style={{ height: 72, width: 16, background }} />
+      <div style={{ height: 54, width: 16, background }} />
+    </div>
+  );
+}

src/components/AllStatsOverview/components/WN8Display/index.tsx

@@ -0,0 +1,77 @@
+import { Percentile } from '../../../../constants/percentiles.js';
+import getWN8Percentile from '../../../../core/blitz/getWN8Percentile.js';
+import { theme } from '../../../../stitches.config.js';
+import { PERCENTILE_COLORS } from '../../../PercentileIndicator.js';
+import { Glow, GlowSide } from './components/Glow.js';
+
+export interface WN8DisplayProps {
+  WN8?: number;
+}
+
+export const PERCENTILE_NAMES = {
+  [Percentile.VeryBad]: 'Very Bad',
+  [Percentile.Bad]: 'Bad',
+  [Percentile.BelowAverage]: 'Below Average',
+  [Percentile.Average]: 'Average',
+  [Percentile.AboveAverage]: 'Above Average',
+  [Percentile.Good]: 'Good',
+  [Percentile.VeryGood]: 'Very Good',
+  [Percentile.Great]: 'Great',
+  [Percentile.Unicum]: 'Unicum',
+  [Percentile.SuperUnicum]: 'Super Unicum',
+};
+
+export function WN8Display({ WN8 }: WN8DisplayProps) {
+  const percentile =
+    WN8 === undefined ? Percentile.VeryBad : getWN8Percentile(WN8);
+  const color = PERCENTILE_COLORS[percentile];
+
+  return (
+    <div
+      style={{
+        width: 128 * 2, // idk why twice the width turns into the correct width
+        display: 'flex',
+        flexDirection: 'column',
+        alignItems: 'center',
+        justifyContent: 'center',
+        gap: -16,
+      }}
+    >
+      <Glow percentile={percentile} side={GlowSide.Top} />
+
+      <div
+        style={{
+          width: 128,
+          height: 80,
+          backgroundColor: color,
+          borderRadius: 40,
+          display: 'flex',
+          flexDirection: 'column',
+          alignItems: 'center',
+          justifyContent: 'center',
+          gap: -4,
+        }}
+      >
+        <span
+          style={{
+            fontWeight: 900,
+            fontSize: 32,
+            color: theme.colors.textHighContrast,
+          }}
+        >
+          {WN8 === undefined ? '--' : WN8.toFixed(0)}
+        </span>
+        <span
+          style={{
+            fontSize: 16,
+            color: theme.colors.textHighContrast,
+          }}
+        >
+          {PERCENTILE_NAMES[percentile]}
+        </span>
+      </div>
+
+      <Glow percentile={percentile} side={GlowSide.Bottom} />
+    </div>
+  );
+}

src/components/AllStatsOverview/components/WN8SurroundingStat.tsx

@@ -0,0 +1,47 @@
+import { theme } from '../../../stitches.config.js';
+
+export enum WN8SurroundingStatAlign {
+  Left,
+  Right,
+}
+
+export interface WN8SurroundingStatProps {
+  label: string;
+  value: string | number;
+  align?: WN8SurroundingStatAlign;
+  padded?: boolean;
+}
+
+export function WN8SurroundingStat({
+  label,
+  value,
+  align = WN8SurroundingStatAlign.Left,
+  padded = false,
+}: WN8SurroundingStatProps) {
+  return (
+    <div
+      style={{
+        display: 'flex',
+        flexDirection: 'column',
+        alignItems:
+          align === WN8SurroundingStatAlign.Left ? 'flex-start' : 'flex-end',
+        paddingLeft: padded && align === WN8SurroundingStatAlign.Left ? 32 : 0,
+        paddingRight:
+          padded && align === WN8SurroundingStatAlign.Right ? 32 : 0,
+      }}
+    >
+      <span
+        style={{
+          color: theme.colors.textHighContrast,
+          fontSize: 24,
+          fontWeight: 'bold',
+        }}
+      >
+        {value}
+      </span>
+      <span style={{ color: theme.colors.textLowContrast, fontSize: 16 }}>
+        {label}
+      </span>
+    </div>
+  );
+}

src/components/AllStatsOverview/index.tsx

@@ -0,0 +1,96 @@
+import { AllStats, SupplementaryStats } from '../../types/accountInfo.js';
+import { WN8Display } from './components/WN8Display/index.js';
+import {
+  WN8SurroundingStat,
+  WN8SurroundingStatAlign,
+} from './components/WN8SurroundingStat.js';
+
+export interface AllStatsOverviewProps {
+  stats: AllStats;
+  supplementaryStats: SupplementaryStats;
+}
+
+export default function AllStatsOverview({
+  stats,
+  supplementaryStats,
+}: AllStatsOverviewProps) {
+  return (
+    <div
+      style={{
+        display: 'flex',
+        gap: -64,
+        width: '100%',
+      }}
+    >
+      <div
+        style={{
+          display: 'flex',
+          flexDirection: 'column',
+          gap: 8,
+          alignItems: 'flex-end',
+          flex: 1,
+        }}
+      >
+        <WN8SurroundingStat
+          label="Battles"
+          value={stats.battles.toLocaleString()}
+          align={WN8SurroundingStatAlign.Right}
+        />
+        <WN8SurroundingStat
+          label="Winrate"
+          value={`${(100 * (stats.wins / stats.battles)).toFixed(2)}%`}
+          align={WN8SurroundingStatAlign.Right}
+          padded
+        />
+        <WN8SurroundingStat
+          label="Damage"
+          value={Math.round(
+            stats.damage_dealt / stats.battles,
+          ).toLocaleString()}
+          align={WN8SurroundingStatAlign.Right}
+          padded
+        />
+        <WN8SurroundingStat
+          label="Dmg. ratio"
+          value={(stats.damage_dealt / stats.damage_received).toFixed(2)}
+          align={WN8SurroundingStatAlign.Right}
+        />
+      </div>
+
+      <WN8Display WN8={supplementaryStats.WN8} />
+
+      <div
+        style={{
+          display: 'flex',
+          flexDirection: 'column',
+          gap: 8,
+          flex: 1,
+        }}
+      >
+        <WN8SurroundingStat
+          label="Tier"
+          value={supplementaryStats.tier.toFixed(2)}
+        />
+        <WN8SurroundingStat
+          label="Survival"
+          value={`${(100 * (stats.survived_battles / stats.battles)).toFixed(
+            2,
+          )}%`}
+          padded
+        />
+        <WN8SurroundingStat
+          label="Accuracy"
+          value={`${(100 * (stats.hits / stats.shots)).toFixed(2)}%`}
+          padded
+        />
+        <WN8SurroundingStat
+          label="Kill ratio"
+          value={(
+            stats.frags /
+            (stats.battles - stats.survived_battles)
+          ).toFixed(2)}
+        />
+      </div>
+    </div>
+  );
+}

src/components/GenericAllStats.tsx

@@ -1,4 +1,5 @@
 import getWN8Percentile from '../core/blitz/getWN8Percentile.js';
+import isNumber from '../core/node/isNumber.js';
 import { AllStats, SupplementaryStats } from '../types/accountInfo.js';
 import GenericStats from './GenericStats/index.js';
 
@@ -11,6 +12,10 @@ export default function GenericAllStats({
   stats,
   supplementaryStats,
 }: GenericAllStatsProps) {
+  const damageRatio = stats.damage_dealt / stats.damage_received;
+  const killsToDeathRatio =
+    stats.frags / (stats.battles - stats.survived_battles);
+
   return (
     <GenericStats
       stats={[
@@ -18,13 +23,13 @@ export default function GenericAllStats({
         [
           'WN8',
           supplementaryStats
-            ? supplementaryStats.WN8 === undefined
+            ? isNumber(supplementaryStats.WN8)
-              ? '--'
+              ? supplementaryStats.WN8!.toFixed(0)
-              : supplementaryStats.WN8.toFixed(0)
+              : '--'
+            : undefined,
+          isNumber(supplementaryStats?.WN8)
+            ? getWN8Percentile(supplementaryStats!.WN8!)
             : undefined,
-          supplementaryStats?.WN8 === undefined
-            ? undefined
-            : getWN8Percentile(supplementaryStats.WN8),
         ],
         [
           'Survival',
@@ -41,13 +46,10 @@ export default function GenericAllStats({
         ['Average hits', (stats.hits / stats.battles).toFixed(2)],
         ['Average kills', (stats.frags / stats.battles).toFixed(2)],
         ['Average spots', (stats.spotted / stats.battles).toFixed(2)],
-        [
+        ['Damage ratio', isFinite(damageRatio) ? damageRatio.toFixed(2) : '--'],
-          'Damage ratio',
-          (stats.damage_dealt / stats.damage_received).toFixed(2),
-        ],
         [
           'Kills to death ratio',
-          (stats.frags / (stats.battles - stats.survived_battles)).toFixed(2),
+          isFinite(killsToDeathRatio) ? killsToDeathRatio.toFixed(2) : '--',
         ],
       ]}
     />

src/components/GenericStats/components/GenericStatsRow.tsx

@@ -1,8 +1,6 @@
 import { theme } from '../../../stitches.config.js';
-import { Stat } from '../index.js';
-
-import '../../../core/blitz/getWN8Percentile.js';
 import PercentileIndicator from '../../PercentileIndicator.js';
+import { Stat } from '../index.js';
 
 export interface GenericStatsRowProps {
   stat: Stat;

src/components/Graph/components/Line.tsx

@@ -0,0 +1,77 @@
+import { blue, green, red, slateDark } from '@radix-ui/colors';
+import { GRAPH_HEIGHT, GRAPH_WIDTH } from './Root.js';
+
+export enum LineColor {
+  Red,
+  Green,
+  Blue,
+  White,
+}
+
+const LINE_COLORS = {
+  [LineColor.Red]: red.red9,
+  [LineColor.Green]: green.green9,
+  [LineColor.Blue]: blue.blue9,
+  [LineColor.White]: slateDark.slate11,
+};
+
+export enum LineStyle {
+  Solid,
+  Dashes,
+  DashesAndDots,
+}
+
+const LINE_STYLES = {
+  [LineStyle.Solid]: undefined,
+  [LineStyle.Dashes]: '8, 8',
+  [LineStyle.DashesAndDots]: '1, 4, 8, 4',
+};
+
+export type PlotItem = [number, number];
+export type Plot = PlotItem[];
+
+export interface LineProps {
+  plot: Plot;
+  minY?: number;
+  maxY?: number;
+  color?: LineColor;
+  style?: LineStyle;
+  lineWidth?: number;
+}
+
+export function Line({
+  plot,
+  minY: providedMinY,
+  maxY: providedMaxY,
+  color = LineColor.Red,
+  style = LineStyle.Solid,
+  lineWidth = 2,
+}: LineProps) {
+  const xs = plot.map(([x]) => x);
+  const minX = Math.min(...xs);
+  const maxX = Math.max(...xs);
+  const ys = plot.map(([, y]) => y);
+  const minY = providedMinY ?? Math.min(...ys);
+  const maxY = providedMaxY ?? Math.max(...ys);
+  const rangeX = maxX - minX;
+  const rangeY = maxY - minY;
+  const points = plot
+    .map(
+      ([x, y]) =>
+        `${(x - minX) * (GRAPH_WIDTH / rangeX)},${
+          GRAPH_HEIGHT - (y - minY) * (GRAPH_HEIGHT / rangeY)
+        }`,
+    )
+    .join(' ');
+
+  return (
+    <polyline
+      vector-effect="non-scaling-stroke"
+      fill="none"
+      stroke={LINE_COLORS[color]}
+      stroke-width={lineWidth}
+      stroke-dasharray={LINE_STYLES[style]}
+      points={points}
+    />
+  );
+}

src/components/Graph/components/Margin.tsx

@@ -0,0 +1,53 @@
+import { times } from 'lodash';
+import { theme } from '../../../stitches.config.js';
+import { MarginInputProps } from './Root.js';
+
+export enum MarginOrientation {
+  Vertical,
+  Horizontal,
+}
+
+export interface MarginProps extends MarginInputProps {
+  verticalSeparations: number;
+  orientation?: MarginOrientation;
+}
+
+export function Margin({
+  verticalSeparations,
+  max,
+  min,
+  suffix,
+  precision = 0,
+  orientation = MarginOrientation.Vertical,
+}: MarginProps) {
+  const isVertical = orientation === MarginOrientation.Vertical;
+
+  return (
+    <div
+      style={{
+        paddingLeft: isVertical ? 0 : 64,
+        width: isVertical ? 48 : '100%',
+        display: 'flex',
+        flexDirection: isVertical ? 'column' : 'row-reverse',
+        justifyContent: 'space-between',
+      }}
+    >
+      {times(verticalSeparations, (index) => (
+        <span
+          key={index}
+          style={{
+            fontSize: 16,
+            color: theme.colors.textLowContrast,
+          }}
+        >
+          {`${(
+            (max - min) *
+              ((verticalSeparations - (index + 1)) /
+                (verticalSeparations - 1)) +
+            min
+          ).toFixed(precision)}${suffix ?? ''}`}
+        </span>
+      ))}
+    </div>
+  );
+}

src/components/Graph/components/Root.tsx

@@ -0,0 +1,93 @@
+import { times } from 'lodash';
+import { ReactNode } from 'react';
+import { theme } from '../../../stitches.config.js';
+import { Margin, MarginOrientation } from './Margin.js';
+
+export const GRAPH_WIDTH = 544;
+export const GRAPH_HEIGHT = 320;
+
+export interface MarginInputProps {
+  min: number;
+  max: number;
+  suffix?: string;
+  precision?: number;
+}
+
+export interface RootProps {
+  children: ReactNode;
+  verticalMargin?: MarginInputProps;
+  horizontalMargin?: MarginInputProps;
+  separations?: number;
+  xMinLabel: string;
+  xMaxLabel: string;
+}
+
+export function Root({
+  children,
+  verticalMargin,
+  horizontalMargin,
+  separations = 5,
+  xMinLabel,
+  xMaxLabel,
+}: RootProps) {
+  return (
+    <div style={{ display: 'flex', flexDirection: 'column', gap: 16 }}>
+      <div
+        style={{
+          paddingLeft: 64,
+          display: 'flex',
+          justifyContent: 'space-between',
+        }}
+      >
+        <span style={{ fontSize: 16, color: theme.colors.textLowContrast }}>
+          {xMinLabel}
+        </span>
+        <span style={{ fontSize: 16, color: theme.colors.textLowContrast }}>
+          {xMaxLabel}
+        </span>
+      </div>
+
+      <div style={{ display: 'flex', gap: 16 }}>
+        {verticalMargin && (
+          <Margin {...verticalMargin} verticalSeparations={separations} />
+        )}
+
+        <svg
+          viewBox={`0 0 ${GRAPH_WIDTH} ${GRAPH_HEIGHT}`}
+          preserveAspectRatio="none"
+          style={{
+            flex: 1,
+            backgroundColor: theme.colors.appBackground2,
+            borderRadius: 4,
+            border: theme.borderStyles.nonInteractive,
+          }}
+        >
+          {times(separations - 2, (index) => {
+            const y = GRAPH_HEIGHT * ((index + 1) / (separations - 1));
+
+            return (
+              <polyline
+                key={index}
+                vector-effect="non-scaling-stroke"
+                fill="none"
+                stroke={theme.colors.borderNonInteractive}
+                stroke-width="2"
+                points={`0,${y}, ${GRAPH_WIDTH},${y}`}
+              />
+            );
+          })}
+
+          {children}
+        </svg>
+      </div>
+
+      {horizontalMargin && (
+        <Margin
+          {...horizontalMargin}
+          verticalSeparations={separations}
+          orientation={MarginOrientation.Horizontal}
+        />
+      )}
+    </div>
+  );
+}

src/components/Graph/index.ts

@@ -0,0 +1,3 @@
+export * from './components/Line.js';
+export * from './components/Margin.js';
+export * from './components/Root.js';

src/components/PoweredBy.tsx

@@ -0,0 +1,38 @@
+import { ReactNode } from 'react';
+import { theme } from '../stitches.config.js';
+
+export enum PoweredByType {
+  BlitzStars,
+  Wargaming,
+}
+
+export interface PoweredByProps {
+  type: PoweredByType;
+  footer?: ReactNode;
+}
+
+const POWERED_BY_IMAGES: Record<PoweredByType, string> = {
+  [PoweredByType.BlitzStars]:
+    'https://www.blitzstars.com/assets/images/4b4cb591.TankyMcPewpew.png',
+  [PoweredByType.Wargaming]: 'https://i.imgur.com/jADGWm0.png',
+};
+
+const POWERED_BY_NAMES: Record<PoweredByType, string> = {
+  [PoweredByType.BlitzStars]: 'BlitzStars',
+  [PoweredByType.Wargaming]: 'Wargaming',
+};
+
+export default function PoweredBy({ type, footer }: PoweredByProps) {
+  return (
+    <div style={{ display: 'flex', justifyContent: 'space-between' }}>
+      <div style={{ display: 'flex' }}>{footer}</div>
+
+      <div style={{ display: 'flex', gap: 4 }}>
+        <img src={POWERED_BY_IMAGES[type]} style={{ height: 16, width: 16 }} />
+        <span style={{ color: theme.colors.textLowContrast, fontSize: 16 }}>
+          Powered by {POWERED_BY_NAMES[type]}
+        </span>
+      </div>
+    </div>
+  );
+}

src/components/PoweredByBlitzStars.tsx

@@ -1,15 +0,0 @@
-import { theme } from '../stitches.config.js';
-
-export default function PoweredByBlitzStars() {
-  return (
-    <div style={{ display: 'flex', gap: 4, justifyContent: 'flex-end' }}>
-      <img
-        src="https://www.blitzstars.com/assets/images/4b4cb591.TankyMcPewpew.png"
-        style={{ height: 16, width: 16 }}
-      />
-      <span style={{ color: theme.colors.textLowContrast, fontSize: 16 }}>
-        Powered by BlitzStars
-      </span>
-    </div>
-  );
-}

src/components/PoweredByWargaming.tsx

@@ -1,15 +0,0 @@
-import { theme } from '../stitches.config.js';
-
-export default function PoweredByWargaming() {
-  return (
-    <div style={{ display: 'flex', gap: 4, justifyContent: 'flex-end' }}>
-      <img
-        src="https://i.imgur.com/jADGWm0.png"
-        style={{ height: 16, width: 16 }}
-      />
-      <span style={{ color: theme.colors.textLowContrast, fontSize: 16 }}>
-        Powered by Wargaming
-      </span>
-    </div>
-  );
-}

src/components/TierWeights.tsx

@@ -0,0 +1,34 @@
+import { TIER_ROMAN_NUMERALS, Tier } from '../core/blitz/tankopedia.js';
+import { themeLight } from '../stitches.config.js';
+
+export type TierWeightsRecord = Partial<Record<Tier, number>>;
+
+export interface TierWeightsProps {
+  weights: TierWeightsRecord;
+}
+
+export default function TierWeights({ weights }: TierWeightsProps) {
+  return (
+    <div style={{ display: 'flex', gap: 8 }}>
+      {Object.entries(weights).map(([tier, weight]) => (
+        <div
+          key={tier}
+          style={{
+            backgroundColor: themeLight.colors.appBackground1,
+            flex: weight,
+            color: themeLight.colors.textHighContrast,
+            display: 'flex',
+            alignItems: 'center',
+            justifyContent: 'center',
+            fontSize: 16,
+            overflow: 'hidden',
+            borderRadius: 8,
+            minWidth: 16,
+          }}
+        >
+          {TIER_ROMAN_NUMERALS[parseInt(tier) as Tier]}
+        </div>
+      ))}
+    </div>
+  );
+}

src/components/TitleBar.tsx

@@ -1,4 +1,4 @@
-import isDev from '../core/process/isDev.js';
+import isDev from '../core/node/isDev.js';
 import { theme } from '../stitches.config.js';
 
 export interface TitleBarProps {

src/constants/cyclic.ts

@@ -0,0 +1 @@
+export const CYCLIC_API = 'https://blitzkrieg.cyclic.app';

src/constants/servers.ts

@@ -1,19 +1,7 @@
-export const BLITZ_SERVERS = {
+export type BlitzServer = 'com' | 'eu' | 'asia';
+
+export const BLITZ_SERVERS: Record<BlitzServer, string> = {
   com: 'North America',
   eu: 'Europe',
   asia: 'Asia',
 };
-
-export const BLITZ_SERVERS_SHORT = {
-  com: 'NA',
-  eu: 'EU',
-  asia: 'ASIA',
-};
-
-export const BLITZ_SERVERS_SHORT_INVERSE = {
-  NA: 'com',
-  EU: 'eu',
-  ASIA: 'asia',
-};
-
-export type BlitzServer = keyof typeof BLITZ_SERVERS;

src/core/blitz/calculateWN8.ts

@@ -3,7 +3,7 @@ import { AllStats } from '../../types/accountInfo.js';
 /**
  * Formula from https://web.archive.org/web/20190105064817/http://wiki.wnefficiency.net/pages/WN8
  */
-export default function getWN8(expected: AllStats, average: AllStats) {
+export default function calculateWN8(expected: AllStats, average: AllStats) {
   const avgDmg = average.damage_dealt / average.battles;
   const avgSpot = average.spotted / average.battles;
   const avgFrag = average.frags / average.battles;

src/core/blitz/getBlitzClan.ts

@@ -1,23 +1,19 @@
-import { CacheType, ChatInputCommandInteraction } from 'discord.js';
 import { BlitzServer } from '../../constants/servers.js';
-import errorWithCause from '../process/errorWithCause.js';
+import { serverAndIdPattern } from '../discord/resolvePlayerFromCommand.js';
-import { serverAndIdPattern } from './getBlitzAccount.js';
+import throwError from '../node/throwError.js';
-import listClansPanServer from './listClansPanServer.js';
+import listClans from './listClans.js';
 
-export default async function getBlitzClan(
+export default async function getBlitzClan(clan: string) {
-  interaction: ChatInputCommandInteraction<CacheType>,
-  clan: string,
-) {
   if (serverAndIdPattern.test(clan)) {
     const [server, accountId] = clan.split('/');
     return { server: server as BlitzServer, id: Number(accountId) };
   } else {
-    const accounts = await listClansPanServer(clan);
+    const accounts = await listClans(clan);
 
     if (accounts[0]) {
       return { server: accounts[0].server, id: accounts[0].clan_id };
     } else {
-      throw errorWithCause(
+      throw throwError(
         'Could not find clan',
         `I couldn't find clan \`${clan}\`. Try selecting a username from the search result.`,
       );

src/core/blitz/getTankStats.ts

@@ -1,21 +1,16 @@
-import { CacheType, ChatInputCommandInteraction } from 'discord.js';
 import { BLITZ_SERVERS, BlitzServer } from '../../constants/servers.js';
 import { TanksStats } from '../../types/tanksStats.js';
-import { WARGAMING_APPLICATION_ID } from '../process/args.js';
+import { WARGAMING_APPLICATION_ID } from '../node/arguments.js';
-import errorWithCause from '../process/errorWithCause.js';
+import throwError from '../node/throwError.js';
 import getWargamingResponse from './getWargamingResponse.js';
 
-export default async function getTankStats(
+export default async function getTankStats(server: BlitzServer, id: number) {
-  interaction: ChatInputCommandInteraction<CacheType>,
-  server: BlitzServer,
-  id: number,
-) {
   const tankStats = await getWargamingResponse<TanksStats>(
     `https://api.wotblitz.${server}/wotb/tanks/stats/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${id}`,
   );
 
   if (tankStats[id] === null) {
-    throw errorWithCause(
+    throw throwError(
       'No tank stats available',
       `Wargaming says there is no tank stats for this account. This account may not have any battles/tanks or exist in the ${BLITZ_SERVERS[server]} server.`,
     );

src/core/blitz/getWargamingResponse.ts

@@ -1,5 +1,14 @@
-import { WargamingResponse } from '../../types/wargamingResponse.js';
+import throwError from '../node/throwError.js';
-import errorWithCause from '../process/errorWithCause.js';
+
+export type WargamingResponse<Data extends object> =
+  | {
+      status: 'error';
+      error: { field: string; message: string; code: 402; value: null };
+    }
+  | {
+      status: 'ok';
+      data: Data;
+    };
 
 export default async function getWargamingResponse<Data extends object>(
   url: string,
@@ -12,7 +21,7 @@ export default async function getWargamingResponse<Data extends object>(
   if (parsed.status === 'ok') {
     return parsed.data;
   } else {
-    throw errorWithCause(
+    throw throwError(
       `Wargaming response error status:"${parsed.status}"`,
       `Message: "${parsed.error.message}"\nURL: "${url}"`,
     );

src/core/blitz/listClans.ts

@@ -1,13 +1,13 @@
 import { BlitzServer } from '../../constants/servers.js';
 import { Clan, ClanList } from '../../types/clanList.js';
-import { WARGAMING_APPLICATION_ID } from '../process/args.js';
+import { WARGAMING_APPLICATION_ID } from '../node/arguments.js';
 import getWargamingResponse from './getWargamingResponse.js';
 
 export type ClanListWithServer = (Clan & {
   server: 'com' | 'eu' | 'asia';
 })[];
 
-export default async function listClansPanServer(search: string, limit = 9) {
+export default async function listClans(search: string, limit = 9) {
   const trimmed = search.trim();
   if (trimmed.length < 3 && trimmed.length > 100) return [];
   const normalizedLimit = Math.round(limit / 3);

src/core/blitz/listPlayers.ts

@@ -1,6 +1,6 @@
 import { BlitzServer } from '../../constants/servers.js';
 import { Account, AccountList } from '../../types/accountList.js';
-import { WARGAMING_APPLICATION_ID } from '../process/args.js';
+import { WARGAMING_APPLICATION_ID } from '../node/arguments.js';
 import getWargamingResponse from './getWargamingResponse.js';
 
 export type AccountListWithServer = (Account & {
@@ -10,7 +10,7 @@ export type AccountListWithServer = (Account & {
 export const usernamePattern = /^[a-zA-Z0-9_]{3,24}$/;
 export const usernamePatternWithoutPosition = /[a-zA-Z0-9_]{3,24}/;
 
-export default async function listAccountsPanServer(search: string, limit = 9) {
+export default async function listPlayers(search: string, limit = 9) {
   const trimmedSearch = search.trim();
   const normalizedLimit = Math.round(limit / 3);
   const encodedSearch = encodeURIComponent(trimmedSearch);

src/core/blitz/resolveTankId.ts

@@ -1,19 +1,15 @@
-import { CacheType, ChatInputCommandInteraction } from 'discord.js';
 import { go } from 'fuzzysort';
-import errorWithCause from '../process/errorWithCause.js';
+import throwError from '../node/throwError.js';
 import { TANKS, tankopedia } from './tankopedia.js';
 
-export default async function resolveTankId(
+export default function resolveTankId(tank: string) {
-  interaction: ChatInputCommandInteraction<CacheType>,
+  const number = parseInt(tank);
-  tank: string,
-) {
-  const number = Number(tank);
 
   if (Number.isNaN(number)) {
     const searchResult = go(tank, TANKS, { keys: ['name'], limit: 1 });
 
     if (searchResult.length === 0) {
-      throw errorWithCause(
+      throw throwError(
         'Tank not found',
         `Could not find tank by the name "${tank}".`,
       );
@@ -24,7 +20,7 @@ export default async function resolveTankId(
     if (tankopedia[number]) {
       return number;
     } else {
-      throw errorWithCause(
+      throw throwError(
         'Tank not found',
         `Could not find tank by the ID "${number}".`,
       );

src/core/blitz/sumStats.ts

@@ -1,5 +1,5 @@
 import { AllStats } from '../../types/accountInfo.js';
-import { emptyAllStats } from '../blitzstars/getTankStatsOverTime.js';
+import { emptyAllStats } from '../blitzstars/getTankStatsDiffed.js';
 
 export default function sumStats(allStatsCollection: AllStats[]) {
   return allStatsCollection.reduce((accumulated, current) => {

src/core/blitz/tankopedia.ts

@@ -1,4 +1,5 @@
-import { WargamingResponse } from '../../types/wargamingResponse.js';
+import { readFileSync } from 'fs';
+import { join } from 'path';
 
 export type TankType = 'AT-SPG' | 'lightTank' | 'mediumTank' | 'heavyTank';
 
@@ -18,30 +19,15 @@ export interface Tankopedia {
   [id: number]: TankopediaEntry;
 }
 
-export const tankopedia: Tankopedia = {};
+export const tankopedia = (
-export const TANK_IDS: number[] = [];
+  JSON.parse(
-export const TANKS: TankopediaEntry[] = [];
+    readFileSync(join(__dirname, 'tankopedia.json')) as unknown as string,
-export const TANK_NAMES: string[] = [];
+  ) as { data: Tankopedia }
-
+).data;
-console.log('Caching tankopedia...');
+const entries = Object.entries(tankopedia);
-fetch('https://www.blitzstars.com/bs-tankopedia.json')
+export const TANK_IDS = entries.map(([, { tank_id }]) => tank_id as number);
-  .then(
+export const TANKS = entries.map(([, entry]) => entry as TankopediaEntry);
-    (response) =>
+export const TANK_NAMES = entries.map(([, { name }]) => name);
-      response.json() as Promise<
-        WargamingResponse<Tankopedia> & { status: 'ok' }
-      >,
-  )
-  .then((wargamingResponse) => {
-    Object.assign(tankopedia, wargamingResponse.data);
-    Object.entries(tankopedia).forEach(([idString, entry]) => {
-      const id = Number(idString);
-
-      TANK_IDS.push(id);
-      TANKS.push(entry);
-      TANK_NAMES.push(entry.name);
-    }),
-      console.log('Cached tankopedia');
-  });
 
 export const TANK_ICONS: Record<TankType, string> = {
   'AT-SPG': 'https://i.imgur.com/BIHSEH0.png',
@@ -50,7 +36,9 @@ export const TANK_ICONS: Record<TankType, string> = {
   heavyTank: 'https://i.imgur.com/ECeqlZa.png',
 };
 
-export const TIER_ROMAN_NUMERALS: Record<number, string> = {
+export type Tier = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
+
+export const TIER_ROMAN_NUMERALS: Record<Tier, string> = {
   1: 'I',
   2: 'II',
   3: 'III',

src/core/blitz/wargamingError.ts

@@ -1,26 +0,0 @@
-import {
-  CacheType,
-  ChatInputCommandInteraction,
-  EmbedBuilder,
-} from 'discord.js';
-import { NEGATIVE_COLOR } from '../../constants/colors.js';
-import { handleError } from '../../events/error.js';
-import { client } from '../../index.js';
-
-export default async function wargamingError(
-  interaction: ChatInputCommandInteraction<CacheType>,
-  error: Error,
-  command: string,
-) {
-  await interaction.editReply({
-    embeds: [
-      new EmbedBuilder()
-        .setColor(NEGATIVE_COLOR)
-        .setTitle(`${client.user?.username} ran into an issue`)
-        .setDescription('Wargaming returned an error. Please try again later.'),
-    ],
-  });
-
-  console.log(`Wargaming returned an error`);
-  handleError(error, command);
-}

src/core/blitzstars/blitzStarsError.ts

@@ -1,28 +0,0 @@
-import {
-  CacheType,
-  ChatInputCommandInteraction,
-  EmbedBuilder,
-} from 'discord.js';
-import { NEGATIVE_COLOR } from '../../constants/colors.js';
-import { handleError } from '../../events/error.js';
-import { client } from '../../index.js';
-
-export default async function blitzStarsError(
-  interaction: ChatInputCommandInteraction<CacheType>,
-  error: Error,
-  command: string,
-) {
-  await interaction.editReply({
-    embeds: [
-      new EmbedBuilder()
-        .setColor(NEGATIVE_COLOR)
-        .setTitle(`${client.user?.username} ran into an issue`)
-        .setDescription(
-          'BlitzStars returned an error. Please try again later.',
-        ),
-    ],
-  });
-
-  console.log(`BlitzStars returned an error`);
-  handleError(error, command);
-}

src/core/blitzstars/blitzStarsLinks.ts

@@ -1,5 +0,0 @@
-import { BlitzServer } from '../../constants/servers.js';
-
-export default function blitzStarsLinks(server: BlitzServer, nickname: string) {
-  return `[View full stats](https://www.blitzstars.com/player/${server}/${nickname}) • [Support BlitzStars](https://www.blitzstars.com/supporters)`;
-}

src/core/blitzstars/getPeriodNow.ts

@@ -1,3 +1,3 @@
 export default function getPeriodNow() {
-  return new Date().getTime() / 1000;
+  return Date.now() / 1000;
 }

src/core/blitzstars/getPeriodStart.ts

@@ -1,23 +1,12 @@
-import { StatPeriod } from '../options/addStatPeriodChoices.js';
+import { Period } from '../discord/addPeriodSubCommands.js';
+import getTimeDaysAgo from './getTimeDaysAgo.js';
 
-export default function getPeriodicStart(period: StatPeriod) {
+export default function getPeriodStart(period: Exclude<Period, 'custom'>) {
   if (period === 'career') {
     return -Infinity;
   } else if (period === 'today') {
-    const now = new Date();
+    return getTimeDaysAgo(0);
-    now.setHours(5, 0, 0, 0);
-
-    // If it's after 5:00 AM today, subtract one day
-    if (now.getTime() > Date.now()) now.setDate(now.getDate() - 1);
-
-    return now.getTime() / 1000;
   } else {
-    const daysAgo = Number(period) - 1;
+    return getTimeDaysAgo(parseInt(period));
-    const periodStart = new Date();
-
-    periodStart.setDate(periodStart.getDate() - daysAgo);
-    periodStart.setHours(5, 0, 0, 0);
-
-    return periodStart.getTime() / 1000;
   }
 }

src/core/blitzstars/getPlayerHistories.ts

@@ -0,0 +1,92 @@
+import { BlitzServer } from '../../constants/servers.js';
+import { AccountInfo, AllStats } from '../../types/accountInfo.js';
+import {
+  GetHistoriesOptions,
+  Histories,
+  History,
+  getHistoriesDefaultOptions,
+} from '../../types/histories.js';
+import getWargamingResponse from '../blitz/getWargamingResponse.js';
+import { WARGAMING_APPLICATION_ID } from '../node/arguments.js';
+import { emptyAllStats } from './getTankStatsDiffed.js';
+
+export interface PlayerHistoryRaw {
+  clan: { clan_id: number; name: string; tag: string };
+  statistics: {
+    all: AllStats;
+    wn8: number;
+    wn7: number;
+    average_tier: number;
+  };
+  last_battle_time: number;
+  nickname: string;
+  account_id: number;
+  achievements: {
+    account_id: number;
+    [key: string]: number;
+  };
+  region: BlitzServer;
+}
+
+export type PlayerHistoriesRaw = PlayerHistoryRaw[];
+
+export default async function getPlayerHistories(
+  server: BlitzServer,
+  id: number,
+  options?: Partial<GetHistoriesOptions>,
+) {
+  const mergedOptions = { ...getHistoriesDefaultOptions, ...options };
+  const response = await fetch(
+    `https://www.blitzstars.com/api/playerstats/${id}`,
+  );
+  const playerHistories = ((await response.json()) as PlayerHistoriesRaw).map(
+    (history) =>
+      ({
+        all: history.statistics.all,
+        last_battle_time: history.last_battle_time,
+      } satisfies History),
+  );
+  let lastNonCompliantIndex = -1;
+  let hasCompliedOnce = false;
+  const filtered = playerHistories.filter(({ last_battle_time }, index) => {
+    const complies =
+      last_battle_time >= mergedOptions.start &&
+      last_battle_time <= mergedOptions.end;
+
+    if (complies && !hasCompliedOnce) hasCompliedOnce = true;
+    if (!hasCompliedOnce) lastNonCompliantIndex = index;
+
+    return complies;
+  });
+
+  const latestNodes: Histories = [];
+
+  if (mergedOptions.includeLatestHistories) {
+    const {
+      last_battle_time,
+      statistics: { all },
+    } = (
+      await getWargamingResponse<AccountInfo>(
+        `https://api.wotblitz.${server}/wotb/account/info/?application_id=${WARGAMING_APPLICATION_ID}&account_id=${id}`,
+      )
+    )[id];
+
+    latestNodes.push({ all, last_battle_time });
+  }
+
+  const previousNodes: Histories = [];
+
+  if (mergedOptions.includePreviousHistories) {
+    if (lastNonCompliantIndex !== -1) {
+      previousNodes.push(
+        playerHistories[lastNonCompliantIndex] ??
+          ({
+            all: emptyAllStats,
+            last_battle_time: -Infinity,
+          } satisfies History),
+      );
+    }
+  }
+
+  return [...latestNodes, ...filtered, ...previousNodes] satisfies Histories;
+}

src/core/blitzstars/getTankHistories.ts

@@ -0,0 +1,113 @@
+import { BlitzServer } from '../../constants/servers.js';
+import {
+  GetHistoriesOptions,
+  Histories,
+  History,
+  getHistoriesDefaultOptions,
+} from '../../types/histories.js';
+import getTankStats from '../blitz/getTankStats.js';
+import { emptyAllStats } from './getTankStatsDiffed.js';
+
+export interface TankHistory extends History {
+  tank_id: number;
+}
+
+export type TankHistories = TankHistory[];
+
+export interface TankHistoryRaw extends TankHistory {
+  mark_of_mastery: number;
+  battle_life_time: number;
+  account_id: number;
+}
+
+export type TankHistoriesRaw = TankHistoryRaw[];
+
+export interface GetTankHistoriesOptions extends GetHistoriesOptions {
+  tankId?: number;
+}
+
+export const getTankHistoriesDefaultOptions: GetTankHistoriesOptions = {
+  ...getHistoriesDefaultOptions,
+  tankId: undefined,
+};
+
+export default async function getTankHistories(
+  server: BlitzServer,
+  id: number,
+  options?: Partial<GetTankHistoriesOptions>,
+) {
+  const mergedOptions = { ...getTankHistoriesDefaultOptions, ...options };
+  const tankHistoriesResponse = await fetch(
+    `https://www.blitzstars.com/api/tankhistories/for/${id}/`,
+  );
+  const tankHistories = (
+    (await tankHistoriesResponse.json()) as TankHistoriesRaw
+  ).map(
+    (history) =>
+      ({
+        all: history.all,
+        last_battle_time: history.last_battle_time,
+        tank_id: history.tank_id,
+      } satisfies TankHistory),
+  );
+  const compliantTanks: number[] = [];
+  const lastBattles: Record<number, number> = {};
+  const lastNonCompliantIndex: Record<number, number> = {};
+  const hasCompliedOnce: Record<number, boolean> = {};
+  const filtered = tankHistories.filter(
+    ({ last_battle_time, tank_id, all: { battles } }, index) => {
+      const complies =
+        last_battle_time >= mergedOptions.start &&
+        last_battle_time <= mergedOptions.end &&
+        (mergedOptions.tankId === undefined ||
+          tank_id === mergedOptions.tankId);
+
+      if (complies && !hasCompliedOnce[tank_id]) {
+        hasCompliedOnce[tank_id] = true;
+        compliantTanks.push(tank_id);
+      }
+      if (!hasCompliedOnce[tank_id]) lastNonCompliantIndex[tank_id] = index;
+      lastBattles[tank_id] = battles;
+
+      return complies;
+    },
+  );
+
+  const latestNodes: TankHistories = [];
+
+  if (mergedOptions.includeLatestHistories) {
+    (await getTankStats(server, id)).forEach((tankHistory) => {
+      if (
+        tankHistory.all.battles > (lastBattles[tankHistory.tank_id] ?? 0) &&
+        (mergedOptions.tankId === undefined ||
+          tankHistory.tank_id === mergedOptions.tankId)
+      ) {
+        if (!hasCompliedOnce[tankHistory.tank_id]) {
+          // was played today for the first time... I think???
+          hasCompliedOnce[tankHistory.tank_id] = true;
+          compliantTanks.push(tankHistory.tank_id);
+        }
+        latestNodes.push(tankHistory);
+      }
+    });
+  }
+
+  const previousNodes: TankHistories = [];
+
+  if (mergedOptions.includePreviousHistories) {
+    compliantTanks.forEach((tankId) => {
+      if (tankId in lastNonCompliantIndex) {
+        previousNodes.push(
+          tankHistories[lastNonCompliantIndex[tankId]] ??
+            ({
+              all: emptyAllStats,
+              last_battle_time: -Infinity,
+              tank_id: tankId,
+            } satisfies TankHistory),
+        );
+      }
+    });
+  }
+
+  return [...previousNodes, ...filtered, ...latestNodes] satisfies Histories;
+}

src/core/blitzstars/getTankStatsDiffed.ts

@@ -1,16 +1,9 @@
-import { CacheType, ChatInputCommandInteraction } from 'discord.js';
 import { BlitzServer } from '../../constants/servers.js';
 import { AllStats } from '../../types/accountInfo.js';
-import getTankStats from '../blitz/getTankStats.js';
+import getTankHistories, {
-
+  TankHistories,
-export interface TankHistoryNode {
+  TankHistoryRaw,
-  all: AllStats;
+} from './getTankHistories.js';
-  last_battle_time: number;
-  mark_of_mastery: number;
-  battle_life_time: number;
-  account_id: number;
-  tank_id: number;
-}
 
 export const emptyAllStats: AllStats = {
   battles: 0,
@@ -32,7 +25,7 @@ export const emptyAllStats: AllStats = {
   wins: 0,
 };
 
-export const emptyTankHistoryNode: TankHistoryNode = {
+export const emptyTankHistoryNode: TankHistoryRaw = {
   account_id: 0,
   battle_life_time: 0,
   last_battle_time: 0,
@@ -41,24 +34,18 @@ export const emptyTankHistoryNode: TankHistoryNode = {
   all: emptyAllStats,
 };
 
-export type TankHistory = TankHistoryNode[];
+export default async function getTankStatsDiffed(
-
-export default async function getTankStatsOverTime(
-  interaction: ChatInputCommandInteraction<CacheType>,
   server: BlitzServer,
   id: number,
   start: number,
   end: number,
 ) {
-  const latestTankStatsRaw = await getTankStats(interaction, server, id);
+  const history = await getTankHistories(server, id, {
-  const tankHistoriesResponse = await fetch(
+    includeLatestHistories: true,
-    `https://www.blitzstars.com/api/tankhistories/for/${id}/`,
+  });
-  );
-  const tankHistories = (await tankHistoriesResponse.json()) as TankHistory;
-  const history = [...tankHistories, ...latestTankStatsRaw];
 
   // sort them even though most won't be used
-  const tankSortedHistory: Record<number, TankHistory> = {};
+  const tankSortedHistory: Record<number, TankHistories> = {};
   const tankIds: number[] = [];
   history.forEach((node) => {
     if (!tankSortedHistory[node.tank_id]) {

src/core/blitzstars/getTimeDaysAgo.ts

@@ -0,0 +1,12 @@
+export default function getTimeDaysAgo(daysAgo: number) {
+  const now = new Date();
+  now.setHours(5, 0, 0, 0);
+
+  // if it's after 5:00 AM today, subtract one day
+  if (now.getTime() > Date.now()) now.setDate(now.getDate() - 1);
+
+  // subtract the period number of days from now
+  now.setDate(now.getDate() - daysAgo);
+
+  return now.getTime() / 1000;
+}

src/core/blitzstars/last5AM.ts

@@ -1,11 +0,0 @@
-export default function last5AM() {
-  const fiveAM = new Date();
-  fiveAM.setHours(5, 0, 0, 0); // Set the time to 5:00 AM today
-
-  if (fiveAM > new Date()) {
-    // If it's now before 5:00 AM, go back one day
-    fiveAM.setDate(fiveAM.getDate() - 1);
-  }
-
-  return fiveAM;
-}

src/core/blitzstars/playerAverage.ts

@@ -1,5 +1,5 @@
 import sumStats from '../blitz/sumStats.js';
-import { emptyAllStats } from './getTankStatsOverTime.js';
+import { emptyAllStats } from './getTankStatsDiffed.js';
 import { tankAverages } from './tankAverages.js';
 
 console.log('Calculating player average...');

src/core/blitzstars/poweredByBlitzStars.ts

@@ -1,8 +0,0 @@
-import { EmbedBuilder } from 'discord.js';
-
-export default function poweredByBlitzStars(embed: EmbedBuilder) {
-  return embed.setTimestamp().setFooter({
-    text: 'Powered by BlitzStars',
-    iconURL: 'https://www.blitzstars.com/assets/images/TankyMcPewpew.png',
-  });
-}

src/core/blitzstars/tankAverages.ts

@@ -1,3 +1,5 @@
+import { readFileSync } from 'fs';
+import { join } from 'path';
 import { AllStats } from '../../types/accountInfo.js';
 
 export interface SpecialStats {
@@ -78,14 +80,8 @@ export interface IndividualTankAverage {
   last_update: number;
 }
 
-export const tankAverages: Record<number, IndividualTankAverage> = {};
+export type TankAverages = Record<number, IndividualTankAverage>;
 
-console.log('Caching tank averages...');
+export const tankAverages = JSON.parse(
-fetch('https://www.blitzstars.com/api/tankaverages.json')
+  readFileSync(join(__dirname, 'tankaverages.json')) as unknown as string,
-  .then((response) => response.json() as Promise<IndividualTankAverage[]>)
+) as TankAverages;
-  .then((individualTankAverages) => {
-    individualTankAverages.forEach((individualTankAverage) => {
-      tankAverages[individualTankAverage.tank_id] = individualTankAverage;
-    });
-    console.log('Tank averages cached');
-  });

src/core/discord/addPeriodSubCommands.ts

@@ -0,0 +1,52 @@
+import {
+  SlashCommandSubcommandBuilder,
+  SlashCommandSubcommandGroupBuilder,
+} from 'discord.js';
+import { PERIOD_NAMES } from '../discord/resolvePeriodFromCommand.js';
+
+export type Period = 'today' | '30' | '60' | '90' | 'career' | 'custom';
+
+export default function addPeriodSubCommands(
+  option: SlashCommandSubcommandGroupBuilder,
+  extra: (
+    option: SlashCommandSubcommandBuilder,
+  ) => SlashCommandSubcommandBuilder = (option) => option,
+) {
+  return option
+    .addSubcommand((option) =>
+      extra(option.setName('today').setDescription(PERIOD_NAMES.today)),
+    )
+    .addSubcommand((option) =>
+      extra(option.setName('30').setDescription(PERIOD_NAMES[30])),
+    )
+    .addSubcommand((option) =>
+      extra(option.setName('60').setDescription(PERIOD_NAMES[60])),
+    )
+    .addSubcommand((option) =>
+      extra(option.setName('90').setDescription(PERIOD_NAMES[90])),
+    )
+    .addSubcommand((option) =>
+      extra(option.setName('career').setDescription(PERIOD_NAMES.career)),
+    )
+    .addSubcommand((option) =>
+      extra(
+        option
+          .setName('custom')
+          .setDescription(PERIOD_NAMES.custom)
+          .addIntegerOption((option) =>
+            option
+              .setName('start')
+              .setDescription('Start of period in days ago from today')
+              .setMinValue(0)
+              .setRequired(true),
+          )
+          .addIntegerOption((option) =>
+            option
+              .setName('end')
+              .setDescription('End of period in days ago from today')
+              .setMinValue(0)
+              .setRequired(true),
+          ),
+      ),
+    );
+}