feat(discord-bot): add materia price query command

- implement `/materia` slash command for ff14 materia price lookup
- query prices and sales velocity from universalis API with batch processing
- add rate limiting with 1150ms delay between batches (20 items per batch)
- display materia grouped by color series (red, blue, green, purple, yellow)
- install `delay` and `await-to-js` dependencies for async flow control
- register command in Discord bot application commands

Author: aqzhyi

@apps/discord-bot/package.json

@@ -5,8 +5,10 @@
   "version": "0.1.0",
   "dependencies": {
     "@types/lodash-es": "4.17.12",
+    "await-to-js": "3.0.0",
     "chinese-conv": "4.0.0",
     "dedent": "1.7.1",
+    "delay": "7.0.0",
     "discord.js": "14.25.1",
     "dotenv": "17.2.3",
     "lodash-es": "4.17.22",

@apps/discord-bot/src/(features)/commands/materiaCommand.ts

@@ -0,0 +1,165 @@
+import delay from 'delay'
+import {
+  type ChatInputCommandInteraction,
+  SlashCommandBuilder,
+} from 'discord.js'
+import { chunk, keyBy } from 'lodash-es'
+import type { z } from 'zod'
+import { itemId } from '~/(constants)/itemId'
+import { universalisApp } from '~/(services)/universalis/universalisApp'
+import { universalisTypes } from '~/(services)/universalis/universalisTypes'
+
+type AggregatedItemResult = z.infer<
+  typeof universalisTypes.aggregatedItems
+>['results'][number]
+
+export const materiaCommand = {
+  command: new SlashCommandBuilder()
+    .setName('materia')
+    .setDescription('魔晶石查詢'),
+  callback: async function handleMateriaCommand(
+    interaction: ChatInputCommandInteraction,
+  ): Promise<void> {
+    const MATERIA_CONFIG = [
+      // 🔴 紅色系列（戰鬥特職）
+      { emoji: '🔴', name: '武略魔晶石', attr: '爆擊' },
+      { emoji: '🔴', name: '神眼魔晶石', attr: '直擊' },
+      { emoji: '🔴', name: '雄略魔晶石', attr: '信念' },
+
+      // 🔵 藍色系列（生產系特職）
+      { emoji: '🔵', name: '巨匠魔晶石', attr: '加工精度' },
+      { emoji: '🔵', name: '名匠魔晶石', attr: '作業精度' },
+      { emoji: '🔵', name: '魔匠魔晶石', attr: 'CP' },
+
+      // 🟢 綠色系列（採集系特職）
+      { emoji: '🟢', name: '達識魔晶石', attr: '獲得力' },
+      { emoji: '🟢', name: '博識魔晶石', attr: '鑑別力' },
+      { emoji: '🟢', name: '器識魔晶石', attr: 'GP' },
+
+      // 🟣 紫色系列（戰鬥特職）
+      { emoji: '🟣', name: '戰技魔晶石', attr: '技能速度' },
+      { emoji: '🟣', name: '詠唱魔晶石', attr: '詠唱速度' },
+
+      // 🟡 黃色系列（坦克/治療特職）
+      { emoji: '🟡', name: '剛柔魔晶石', attr: '堅韌' },
+      { emoji: '🟡', name: '信力魔晶石', attr: '信仰' },
+    ]
+
+    const TYPE_NAMES = [
+      '壹型',
+      '貳型',
+      '參型',
+      '肆型',
+      '伍型',
+      '陸型',
+      '柒型',
+      '捌型',
+      '玖型',
+      '拾型',
+      '拾壹型',
+      '拾貳型',
+    ]
+
+    const result = await interaction.reply('🔍 查詢所有魔晶石物價ing...')
+
+    // 收集所有魔晶石物品（保持排序）
+    const materiaItems = MATERIA_CONFIG.flatMap((materia) =>
+      TYPE_NAMES.map((typeName, typeIndex) => {
+        const fullName = `${materia.name}${typeName}`
+        const materiaId = itemId.get(fullName)
+        return {
+          ...materia,
+          typeName,
+          typeNumber: typeIndex + 1,
+          fullName,
+          id: materiaId,
+        }
+      }),
+    ).filter((item) => item.id !== undefined)
+
+    const allMateriaIds = materiaItems.map((item) => item.id!)
+
+    // 分批查詢價格（每批 20 個，延遲 1150ms）
+    const BATCH_SIZE = 20
+    const priceBatches = chunk(allMateriaIds, BATCH_SIZE)
+    const allPriceResults: AggregatedItemResult[] = []
+
+    for (let batchIndex = 0; batchIndex < priceBatches.length; batchIndex++) {
+      await result.edit(
+        `🔍 查詢價格中 (${batchIndex + 1}/${priceBatches.length})...`,
+      )
+
+      const { data: priceData } = await universalisApp.findManyItemsPrice(
+        priceBatches[batchIndex]!,
+      )
+      if (priceData?.results) {
+        allPriceResults.push(...priceData.results)
+      }
+
+      if (batchIndex < priceBatches.length - 1) {
+        await delay(1150)
+      }
+    }
+
+    const priceMap = keyBy(allPriceResults, 'itemId')
+
+    // 分批查詢銷量（每批 20 個，延遲 1150ms）
+    await result.edit('🔍 查詢銷量資料中...')
+
+    const saleVelocityMap: Record<number, number> = {}
+
+    for (let batchIndex = 0; batchIndex < priceBatches.length; batchIndex++) {
+      const { data: saleData } = await universalisApp.findItemSaleHistory(
+        priceBatches[batchIndex]!,
+      )
+
+      if (saleData) {
+        saleVelocityMap[saleData.itemID] = saleData.nqSaleVelocity || 0
+      }
+
+      if (batchIndex < priceBatches.length - 1) {
+        await delay(1150)
+      }
+    }
+
+    // 格式化輸出 - 按顏色分組
+    await result.edit('🔍 正在總結...')
+
+    const colorGroups = [
+      { emoji: '🔴', name: '紅色系列（戰鬥特職）' },
+      { emoji: '🔵', name: '藍色系列（生產系特職）' },
+      { emoji: '🟢', name: '綠色系列（採集系特職）' },
+      { emoji: '🟣', name: '紫色系列（戰鬥特職）' },
+      { emoji: '🟡', name: '黃色系列（坦克/治療特職）' },
+    ]
+
+    for (let groupIndex = 0; groupIndex < colorGroups.length; groupIndex++) {
+      const group = colorGroups[groupIndex]!
+      const output = [`## ${group.emoji} ${group.name}\n`]
+
+      const groupItems = materiaItems.filter(
+        (item) => item.emoji === group.emoji,
+      )
+
+      for (const item of groupItems) {
+        if (!item.id) continue
+
+        const price = priceMap[item.id]?.nq.averageSalePrice.region?.price || 0
+        const velocity = saleVelocityMap[item.id] || 0
+
+        /**
+         * FIXME: 銷量總是返回 0 的問題。
+         */
+        output.push(
+          `${item.emoji} ${item.fullName} (${item.typeNumber}型${item.attr}) / 平均 ${Math.round(price).toLocaleString('en-US')}g / 銷量 ${Math.round(velocity)} 件`,
+        )
+      }
+
+      if (groupIndex === 0) {
+        await result.edit(output.join('\n'))
+      } else {
+        await interaction.followUp(output.join('\n'))
+      }
+    }
+  },
+}

@apps/discord-bot/src/index.ts

@@ -1,5 +1,6 @@
 import { REST, Routes } from 'discord.js'
 import { itemCommand } from '~/(features)/commands/itemCommand'
+import { materiaCommand } from '~/(features)/commands/materiaCommand'
 import { discordBot } from '~/(services)/bot/discordBot.ts'
 import { envVar } from '~/envVar.ts'
 
@@ -12,7 +13,10 @@ discordBot.on('ready', async (client) => {
 
   // Register slash commands
   const rest = new REST({ version: '10' }).setToken(envVar.DISCORD_BOT_TOKEN)
-  const commands = [itemCommand.command.toJSON()]
+  const commands = [
+    itemCommand.command.toJSON(),
+    materiaCommand.command.toJSON(),
+  ]
 
   try {
     await rest.put(Routes.applicationCommands(client.user.id), {
@@ -30,6 +34,10 @@ discordBot.on('interactionCreate', async (interaction) => {
   if (interaction.commandName === 'item') {
     await itemCommand.callback(interaction)
   }
+
+  if (interaction.commandName === 'materia') {
+    await materiaCommand.callback(interaction)
+  }
 })
 
 discordBot.login(envVar.DISCORD_BOT_TOKEN)