✨ Add Minecraft Shop generation for currency system

packages/api/routes/api/v1/currency.ts

···
 import { Hono } from "hono";
-import { UserCurrency, UserCurrencyType, UserIntegration } from "@voidy/bot/db"
+import { UserCurrency, UserCurrencyType, UserIntegration } from "@voidy/bot/db";
 import { isAuthenticated } from "../../../middlewares/isAuthenticated";
 
 export const currency = new Hono();

packages/api/routes/api/v1/index.ts

···
 import { Hono } from "hono";
 import { currency } from "./currency";
+import { shop } from "./shop";
 
 export const v1 = new Hono();
 
 v1.route("/currency", currency);
+v1.route("/shop", shop);

packages/api/routes/api/v1/shop.ts

···
+import { Hono } from "hono";
+import { MinecraftShopItem, MinecraftShop } from "@voidy/bot/db";
+import { isAuthenticated } from "../../../middlewares/isAuthenticated";
+
+export const shop = new Hono();
+
+shop.get("/", isAuthenticated, async (c) => {
+  const latestShop = await MinecraftShop.findOne().sort({ createdAt: -1 });
+
+  if (!latestShop) {
+    return c.json({ error: "No shop found" }, 404);
+  }
+
+  return c.json(latestShop);
+});
+
+shop.post("/generate", isAuthenticated, async (c) => {
+  const body = await c.req.json().catch(() => ({}));
+  const { highlight } = body as { highlight?: string };
+
+  const allItems = await MinecraftShopItem.find();
+
+  if (!allItems.length) {
+    return c.json(
+      { error: "No shop items available to generate from" },
+      400,
+    );
+  }
+
+  // Config
+  const MIN_ITEMS = 4;
+  const MAX_ITEMS = 8;
+
+  const selected: typeof allItems = [];
+
+  // --- Force highlighted item ---
+  if (highlight) {
+    const highlightedItem = allItems.find(
+      (item) => item.item === highlight,
+    );
+
+    if (!highlightedItem) {
+      return c.json(
+        { error: `Highlighted item '${highlight}' not found` },
+        400,
+      );
+    }
+
+    selected.push(highlightedItem);
+  }
+
+  // --- Random fill ---
+  const pool = allItems.filter(
+    (item) => !selected.some((s) => s.id === item.id),
+  );
+
+  const targetCount =
+    Math.floor(Math.random() * (MAX_ITEMS - MIN_ITEMS + 1)) + MIN_ITEMS;
+
+  while (selected.length < targetCount && pool.length > 0) {
+    const index = Math.floor(Math.random() * pool.length);
+    selected.push(pool.splice(index, 1)[0]);
+  }
+
+  // --- Snapshot normalization ---
+  const items = selected.map((item) => ({
+    label: item.label,
+    icon: item.icon,
+    item: item.item,
+    price: item.price,
+    defaultOptions: {
+      quantity: item.defaultOptions.quantity,
+      stackLimit: item.defaultOptions.stackLimit,
+    },
+  }));
+
+  const newShop = await MinecraftShop.create({ items });
+
+  return c.json(newShop, 201);
+});

packages/bot/.env.example

···
-BOT_TOKEN=#Get this from https://discord.com/developers - REQUIRED
-BOT_CLIENT_ID=#Get this from https://discord.com/developers - REQUIRED
-BOT_ADMINS=#Discord Ids of bot administrators, comma separated
-DB_URI=#Your MongoDB connection URI - REQUIRED
+BOT_TOKEN: #Get this from https://discord.com/developers - REQUIRED
+BOT_CLIENT_ID: #Get this from https://discord.com/developers - REQUIRED
+BOT_ADMINS: #Discord Ids of bot administrators, comma separated
+DB_URI: #Your MongoDB connection URI - REQUIRED
+VOIDY_API_TOKEN: # 123456789

packages/bot/src/modules/economy/commands/minecraft/shop/generate.ts

···
+import { MessageFlags, SlashCommandSubcommandBuilder } from "discord.js";
+import type { Command } from "@voidy/framework";
+
+export default {
+  id: "minecraft.shop.generate",
+  devOnly: true,
+  data: new SlashCommandSubcommandBuilder()
+    .setName("generate")
+    .setDescription("Generate a new shop for the minecraft currency integration.")
+    .addStringOption((option) =>
+      option
+        .setName("highlight")
+        .setDescription("Force pick an item to highlight.")
+    ),
+
+  execute: async (interaction, _client) => {
+    await interaction.deferReply({ flags: [MessageFlags.Ephemeral] });
+
+    const highlight = interaction.options.getString("highlight");
+
+    try {
+      const res = await fetch(
+        "https://voidy.thevoid.cafe/api/v1/shop/generate",
+        {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${process.env.VOIDY_API_TOKEN}`,
+          },
+          body: highlight
+            ? JSON.stringify({ highlight })
+            : undefined,
+        },
+      );
+
+      if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`API error (${res.status}): ${text}`);
+      }
+
+      if (!highlight) {
+        await interaction.followUp({
+          content: "Generated new shop for the Minecraft currency integration.",
+          flags: [MessageFlags.Ephemeral],
+        });
+        return;
+      }
+
+      await interaction.followUp({
+        content: `Generated new shop for the Minecraft currency integration, with highlighted item: \`${highlight}\``,
+        flags: [MessageFlags.Ephemeral],
+      });
+    } catch (err) {
+      console.error("Failed to generate shop:", err);
+
+      await interaction.followUp({
+        content: "❌ Failed to generate a new shop. Check logs for details.",
+        flags: [MessageFlags.Ephemeral],
+      });
+    }
+  },
+} as Command;

packages/bot/src/modules/economy/schemas/MinecraftShop.ts

···
+import { Schema, model } from "mongoose";
+
+export const MinecraftShop = model(
+  "MinecraftShop",
+  new Schema({
+    createdAt: {
+      type: Date,
+      required: true,
+      default: Date.now,
+    },
+    items: {
+      type: Array,
+      required: true,
+      default: [
+        {
+          label: "Bread",
+          icon: "textures/items/bread",
+          item: "minecraft:bread",
+          price: 12,
+          defaultOptions: {
+            quantity: 16,
+            stackLimit: 64,
+          },
+        },
+      ]
+    }
+  }),
+);

packages/bot/src/modules/economy/schemas/MinecraftShopItem.ts

···
+import { Schema, model } from "mongoose";
+
+export const MinecraftShopItem = model(
+  "MinecraftShopItem",
+  new Schema({
+    label: { type: String, required: true },
+    icon: { type: String, required: true },
+    item: { type: String, required: true },
+    price: { type: Number, required: true },
+    defaultOptions: {
+      type: {
+        quantity: { type: Number, required: true, default: 16 },
+        stackLimit: { type: Number, required: true, default: 64 },
+      },
+      required: true
+    },
+  }),
+);

packages/bot/src/modules/economy/schemas/index.ts

···
 export * from "./UserCurrency";
+export * from "./MinecraftShop";
+export * from "./MinecraftShopItem";