chatservice

server/src/services/chatService/handlers.js

@@ -0,0 +1,93 @@
+// Chat Message Handlers
+// Purpose: Handles inbound socket/external chat payloads and applies moderation, routing, and side effects.
+// Scope: Owns message validation pipeline and typed outbound message construction.
+const logger = require('../../globals/logger').child('chatService');
+const { getRole } = require('../roleService');
+const { withinRateLimit } = require('./state');
+const { hasProfanity, isKeymash, normalizeUserText } = require('./contentFilters');
+const { buildMessage, buildTypingPayload, resolveRoverId, isPrivateClosedRoverId, buildRoverCtxSnapshot } = require('./contextBuilders');
+const { broadcastMessage, broadcastTyping } = require('./broadcast');
+const { playTypingNote, normalizeTtsOptions, maybeSendAccessNotice, maybeSpeak, TYPING_SEND_NOTE } = require('./notifications');
+
+function createHandlers({ sendSystemMessage }) {
+  function handleIncoming({ text, tts } = {}, socket, cb = () => {}) {
+    const role = getRole(socket);
+    void role;
+    const normalized = normalizeUserText(text);
+    const clean = normalized.trim();
+    if (!clean) return cb({ error: 'Message required' });
+    if (!withinRateLimit(socket.id)) return cb({ error: 'Slow down' });
+    if (clean.length > 400) return cb({ error: 'Message too long' });
+    if (hasProfanity(clean)) return cb({ error: 'Message blocked' });
+
+    const roverId = resolveRoverId(socket?.id);
+    const ttsOptions = normalizeTtsOptions(tts);
+    const message = buildMessage(socket, clean, {
+      fromDiscord: false,
+      roverId,
+      roverCtx: buildRoverCtxSnapshot(roverId),
+      tts: ttsOptions,
+    });
+
+    logger.info('Chat message', { socket: socket.id, roverId: message.roverId });
+    playTypingNote(roverId, TYPING_SEND_NOTE, socket?.id);
+
+    if (isPrivateClosedRoverId(message.roverId)) {
+      const forcedTts = ttsOptions || { speak: true, engine: 'flite' };
+      maybeSpeak(socket, message, forcedTts);
+      cb({ success: true, privateOnly: true });
+      return;
+    }
+
+    broadcastMessage(message);
+    maybeSendAccessNotice(message, sendSystemMessage);
+    maybeSpeak(socket, message, ttsOptions);
+    cb({ success: true });
+  }
+
+  function sendExternalMessage({ text, nickname = 'Discord', role = 'admin', roverId = null, discordGuildId = null, discordGuildName = null, discordGuildIconUrl = null, discordChannelId = null, discordUserId = null, discordUserName = null, discordUserAvatarUrl = null }) {
+    const normalized = normalizeUserText(text);
+    const clean = normalized.trim();
+    if (!clean || clean.length > 400) throw new Error('Message invalid');
+    if (hasProfanity(clean)) throw new Error('Message blocked');
+    if (isKeymash(clean)) throw new Error('Message looks like spam');
+    if (isPrivateClosedRoverId(roverId)) throw new Error('Private rover chat is closed');
+
+    const message = buildMessage(null, clean, {
+      nickname,
+      role,
+      roverId,
+      roverCtx: buildRoverCtxSnapshot(roverId),
+      fromDiscord: true,
+      discordGuildId,
+      discordGuildName,
+      discordGuildIconUrl,
+      discordChannelId,
+      discordUserId,
+      discordUserName,
+      discordUserAvatarUrl,
+    });
+
+    logger.info('External chat message', { roverId, nickname });
+    broadcastMessage(message);
+    maybeSendAccessNotice(message, sendSystemMessage);
+    return message;
+  }
+
+  function sendExternalTyping({ nickname = 'Discord', role = 'user', roverId = null, discordGuildId = null, discordGuildName = null, discordGuildIconUrl = null, discordChannelId = null, discordUserId = null, discordUserName = null, discordUserAvatarUrl = null, isTyping = true }) {
+    if (isPrivateClosedRoverId(roverId)) return null;
+    const payload = buildTypingPayload(null, { nickname, role, roverId, fromDiscord: true, discordGuildId, discordGuildName, discordGuildIconUrl, discordChannelId, discordUserId, discordUserName, discordUserAvatarUrl, isTyping });
+    broadcastTyping(payload);
+    return payload;
+  }
+
+  return {
+    handleIncoming,
+    sendExternalMessage,
+    sendExternalTyping,
+  };
+}
+
+module.exports = {
+  createHandlers,
+};