- Add DeletedMessagesListener to log deleted and bulk deleted messages

- Update moderation module to include `DeletedMessagesListener`
- Introduce configurable options for deleted message logging in `Config` and `config.type`
- Adjust PostgreSQL volume path in `docker-compose.dev.yml`
- Minor `package.json` script cleanup for `typecheck` command

Author: Pdzly

docker-compose.dev.yml

@@ -1,5 +1,3 @@
-version: '3.8'
-
 services:
   postgres:
     image: postgres:18
@@ -12,7 +10,7 @@ services:
     ports:
       - "3306:5432"
     volumes:
-      - postgres_data:/var/lib/postgresql/data
+      - postgres_data:/var/lib/postgresql
     healthcheck:
       test: [ "CMD-SHELL", "pg_isready -U postgres" ]
       interval: 10s

package.json

@@ -9,7 +9,7 @@
 	"scripts": {
 		"version": "echo $npm_package_version",
 		"lint": "bunx biome check --fix",
-		"typecheck": "bunx tsc --noEmit --build tsconfig.json",
+		"typecheck": "bunx tsc  --build --noEmit tsconfig.json",
 		"typecheck:prod": "bunx tsc --noEmit -p tsconfig.production.json",
 		"watch-dev": "bun --watch src/index.ts",
 		"start": "bun --trace-warnings src/index.ts",

src/Config.prod.ts

@@ -23,7 +23,10 @@ export const config: Config = {
 	commands: {
 		daily: "1059214166075912225",
 	},
-
+	deletedMessageLog: {
+		cacheTtlMs: 1000 * 60 * 60 * 24,
+		excludedChannels: [],
+	},
 	roles: {
 		tiers: [
 			"821743100203368458", // @everyone (tier 0)

src/Config.ts

@@ -23,6 +23,10 @@ const devConfig: Config = {
 	commands: {
 		daily: "1029850807794937949",
 	},
+	deletedMessageLog: {
+		cacheTtlMs: 1000 * 60 * 60 * 24,
+		excludedChannels: [],
+	},
 	roles: {
 		tiers: [
 			"904478147351806012", // @everyone (tier 0)

src/config.type.ts

@@ -52,6 +52,12 @@ export interface Config {
 		archiveChannel: string;
 		pingRole?: Snowflake;
 	};
+	deletedMessageLog?: {
+		/** Cache TTL in milliseconds (default: 24 hours) */
+		cacheTtlMs?: number;
+		/** Additional channel IDs to exclude from tracking (mod channels auto-excluded) */
+		excludedChannels?: Snowflake[];
+	};
 	branding: BrandingConfig;
 	informationMessage?: InformationMessage;
 }

src/modules/moderation/deletedMessages.listener.ts

@@ -0,0 +1,104 @@
+import * as Sentry from "@sentry/bun";
+import type { Message, Snowflake } from "discord.js";
+import ExpiryMap from "expiry-map";
+import { config } from "../../Config.js";
+import { logger } from "../../logging.js";
+import type { EventListener } from "../module.js";
+import {
+	type CachedMessage,
+	logBulkDeletedMessages,
+	logDeletedMessage,
+} from "./logs.js";
+
+// Configurable TTL - default 24 hours
+const CACHE_TTL_MS =
+	config.deletedMessageLog?.cacheTtlMs ?? 1000 * 60 * 60 * 24;
+
+const messageCache = new ExpiryMap<Snowflake, CachedMessage>(CACHE_TTL_MS);
+
+// Auto-excluded mod channels
+const modChannels = new Set([
+	config.channels.modLog,
+	config.channels.auditLog,
+	config.modmail.channel,
+]);
+
+function isExcludedChannel(channelId: Snowflake): boolean {
+	const additionalExcluded = config.deletedMessageLog?.excludedChannels ?? [];
+	return modChannels.has(channelId) || additionalExcluded.includes(channelId);
+}
+
+function cacheMessage(message: Message): void {
+	if (
+		message.author.bot ||
+		!message.inGuild() ||
+		isExcludedChannel(message.channelId)
+	)
+		return;
+
+	messageCache.set(message.id, {
+		id: message.id,
+		content: message.content,
+		authorId: message.author.id,
+		authorTag: message.author.tag,
+		channelId: message.channelId,
+		createdTimestamp: message.createdTimestamp,
+		attachmentUrls: message.attachments.map((a) => a.url),
+	});
+}
+
+export const DeletedMessagesListener: EventListener = {
+	messageCreate(_, message) {
+		if (!message.inGuild()) return;
+		cacheMessage(message);
+	},
+
+	messageUpdate(_, _oldMessage, newMessage) {
+		if (!newMessage.inGuild()) return;
+		if (newMessage.partial) return;
+		cacheMessage(newMessage);
+	},
+
+	async messageDelete(client, message) {
+		try {
+			if (isExcludedChannel(message.channelId)) return;
+
+			const cached = messageCache.get(message.id);
+			if (!cached) {
+				logger.debug(`Deleted message ${message.id} not in cache`);
+				return;
+			}
+
+			await logDeletedMessage(client, cached);
+			messageCache.delete(message.id);
+		} catch (error) {
+			logger.error("Failed to log deleted message:", error);
+			Sentry.captureException(error);
+		}
+	},
+
+	async messageDeleteBulk(client, messages, channel) {
+		try {
+			if (isExcludedChannel(channel.id)) return;
+
+			const cachedMessages: CachedMessage[] = [];
+			for (const [id] of messages) {
+				const cached = messageCache.get(id);
+				if (cached) {
+					cachedMessages.push(cached);
+					messageCache.delete(id);
+				}
+			}
+
+			if (cachedMessages.length === 0) {
+				logger.debug(`Bulk deletion in ${channel.id} - no messages in cache`);
+				return;
+			}
+
+			await logBulkDeletedMessages(client, cachedMessages, channel.id);
+		} catch (error) {
+			logger.error("Failed to log bulk deleted messages:", error);
+			Sentry.captureException(error);
+		}
+	},
+};

src/modules/moderation/logs.ts

@@ -11,6 +11,16 @@ import { logger } from "../../logging.js";
 import { prettyPrintDuration } from "../../util/timespan.js";
 import { actualMention, fakeMention } from "../../util/users.js";
 
+export interface CachedMessage {
+	id: Snowflake;
+	content: string;
+	authorId: Snowflake;
+	authorTag: string;
+	channelId: Snowflake;
+	createdTimestamp: number;
+	attachmentUrls: string[];
+}
+
 export type ModerationLog =
 	| BanLog
 	| UnbanLog
@@ -153,3 +163,86 @@ export async function logModerationAction(
 		embeds: [embed],
 	});
 }
+
+export async function logDeletedMessage(
+	client: Client,
+	message: CachedMessage,
+) {
+	const modLogChannel = await client.channels.fetch(config.channels.modLog);
+	if (!modLogChannel?.isSendable()) {
+		logger.error("Moderation log channel not sendable");
+		return;
+	}
+
+	const contentDisplay =
+		message.content.slice(0, 1024) || "*[No text content]*";
+
+	const embed = new EmbedBuilder()
+		.setTitle("Message Deleted")
+		.setColor("Grey")
+		.setDescription(
+			`**Author**: <@${message.authorId}> (${message.authorTag})\n` +
+				`**Channel**: <#${message.channelId}>\n` +
+				`**Created**: <t:${Math.round(message.createdTimestamp / 1000)}:R>\n\n` +
+				`**Content**:\n${contentDisplay}`,
+		)
+		.setFooter({ text: `Message ID: ${message.id}` })
+		.setTimestamp();
+
+	if (message.attachmentUrls.length > 0) {
+		const attachmentList =
+			message.attachmentUrls.slice(0, 5).join("\n") +
+			(message.attachmentUrls.length > 5
+				? `\n... and ${message.attachmentUrls.length - 5} more`
+				: "");
+		embed.addFields({
+			name: "Attachments",
+			value: attachmentList,
+		});
+	}
+
+	await modLogChannel.send({ embeds: [embed] });
+}
+
+export async function logBulkDeletedMessages(
+	client: Client,
+	messages: CachedMessage[],
+	channelId: Snowflake,
+) {
+	const modLogChannel = await client.channels.fetch(config.channels.modLog);
+	if (!modLogChannel?.isSendable()) {
+		logger.error("Moderation log channel not sendable");
+		return;
+	}
+
+	// Sort by timestamp
+	messages.sort((a, b) => a.createdTimestamp - b.createdTimestamp);
+
+	// Build a summary - truncate if too many
+	const maxDisplayed = 10;
+	const displayed = messages.slice(0, maxDisplayed);
+	const remaining = messages.length - maxDisplayed;
+
+	let messageList = displayed
+		.map(
+			(m) =>
+				`**${m.authorTag}** (<t:${Math.round(m.createdTimestamp / 1000)}:t>): ${m.content.slice(0, 100) || "*[No text]*"}`,
+		)
+		.join("\n");
+
+	if (remaining > 0) {
+		messageList += `\n... and ${remaining} more messages`;
+	}
+
+	const embed = new EmbedBuilder()
+		.setTitle("Bulk Messages Deleted")
+		.setColor("DarkGrey")
+		.setDescription(
+			`**Channel**: <#${channelId}>\n` +
+				`**Count**: ${messages.length} messages\n\n` +
+				`**Messages**:\n${messageList.slice(0, 2000)}`,
+		)
+		.setTimestamp();
+
+	await modLogChannel.send({ embeds: [embed] });
+}

src/modules/moderation/moderation.module.ts

@@ -1,5 +1,6 @@
 import type Module from "../module.js";
 import { BanCommand } from "./ban.command.js";
+import { DeletedMessagesListener } from "./deletedMessages.listener.js";
 import { InviteListeners } from "./discordInvitesMonitor.listener.js";
 import { KickCommand } from "./kick.command.js";
 import { SoftBanCommand } from "./softBan.command.js";
@@ -18,5 +19,5 @@ export const ModerationModule: Module = {
 		KickCommand,
 		ZookeepCommand,
 	],
-	listeners: [...InviteListeners, TempBanListener],
+	listeners: [...InviteListeners, TempBanListener, DeletedMessagesListener],
 };