/** * Updates — manages bot changelog/update posts. * * Usage: * import { Updates } from "@systems/updates"; * * Updates.list() * Updates.latest() * Updates.get({ version: "v0.8" }) * Updates.post({ version: "v0.8", client }) * Updates.preview({ version: "v0.8", interaction }) */ import path from "path"; import { Client, EmbedBuilder, TextChannel, MessageFlags } from "discord.js"; import { ChatInputCommandInteraction } from "discord.js"; import { Store } from "@systems/store"; import { Paths } from "@paths"; import { Emoji } from "@systems/emojis"; import { Config } from "@systems/config"; import { Logger } from "@systems/logger"; import { PollUI } from "@ui/poll"; import { Nation, VoteEntry, PollState } from "@types"; import { WRank, WRankEntry } from "@systems/wrank"; import { Leaves } from "@systems/leaves"; const log = Logger.for("updates"); // ─── Types ──────────────────────────────────────────────────────────────────── interface UpdateItem { text: string; emojiKey: string | null; } interface UpdateSection { type: "new" | "improvement" | "fix" | "technical"; label: string; emoji: string; items: UpdateItem[]; } interface UpdateExample { caption: string; type: "poll"; layout: string; file: string; } export interface UpdateEntry { version: string; date: string; title: string; layout: string; messageId: string | null; sections: UpdateSection[]; examples: UpdateExample[]; } interface VersionsIndex { latest: string; versions: string[]; } interface ExamplePollState { slot: number; locked: boolean; confirmed: "yes" | "no" | null; yes: VoteEntry[]; no: VoteEntry[]; wrank?: { characterName: string; userKey: string; nation: Nation; currentRank: number; previousRank?: number; weeklyPoints: number; tgCount: number; }[]; leaves?: { characterName: string; historyKey: string; }[]; } let _versionsCache: string[] | null = null; // ─── Helpers ────────────────────────────────────────────────────────────────── function updatesDir(): string { return Paths.data("updates"); } function versionDir(version: string): string { return path.join(updatesDir(), version); } function buildUpdateEmbed(entry: UpdateEntry): EmbedBuilder { const embed = new EmbedBuilder() .setTitle(`⚔️ The Arbiter — ${entry.version} · ${entry.date}`) .setColor(0xe8a317) .setTimestamp(); // Build description from sections const lines: string[] = []; for (const section of entry.sections) { lines.push(`${section.emoji} **${section.label}**`); for (const item of section.items) { const emojiStr = item.emojiKey ? (Emoji.get(item.emojiKey) || "•") : "•"; lines.push(`${emojiStr} ${item.text}`); } lines.push(""); } embed.setDescription(lines.join("\n").trim()); embed.setFooter({ text: `${entry.version} — ${entry.title}` }); return embed; } function buildExamplePollState(exampleData: ExamplePollState): PollState { // Build yes/no Maps const yes = new Map(); const no = new Map(); for (const entry of exampleData.yes) { yes.set(entry.userKey ?? entry.displayName ?? entry.characterName ?? "", entry); } for (const entry of exampleData.no) { no.set(entry.userKey ?? entry.displayName ?? "", entry); } return { slot: exampleData.slot, locked: exampleData.locked, confirmed: exampleData.confirmed, yes, no, }; } function injectMockWrank(exampleData: ExamplePollState): (() => void) | null { if (!exampleData.wrank?.length) return null; // We inject mock wrank entries temporarily into WRank's current week // and return a cleanup function to restore the original state const week = WRank.currentWeek(); const original = JSON.parse(JSON.stringify(week.entries)); // Temporarily replace entries with mock data week.entries[Nation.Capella] = []; week.entries[Nation.Procyon] = []; for (const e of exampleData.wrank) { const nation = e.nation === Nation.Capella ? Nation.Capella : Nation.Procyon; week.entries[nation].push({ userKey: e.userKey, characterName: e.characterName, class: "WI" as any, nation, weeklyPoints: e.weeklyPoints, tgCount: e.tgCount, currentRank: e.currentRank, previousRank: e.previousRank, }); } // Return cleanup function return () => { week.entries[Nation.Capella] = original[Nation.Capella] ?? []; week.entries[Nation.Procyon] = original[Nation.Procyon] ?? []; }; } function injectMockLeaves(exampleData: ExamplePollState): (() => void) | null { if (!exampleData.leaves?.length) return null; // Mark leaves temporarily for (const l of exampleData.leaves) { Leaves.mark({ characterName: l.characterName, ownerKey: "example", historyKey: l.historyKey as any, markedBy: "example", }); } return () => { if (!exampleData.leaves) return; for (const l of exampleData.leaves) { Leaves.unmark({ characterName: l.characterName, historyKey: l.historyKey as any }); } }; } // ─── Updates namespace ──────────────────────────────────────────────────────── export const Updates = { list(): string[] { if (!_versionsCache) { const index = Store.read(path.join(updatesDir(), "versions.json")); _versionsCache = index?.versions ?? []; } return _versionsCache; }, latest(): string | null { const index = Store.read(path.join(updatesDir(), "versions.json")); return index?.latest ?? null; }, get({ version }: { version: string }): UpdateEntry | null { return Store.read(path.join(versionDir(version), "update.json")); }, setMessageId({ version, messageId }: { version: string; messageId: string }): void { const entry = Updates.get({ version }); if (!entry) return; entry.messageId = messageId; Store.write(path.join(versionDir(version), "update.json"), entry); }, buildEmbeds(entry: UpdateEntry): EmbedBuilder[] { const embeds: EmbedBuilder[] = [buildUpdateEmbed(entry)]; // Build example embeds for (const example of entry.examples) { const examplePath = path.join(versionDir(entry.version), example.file); const exampleData = Store.read(examplePath); if (!exampleData) continue; // Inject mock data const cleanupWrank = injectMockWrank(exampleData); const cleanupLeaves = injectMockLeaves(exampleData); try { // Set the layout PollUI.setLayout(example.layout); // Build the poll state const state = buildExamplePollState(exampleData); // Build embed using the real poll UI const exampleEmbed = PollUI.buildEmbed(state, { overrideLockMsg: example.caption }); // exampleEmbed.setTitle(""); // no title for examples embeds.push(exampleEmbed); } finally { cleanupWrank?.(); cleanupLeaves?.(); PollUI.setLayout(Config.get({ section: "poll", key: "layout" })); } } return embeds; }, async post({ version, client }: { version: string; client: Client }): Promise { const entry = Updates.get({ version }); if (!entry) { log.error(`Version ${version} not found`); return; } const channelId = Config.get({ section: "channels", key: "updates" }); if (!channelId) { log.error("updates channel not configured"); return; } const channel = await client.channels.fetch(channelId) as TextChannel; const embeds = Updates.buildEmbeds(entry); if (entry.messageId) { // Edit existing message try { const msg = await channel.messages.fetch(entry.messageId); await msg.edit({ embeds }); log.info(`Edited update ${version} (${entry.messageId})`); return; } catch { log.warn(`Could not edit message ${entry.messageId}, posting new`); } } // Post new message const msg = await channel.send({ embeds }); Updates.setMessageId({ version, messageId: msg.id }); log.info(`Posted update ${version} (${msg.id})`); }, async preview({ version, interaction }: { version: string; interaction: ChatInputCommandInteraction; }): Promise { const entry = Updates.get({ version }); if (!entry) { await interaction.reply({ content: `❌ Version \`${version}\` not found.`, flags: MessageFlags.Ephemeral }); return; } const embeds = Updates.buildEmbeds(entry); await interaction.reply({ embeds, flags: MessageFlags.Ephemeral }); }, };