discord bot

2026-09-16 09:31:20 -04:00 · 2026-04-29 13:01:21 -04:00
parent ea3c030a21
commit c20c22eafc
21 changed files with 1179 additions and 1895 deletions
@@ -0,0 +1,73 @@
+// Discord Bus Event Integrations
+// Purpose: Handles event-bus announcements to Discord channels.
+// Scope: Processes supported event types and posts formatted messages/embeds.
+const { EmbedBuilder, AttachmentBuilder } = require('discord.js');
+
+function createBusEventHandler(deps) {
+  const { logger, discordConfig, getMode, MODES, roverManager, schedulePresenceRotation, formatDuration, sendToChannel } = deps;
+  const ADMIN_ALERT_EVENT_TYPES = new Set(['rover.online', 'rover.offline', 'rover.dockGuard', 'battery.warn', 'battery.urgent', 'battery.docked', 'battery.undocked', 'battery.charging.start', 'battery.charging.stop', 'battery.locked', 'battery.unlocked']);
+  let skippedFirstModeAnnouncement = false;
+
+  function buildEmbed({ title, description, color, includeSiteUrl = true }) {
+    const embed = new EmbedBuilder().setTitle(title || 'Update').setColor(color || 0x2196f3);
+    const siteUrl = includeSiteUrl && discordConfig.siteUrl ? String(discordConfig.siteUrl) : '';
+    if (description) embed.setDescription(siteUrl ? `${description}\n\n${siteUrl}` : description);
+    else if (siteUrl) embed.setDescription(siteUrl);
+    embed.setTimestamp(new Date());
+    return embed;
+  }
+
+  async function announce({ channelId, content, pingRoleId, color, title, description, embeds, files }) {
+    if (!channelId) return;
+    const prefix = pingRoleId ? `<@&${pingRoleId}> ` : '';
+    const payloadEmbeds = Array.isArray(embeds) && embeds.length ? embeds : [buildEmbed({ title, description, color })];
+    await sendToChannel(channelId, `${prefix}${content || ''}`.trim(), { embeds: payloadEmbeds, files: Array.isArray(files) ? files : undefined }, { parse: [], roles: pingRoleId ? [pingRoleId] : [] }, !pingRoleId);
+  }
+
+  return function handleBusEvent(event) {
+    const { type, payload } = event || {};
+    const channels = discordConfig.channels || {};
+    const roles = discordConfig.roles || {};
+    const roverId = payload?.roverId || null;
+    if (roverId && !roverManager.canReplayRoverId(roverId) && !ADMIN_ALERT_EVENT_TYPES.has(type)) return;
+
+    switch (type) {
+      case 'mode.changed':
+        if (!skippedFirstModeAnnouncement) { skippedFirstModeAnnouncement = true; schedulePresenceRotation(); break; }
+        if (payload?.mode === MODES.OPEN || payload?.mode === MODES.TURNS) {
+          announce({ channelId: channels.announcements, content: `Access mode set to ${payload?.mode}.`, color: 0x2196f3, title: 'Access Mode Updated', description: `Access mode set to **${payload?.mode}**` });
+        }
+        schedulePresenceRotation();
+        break;
+      case 'communityGoal.updated':
+        announce({ channelId: channels.announcements, content: payload?.text ? `Community goal: ${payload.text}` : 'Community goal cleared.', color: 0x8bc34a, title: 'Community Goal', description: payload?.text || 'Community goal cleared.' });
+        schedulePresenceRotation();
+        break;
+      case 'rover.online':
+        announce({ channelId: channels.adminAlerts, pingRoleId: roles.adminPing || null, color: 0x4caf50, title: 'Rover Online', description: `${payload?.roverId} is online.` });
+        break;
+      case 'rover.offline':
+        announce({ channelId: channels.adminAlerts, pingRoleId: roles.adminPing || null, color: 0xe53935, title: 'Rover Offline', description: `${payload?.roverId} went offline.` });
+        break;
+      case 'rover.dockGuard':
+        announce({ channelId: channels.adminAlerts, color: 0xf0b651, title: 'Dock Guard Triggered', description: `${payload?.roverId} (${payload?.reasonText || 'undocked'}) for ${formatDuration(payload?.idleMs)}.` });
+        break;
+      case 'humanAlert.buttonPressed': {
+        const imageBase64 = payload?.imageBase64 ? String(payload.imageBase64) : '';
+        let attachment = null;
+        if (imageBase64) {
+          try {
+            const imageBuffer = Buffer.from(imageBase64, 'base64');
+            if (imageBuffer.length > 0) attachment = new AttachmentBuilder(imageBuffer, { name: 'human-alert-mosaic.jpg' });
+          } catch (err) { logger.warn('Failed to decode human alert image for Discord', err.message); }
+        }
+        announce({ channelId: channels.humanAlerts, pingRoleId: roles.humanAlertPing || null, content: payload?.message || 'Human alert button pressed.', embeds: [buildEmbed({ title: 'Human Alert Button Pressed', description: null, color: 0xe53935 })], files: attachment ? [attachment] : [] });
+        break;
+      }
+      default:
+        break;
+    }
+  };
+}
+
+module.exports = { createBusEventHandler };