feat(auto-threads): Add auto-thread creation and config schema

Automatically create threads from messages in configured channels. Adds a call to MessageCreate._handleAutoThreads and implements the handler to lookup per-channel auto-thread config, skip users with excluded roles, and start a thread with a templated name (supports $USERNAME, $SURFACE_NAME, $USER_ID). Updates the guild config schema with autoThreadSchema and registers auto_threads in rawGuildConfigSchema (includes channel_id, name with placeholders, and exclude_roles). Thread creation errors are caught to avoid unhandled rejections.

Author: SplderMat

src/events/MessageCreate.ts

@@ -61,6 +61,7 @@ export default class MessageCreate extends EventListener {
 
 		Messages.queue(message);
 		MessageCreate._handleAutoReactions(message, config);
+		MessageCreate._handleAutoThreads(message, config);
 		await MessageCreate._handleMediaChannel(message, config);
 
 		// Handle media conversion
@@ -235,6 +236,27 @@ export default class MessageCreate extends EventListener {
 		}
 	}
 
+	private static _handleAutoThreads(message: Message<true>, config: GuildConfig): void {
+		const autoThreadChannel = config.data.auto_threads
+			.find(autoThreadChannel => autoThreadChannel.channel_id === message.channel.id);
+
+		if (!autoThreadChannel) return;
+
+		const isExcluded = message.member?.roles.cache.some(role =>
+			autoThreadChannel.exclude_roles.includes(role.id)
+		);
+
+		if (isExcluded) return;
+
+		message.startThread({
+			name: autoThreadChannel.name
+				.replace("$USERNAME", `@${message.author.username}`)
+				.replace("$SURFACE_NAME", getSurfaceName(message.member ?? message.author))
+				.replace("$USER_ID", message.author.id),
+			reason: `Auto-thread created from @${message.author.username} (${message.author.id})'s message with ID ${message.id} in #${message.channel.name}`
+		}).catch(() => null);
+	}
+
 	private static async _handleMediaConversion(message: Message<true>, config: GuildConfig): Promise<void> {
 		if (!message.attachments.size || message.content) return;
 

src/managers/config/schema.ts

@@ -293,6 +293,22 @@ const autoReactionSchema = z.object({
 	exclude_patterns: z.array(stringSchema).default([])
 });
 
+const autoThreadSchema = z.object({
+	// The channel to listen for messages in
+	channel_id: snowflakeSchema,
+	/**
+     * The name of the thread to create
+     *
+     * ## Args
+     *
+     * - `$USERNAME`: The username of the message author
+	 * - `$SURFACE_NAME`: The username and, if available, visible name of the message author on the current surface (e.g., their nickname in that guild)
+	 * - `$USER_ID`: The ID of the message author
+     */
+	name: placeholderString(["USERNAME", "SURFACE_NAME", "USER_ID"], 1, 100).default("$SURFACE_NAME's thread"),
+	exclude_roles: z.array(snowflakeSchema).default([]),
+});
+
 const reportSchema = z.object({
 	// Channel to send reports to
 	report_channel: snowflakeSchema,
@@ -540,6 +556,7 @@ export const rawGuildConfigSchema = z.object({
 	// Automatically publish announcement messages in these channels
 	auto_publish_announcements: z.array(snowflakeSchema).default([]),
 	auto_reactions: z.array(autoReactionSchema).default([]),
+	auto_threads: z.array(autoThreadSchema).default([]),
 	// Toggle the `SendMessages` permission in a channel depending on whether a stage event is active
 	stage_event_overrides: z.array(stageEventOverrideSchema).default([]),
 	notification_channel: snowflakeSchema.optional(),