/* * Copyright (C) 2026 Fluxer Contributors * * This file is part of Fluxer. * * Fluxer is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * Fluxer is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License * along with Fluxer. If not, see . */ import {type ChannelID, createChannelID, type MessageID, type UserID} from '@fluxer/api/src/BrandedTypes'; import type {MessageRequest, MessageUpdateRequest} from '@fluxer/api/src/channel/MessageTypes'; import {MESSAGE_NONCE_TTL} from '@fluxer/api/src/channel/services/message/MessageHelpers'; import type {LimitConfigService} from '@fluxer/api/src/limits/LimitConfigService'; import {resolveLimitSafe} from '@fluxer/api/src/limits/LimitConfigUtils'; import {createLimitMatchContext} from '@fluxer/api/src/limits/LimitMatchContextBuilder'; import type {Channel} from '@fluxer/api/src/models/Channel'; import type {Message} from '@fluxer/api/src/models/Message'; import type {User} from '@fluxer/api/src/models/User'; import type {ICacheService} from '@fluxer/cache/src/ICacheService'; import { isMessageTypeDeletable, MessageFlags, MessageTypes, Permissions, SENDABLE_MESSAGE_FLAGS, TEXT_BASED_CHANNEL_TYPES, } from '@fluxer/constants/src/ChannelConstants'; import { ATTACHMENT_MAX_SIZE_NON_PREMIUM, MAX_ATTACHMENTS_PER_MESSAGE, MAX_EMBEDS_PER_MESSAGE, MAX_MESSAGE_LENGTH_NON_PREMIUM, MAX_VOICE_MESSAGE_DURATION, } from '@fluxer/constants/src/LimitConstants'; import {ValidationErrorCodes} from '@fluxer/constants/src/ValidationErrorCodes'; import {CannotEditSystemMessageError} from '@fluxer/errors/src/domains/channel/CannotEditSystemMessageError'; import {CannotSendEmptyMessageError} from '@fluxer/errors/src/domains/channel/CannotSendEmptyMessageError'; import {CannotSendMessageToNonTextChannelError} from '@fluxer/errors/src/domains/channel/CannotSendMessageToNonTextChannelError'; import {UnknownMessageError} from '@fluxer/errors/src/domains/channel/UnknownMessageError'; import {FileSizeTooLargeError} from '@fluxer/errors/src/domains/core/FileSizeTooLargeError'; import {InputValidationError} from '@fluxer/errors/src/domains/core/InputValidationError'; import type {GuildResponse} from '@fluxer/schema/src/domains/guild/GuildResponseSchemas'; export class MessageValidationService { constructor( private cacheService: ICacheService, private limitConfigService: LimitConfigService, ) {} ensureTextChannel(channel: Channel): void { if (!TEXT_BASED_CHANNEL_TYPES.has(channel.type)) { throw new CannotSendMessageToNonTextChannelError(); } } validateMessageContent( data: MessageRequest | MessageUpdateRequest, user: User | null, options?: {isUpdate?: boolean; guildFeatures?: Iterable | null}, ): void { const isUpdate = options?.isUpdate ?? false; const hasContent = data.content != null && data.content.trim().length > 0; const hasEmbeds = Boolean(data.embeds && data.embeds.length > 0); const hasAttachments = Boolean(data.attachments && data.attachments.length > 0); const hasFavoriteMeme = Boolean('favorite_meme_id' in data && data.favorite_meme_id != null); const hasStickers = Boolean('sticker_ids' in data && data.sticker_ids != null && data.sticker_ids.length > 0); const hasFlags = data.flags !== undefined && data.flags !== null; const guildFeatures = options?.guildFeatures ?? null; const hasVoiceMessageFlag = !!(data.flags && data.flags & MessageFlags.VOICE_MESSAGE); if (hasVoiceMessageFlag) { this.validateVoiceMessageConstraints( data, hasContent, hasEmbeds, hasStickers, hasFavoriteMeme, user, guildFeatures, ); } if (!hasContent && !hasEmbeds && !hasAttachments && !hasFavoriteMeme && !hasStickers && (!isUpdate || !hasFlags)) { throw new CannotSendEmptyMessageError(); } this.validateContentLength(data.content, user, guildFeatures); const ctx = createLimitMatchContext({user, guildFeatures}); const evaluationContext = guildFeatures ? 'guild' : 'user'; const snapshot = this.limitConfigService.getConfigSnapshot(); const maxEmbeds = Math.floor( resolveLimitSafe(snapshot, ctx, 'max_embeds_per_message', MAX_EMBEDS_PER_MESSAGE, evaluationContext), ); const maxAttachments = Math.floor( resolveLimitSafe(snapshot, ctx, 'max_attachments_per_message', MAX_ATTACHMENTS_PER_MESSAGE, evaluationContext), ); const totalEmbeds = data.embeds?.length ?? 0; if (totalEmbeds > maxEmbeds) { throw InputValidationError.fromCode('embeds', ValidationErrorCodes.TOO_MANY_EMBEDS, {maxEmbeds}); } const totalAttachments = data.attachments?.length ?? 0; if (totalAttachments > maxAttachments) { throw InputValidationError.fromCode('attachments', ValidationErrorCodes.TOO_MANY_FILES, { maxFiles: maxAttachments, }); } } validateContentLength( content: string | null | undefined, user: User | null, guildFeatures?: Iterable | null, ): void { if (content == null) return; const ctx = createLimitMatchContext({user, guildFeatures}); const evaluationContext = guildFeatures ? 'guild' : 'user'; const maxLength = Math.floor( resolveLimitSafe( this.limitConfigService.getConfigSnapshot(), ctx, 'max_message_length', MAX_MESSAGE_LENGTH_NON_PREMIUM, evaluationContext, ), ); if (content.length > maxLength) { throw InputValidationError.fromCode('content', ValidationErrorCodes.CONTENT_EXCEEDS_MAX_LENGTH, { maxLength, }); } } validateMessageEditable(message: Message): void { const editableTypes: ReadonlySet = new Set([MessageTypes.DEFAULT, MessageTypes.REPLY]); if (!editableTypes.has(message.type)) { throw new CannotEditSystemMessageError(); } } calculateMessageFlags(data: {flags?: number; favorite_meme_id?: bigint | null}): number { let flags = data.flags ? data.flags & SENDABLE_MESSAGE_FLAGS : 0; if (data.favorite_meme_id) { flags |= MessageFlags.COMPACT_ATTACHMENTS; } return flags; } validateTotalAttachmentSize( attachments: Array<{size: number | bigint}>, user: User, guildFeatures?: Iterable | null, ): void { const ctx = createLimitMatchContext({user, guildFeatures}); const evaluationContext = guildFeatures ? 'guild' : 'user'; const fallbackMaxSize = ATTACHMENT_MAX_SIZE_NON_PREMIUM; const maxFileSize = Math.floor( resolveLimitSafe( this.limitConfigService.getConfigSnapshot(), ctx, 'max_attachment_file_size', fallbackMaxSize, evaluationContext, ), ); const hasFileExceedingLimit = attachments.some((attachment) => Number(attachment.size) > maxFileSize); if (hasFileExceedingLimit) { throw new FileSizeTooLargeError(maxFileSize); } } async findExistingMessage({ userId, nonce, expectedChannelId, }: { userId: UserID; nonce?: string; expectedChannelId: ChannelID; }): Promise { if (!nonce) return null; const existingNonce = await this.cacheService.get<{channel_id: string; message_id: string}>( `message-nonce:${userId}:${nonce}`, ); if (!existingNonce) return null; const cachedChannelId = createChannelID(BigInt(existingNonce.channel_id)); if (cachedChannelId !== expectedChannelId) { throw new UnknownMessageError(); } return null; } async cacheMessageNonce({ userId, nonce, channelId, messageId, }: { userId: UserID; nonce: string; channelId: ChannelID; messageId: MessageID; }): Promise { await this.cacheService.set( `message-nonce:${userId}:${nonce}`, { channel_id: channelId.toString(), message_id: messageId.toString(), }, MESSAGE_NONCE_TTL, ); } async canDeleteMessage({ message, userId, guild, hasPermission, }: { message: Message; userId: UserID; guild: GuildResponse | null; hasPermission: (permission: bigint) => Promise; }): Promise { if (!isMessageTypeDeletable(message.type)) { return false; } const isAuthor = message.authorId === userId; if (!guild) return isAuthor; const canManageMessages = (await hasPermission(Permissions.SEND_MESSAGES)) && (await hasPermission(Permissions.MANAGE_MESSAGES)); return isAuthor || canManageMessages; } private validateVoiceMessageConstraints( data: MessageRequest, hasContent: boolean, hasEmbeds: boolean, hasStickers: boolean, hasFavoriteMeme: boolean, user: User | null, guildFeatures: Iterable | null | undefined, ): void { if (hasContent) { throw InputValidationError.fromCode('content', ValidationErrorCodes.VOICE_MESSAGES_CANNOT_HAVE_CONTENT); } if (hasEmbeds) { throw InputValidationError.fromCode('embeds', ValidationErrorCodes.VOICE_MESSAGES_CANNOT_HAVE_EMBEDS); } if (hasFavoriteMeme) { throw InputValidationError.fromCode( 'favorite_meme_id', ValidationErrorCodes.VOICE_MESSAGES_CANNOT_HAVE_FAVORITE_MEMES, ); } if (hasStickers) { throw InputValidationError.fromCode('sticker_ids', ValidationErrorCodes.VOICE_MESSAGES_CANNOT_HAVE_STICKERS); } const attachments = data.attachments ?? []; if (attachments.length !== 1) { throw InputValidationError.fromCode('attachments', ValidationErrorCodes.VOICE_MESSAGES_REQUIRE_SINGLE_ATTACHMENT); } const attachment = attachments[0]; if (!('waveform' in attachment) || !attachment.waveform) { throw InputValidationError.fromCode( 'attachments.0.waveform', ValidationErrorCodes.VOICE_MESSAGES_ATTACHMENT_WAVEFORM_REQUIRED, ); } if (!('duration' in attachment) || attachment.duration == null) { throw InputValidationError.fromCode( 'attachments.0.duration', ValidationErrorCodes.VOICE_MESSAGES_ATTACHMENT_DURATION_REQUIRED, ); } const duration = attachment.duration; const ctx = createLimitMatchContext({user, guildFeatures}); const evaluationContext = guildFeatures ? 'guild' : 'user'; const maxDuration = Math.floor( resolveLimitSafe( this.limitConfigService.getConfigSnapshot(), ctx, 'max_voice_message_duration', MAX_VOICE_MESSAGE_DURATION, evaluationContext, ), ); if (duration > maxDuration) { throw InputValidationError.fromCode( 'attachments.0.duration', ValidationErrorCodes.VOICE_MESSAGES_DURATION_EXCEEDS_LIMIT, {maxDuration}, ); } } }