Discord-Webhook für Streamer-Meldungen mit wählbaren Ereignissen

Meldungen zu Veto, Match-Start, Map- und Serienende, Matchende und
Serverfehlern gehen an DISCORD_WEBHOOK_URL. Im Admin-Bereich wählt man,
welche Ereignisse gemeldet werden, und kann eine Testmeldung senden.

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>

server/src/adminRoutes.js

@@ -76,6 +76,17 @@ export function createAdminRouter({ service, manager, config }) {
 
   router.get('/session', requireAdmin, (req, res) => res.json({ ok: true }));
 
+  // Discord-Meldungen: welche Ereignisse gemeldet werden
+  router.get('/notifications', requireAdmin, wrap(() => service.notificationSettings()));
+  router.put('/notifications', requireAdmin, wrap((req) => service.setNotificationEvents(req.body?.events)));
+  router.post('/notifications/test', requireAdmin, wrap(async () => {
+    if (!service.notifier.enabled) throw new HttpError(409, 'Kein Discord-Webhook eingerichtet (DISCORD_WEBHOOK_URL)', 'not_configured');
+    if (!(await service.notifier.send('Testmeldung aus CS2 Mapveto'))) {
+      throw new HttpError(502, 'Discord hat die Meldung nicht angenommen (siehe Log)', 'send_failed');
+    }
+    return { ok: true };
+  }));
+
   // Alle Matches mit allen Details (Codes, Verbindungsdaten, Spieler, Veto, Serie, Ereignisse)
   router.get('/matches', requireAdmin, wrap(() => {
     const ids = service.db.prepare('SELECT id FROM matches ORDER BY created_at DESC LIMIT 100').all();

server/src/app.js

@@ -5,6 +5,7 @@ import express from 'express';
 import { REPO_ROOT } from './config.js';
 import { openDatabase } from './db.js';
 import { createApiRouter } from './http.js';
+import { createDiscordNotifier } from './discord.js';
 import { loadMapPools } from './mapPools.js';
 import { MatchService } from './matchService.js';
 import { attachRealtime } from './realtime.js';
@@ -15,7 +16,8 @@ import { ServerManager } from './servers/serverManager.js';
 export function createApp(config, { adapter: adapterOverride, logger = console } = {}) {
   const db = openDatabase(config.databaseFile);
   const pools = loadMapPools(config.mapPoolFile);
-  const service = new MatchService({ db, pools, config });
+  const notifier = createDiscordNotifier(config.discordWebhookUrl, { logger });
+  const service = new MatchService({ db, pools, config, notifier });
 
   let manager;
   const adapter = adapterOverride ?? createServerAdapter(config, { getUsedPorts: () => manager.usedPorts() });

server/src/config.js

@@ -41,6 +41,7 @@ export function loadConfig(overrides = {}) {
     createMatchPassword: str('CREATE_MATCH_PASSWORD'),
     // Optionaler Schlüssel für die Stream-Übersicht aller Matches (/stream?key=…); leer = offen
     streamKey: str('STREAM_KEY'),
+    discordWebhookUrl: str('DISCORD_WEBHOOK_URL'),
     // Passwort für den Admin-Modus (/admin). Leer = Admin-Modus ist aus.
     adminPassword: str('ADMIN_PASSWORD'),
     requireFullTeams: bool('REQUIRE_FULL_TEAMS', false),

server/src/db.js

@@ -97,6 +97,10 @@ CREATE TABLE IF NOT EXISTS events (
   created_at INTEGER NOT NULL
 );
 CREATE INDEX IF NOT EXISTS events_match ON events(match_id, id);
+CREATE TABLE IF NOT EXISTS settings (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
 `;
 
 export function openDatabase(file) {

server/src/discord.js

@@ -0,0 +1,46 @@
+// Meldungen an einen Discord-Webhook, z. B. für Streamer. Fehler werden nur protokolliert
+// und bremsen den Matchablauf nie aus.
+
+const WEBHOOK_PATTERN = /^https:\/\/(discord\.com|discordapp\.com)\/api\/webhooks\/\d+\/[\w-]+$/;
+const TIMEOUT_MS = 5000;
+const MAX_LENGTH = 1900;
+
+/** Ereignisse, die gemeldet werden können. Alle sind standardmäßig aktiv. */
+export const NOTIFY_EVENTS = [
+  { key: 'veto_start', label: 'Veto gestartet' },
+  { key: 'match_start', label: 'Match gestartet (Aufwärmphase beendet)' },
+  { key: 'map_end', label: 'Map beendet (mit Ergebnis)' },
+  { key: 'series_end', label: 'Serie entschieden' },
+  { key: 'match_closed', label: 'Match abgeschlossen oder abgebrochen' },
+  { key: 'server_error', label: 'Serverfehler' },
+];
+
+/**
+ * @param {string} url      Webhook-URL aus DISCORD_WEBHOOK_URL, leer = keine Meldungen
+ * @param {object} options  fetchImpl und logger, vor allem für Tests
+ */
+export function createDiscordNotifier(url, { fetchImpl = fetch, logger = console } = {}) {
+  if (!url) return { enabled: false, send: async () => false };
+  // Die URL enthält ein Geheimnis. Sie wird deshalb nie in Fehlermeldungen ausgegeben.
+  if (!WEBHOOK_PATTERN.test(url)) throw new Error('DISCORD_WEBHOOK_URL ist keine gültige Discord-Webhook-URL');
+
+  return {
+    enabled: true,
+    /** Liefert true, wenn Discord die Nachricht angenommen hat. */
+    async send(content) {
+      try {
+        const res = await fetchImpl(url, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ content: content.slice(0, MAX_LENGTH) }),
+          signal: AbortSignal.timeout(TIMEOUT_MS),
+        });
+        if (res.ok) return true;
+        logger.warn(`Discord-Webhook antwortet mit HTTP ${res.status}`);
+      } catch (err) {
+        logger.warn(`Discord-Meldung fehlgeschlagen: ${err.name}`);
+      }
+      return false;
+    },
+  };
+}

server/src/matchService.js

@@ -4,6 +4,7 @@ import { formatCode, hashToken, normalizeCode, randomCode, randomId, randomToken
 import { applyLogLines, initialLiveState, seriesScore, splitLogBody } from './liveScore.js';
 import { trimLiveState } from './rounds.js';
 import { sanitizeConsoleText } from './servers/cs2Config.js';
+import { NOTIFY_EVENTS } from './discord.js';
 
 export class HttpError extends Error {
   constructor(status, message, code = 'error') {
@@ -41,11 +42,12 @@ function cleanSteamId(value) {
 }
 
 export class MatchService extends EventEmitter {
-  constructor({ db, pools, config }) {
+  constructor({ db, pools, config, notifier = { enabled: false, send: async () => {} } }) {
     super();
     this.db = db;
     this.pools = pools;
     this.config = config;
+    this.notifier = notifier;
     this.presence = () => new Set();
   }
 
@@ -339,6 +341,7 @@ export class MatchService extends EventEmitter {
         .run(firstTeam, this.now(), this.now(), match.id);
       const how = match.veto_start === 'coin' ? 'per Münzwurf ausgelost' : 'vom Organisator festgelegt';
       this.log(match.id, 'veto', `Veto gestartet – ${this.teamName(match, firstTeam)} beginnt (${how})`);
+      this.notify('veto_start', match.id, `Veto gestartet: ${this.matchTitle(match.id)}, ${this.teamName(match, firstTeam)} beginnt`);
     })();
     this.changed(viewer.matchId);
   }
@@ -516,6 +519,8 @@ export class MatchService extends EventEmitter {
         const winner = state.winner ? this.teamName(match, state.winner) : 'Unentschieden';
         this.log(matchId, 'score',
           `Map ${row.number} (${this.mapName(match, row.map)}) beendet: ${match.team_a_name} ${state.score.A}:${state.score.B} ${match.team_b_name} – Sieger: ${winner}`);
+        this.notify('map_end', matchId, `${this.matchTitle(matchId)}
+Map ${row.number} (${this.mapName(match, row.map)}) beendet: ${state.score.A}:${state.score.B}, Sieger ${winner}`);
       }
     })();
     if (ended) {
@@ -524,6 +529,8 @@ export class MatchService extends EventEmitter {
       const needed = Math.floor(BEST_OF[ended.match.format] / 2) + 1;
       const decided = score.A >= needed ? 'A' : score.B >= needed ? 'B' : null;
       if (decided) this.log(matchId, 'score', `Serie entschieden: ${this.teamName(ended.match, decided)} gewinnt ${score[decided]}:${score[decided === 'A' ? 'B' : 'A']}`);
+      if (decided) this.notify('series_end', matchId, `${this.matchTitle(matchId)}
+Serie entschieden: ${this.teamName(ended.match, decided)} gewinnt ${score[decided]}:${score[decided === 'A' ? 'B' : 'A']}`);
       const hasNext = maps.some((m) => m.number === ended.row.number + 1);
       this.changed(matchId);
       this.emit('mapEnded', { matchId, number: ended.row.number, decided, hasNext });
@@ -555,6 +562,8 @@ export class MatchService extends EventEmitter {
       this.db.prepare("UPDATE series_maps SET status = 'done' WHERE match_id = ? AND status IN ('live','next')").run(match.id);
     }
     this.log(match.id, 'status', message ?? (status === 'finished' ? 'Match abgeschlossen' : 'Match abgebrochen'));
+    this.notify('match_closed', match.id, `${this.matchTitle(match.id)}
+${message ?? (status === 'finished' ? 'Match abgeschlossen' : 'Match abgebrochen')}`);
     this.setStatus(match.id, status);
     this.emit('closed', match.id);
   }
@@ -569,6 +578,45 @@ export class MatchService extends EventEmitter {
     this.db.prepare('UPDATE matches SET last_activity_at = ? WHERE id = ?').run(this.now(), matchId);
   }
 
+  /** Titel für Meldungen, z. B. „Team A vs. Team B (BO3)“. */
+  matchTitle(matchId) {
+    const m = this.getMatch(matchId);
+    return `${m.team_a_name} vs. ${m.team_b_name} (${m.format.toUpperCase()})`;
+  }
+
+  /**
+   * Meldung an den Discord-Webhook, falls konfiguriert. Ohne Stream-Schlüssel gehört die Übersicht
+   * des Matches dazu, mit Schlüssel entfällt der Link, damit der Schlüssel nicht in den Kanal gelangt.
+   */
+  /** Discord-Meldungen: der Webhook muss eingerichtet und das Ereignis ausgewählt sein. */
+  notificationSettings() {
+    const row = this.db.prepare("SELECT value FROM settings WHERE key = 'discord_events'").get();
+    let stored = {};
+    try {
+      stored = row ? JSON.parse(row.value) : {};
+    } catch {
+      stored = {};
+    }
+    const events = Object.fromEntries(NOTIFY_EVENTS.map(({ key }) => [key, stored[key] !== false]));
+    return { enabled: this.notifier.enabled, events, catalog: NOTIFY_EVENTS };
+  }
+
+  setNotificationEvents(input) {
+    if (!input || typeof input !== 'object') throw new HttpError(400, 'Ungültige Auswahl der Meldungen', 'invalid');
+    const events = Object.fromEntries(NOTIFY_EVENTS.map(({ key }) => [key, input[key] === true]));
+    this.db
+      .prepare("INSERT INTO settings (key, value) VALUES ('discord_events', ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value")
+      .run(JSON.stringify(events));
+    return this.notificationSettings();
+  }
+
+  notify(type, matchId, text) {
+    if (!this.notifier.enabled || !this.notificationSettings().events[type]) return;
+    const link = this.config.streamKey ? '' : `
+${this.config.publicUrl}/stream/match/${matchId}`;
+    this.notifier.send(`${text}${link}`);
+  }
+
   log(matchId, type, message) {
     this.db
       .prepare('INSERT INTO events (match_id, type, message, created_at) VALUES (?, ?, ?, ?)')

server/src/servers/serverManager.js

@@ -265,6 +265,7 @@ export class ServerManager {
     } else if (status.state === 'failed') {
       Object.assign(fields, { status: current.status === 'starting' ? 'start_failed' : 'failed', message: status.message });
       this.service.log(matchId, 'server', `Server-Fehler: ${status.message}`);
+      this.service.notify('server_error', matchId, `Server-Fehler bei ${this.service.matchTitle(matchId)}: ${status.message}`);
     } else if (status.state === 'stopped') {
       Object.assign(fields, { status: 'stopped', stopped_at: Date.now(), message: status.message ?? 'Server wurde extern beendet' });
       this.service.log(matchId, 'server', 'Server wurde außerhalb der Anwendung beendet');
@@ -387,6 +388,7 @@ export class ServerManager {
       throw new HttpError(502, `Befehl konnte nicht gesendet werden: ${err.message}`, 'server_error');
     }
     this.service.log(viewer.matchId, 'server', this.adapter.simulated ? 'Aufwärmphase beendet (simuliert)' : 'Aufwärmphase beendet – Match startet');
+    this.service.notify('match_start', viewer.matchId, `Match gestartet: ${this.service.matchTitle(viewer.matchId)}`);
     if (this.adapter.simulated) this.startDemoSimulation(viewer.matchId);
     this.service.changed(viewer.matchId);
   }