Skip to content

A free and open source instant messaging and VoIP chat app built for friends, groups, and communities.

TypeScript fluxerfluxerapp
13.4 KB
Raw Blame
// SPDX-License-Identifier: AGPL-3.0-or-later

import {requireSudoMode} from '@app/api/auth/services/SudoVerificationService';
import {createGuildID, createRoleID, createUserID} from '@app/api/BrandedTypes';
import {LoginRequired} from '@app/api/middleware/AuthMiddleware';
import {RateLimitMiddleware} from '@app/api/middleware/RateLimitMiddleware';
import {jsonAssetBodyLimit, RequestBodyLimit} from '@app/api/middleware/RequestBodyLimitMiddleware';
import {OpenAPI} from '@app/api/middleware/ResponseTypeMiddleware';
import {SudoModeMiddleware} from '@app/api/middleware/SudoModeMiddleware';
import {RateLimitConfigs} from '@app/api/RateLimitConfig';
import type {HonoApp} from '@app/api/types/HonoEnv';
import {Validator} from '@app/api/Validator';
import {
	GuildIdParam,
	GuildIdUserIdParam,
	GuildIdUserIdRoleIdParam,
} from '@fluxer/schema/src/domains/common/CommonParamSchemas';
import {
	GuildBanListResponse,
	GuildMemberListResponse,
	GuildMemberResponse,
} from '@fluxer/schema/src/domains/guild/GuildMemberSchemas';
import {
	GuildBanCreateRequest,
	GuildMemberListQuery,
	GuildMemberUpdateRequest,
	GuildTransferOwnershipWithVerificationRequest,
	MyGuildMemberUpdateRequest,
} from '@fluxer/schema/src/domains/guild/GuildRequestSchemas';
import {GuildResponse} from '@fluxer/schema/src/domains/guild/GuildResponseSchemas';

export function GuildMemberController(app: HonoApp) {
	app.get(
		'/guilds/:guild_id/members',
		RateLimitMiddleware(RateLimitConfigs.GUILD_MEMBERS),
		LoginRequired,
		Validator('param', GuildIdParam),
		Validator('query', GuildMemberListQuery),
		OpenAPI({
			operationId: 'list_guild_members',
			summary: 'List guild members',
			responseSchema: GuildMemberListResponse,
			statusCode: 200,
			security: ['botToken', 'bearerToken', 'sessionToken'],
			tags: ['Guilds'],
			description:
				'List guild members. Supports pagination with limit and after cursor. Returns member information for the specified guild.',
		}),
		async (ctx) => {
			const userId = ctx.get('user').id;
			const guildId = createGuildID(ctx.req.valid('param').guild_id);
			const {limit, after} = ctx.req.valid('query');
			return ctx.json(
				await ctx.get('guildService').members.getMembers({
					userId,
					guildId,
					limit,
					after: after != null ? createUserID(after) : undefined,
				}),
			);
		},
	);
	app.get(
		'/guilds/:guild_id/members/@me',
		RateLimitMiddleware(RateLimitConfigs.GUILD_MEMBERS),
		LoginRequired,
		Validator('param', GuildIdParam),
		OpenAPI({
			operationId: 'get_current_guild_member',
			summary: 'Get current user guild member',
			responseSchema: GuildMemberResponse,
			statusCode: 200,
			security: ['botToken', 'bearerToken', 'sessionToken'],
			tags: ['Guilds'],
			description:
				'Get current user guild member. Returns the member information for the authenticated user in the specified guild.',
		}),
		async (ctx) => {
			const userId = ctx.get('user').id;
			const guildId = createGuildID(ctx.req.valid('param').guild_id);
			const requestCache = ctx.get('requestCache');
			return ctx.json(
				await ctx.get('guildService').members.getMember({userId, targetId: userId, guildId, requestCache}),
			);
		},
	);
	app.get(
		'/guilds/:guild_id/members/:user_id',
		RateLimitMiddleware(RateLimitConfigs.GUILD_MEMBERS),
		LoginRequired,
		Validator('param', GuildIdUserIdParam),
		OpenAPI({
			operationId: 'get_guild_member',
			summary: 'Get guild member by user ID',
			responseSchema: GuildMemberResponse,
			statusCode: 200,
			security: ['botToken', 'bearerToken', 'sessionToken'],
			tags: ['Guilds'],
			description:
				'Get guild member by user ID. Returns member information including roles, nickname, and join date for the specified user in the guild.',
		}),
		async (ctx) => {
			const {guild_id, user_id} = ctx.req.valid('param');
			const userId = ctx.get('user').id;
			const targetId = createUserID(user_id);
			const guildId = createGuildID(guild_id);
			const requestCache = ctx.get('requestCache');
			return ctx.json(await ctx.get('guildService').members.getMember({userId, targetId, guildId, requestCache}));
		},
	);
	app.patch(
		'/guilds/:guild_id/members/@me',
		RequestBodyLimit(jsonAssetBodyLimit({avatar: 1, banner: 1})),
		RateLimitMiddleware(RateLimitConfigs.GUILD_MEMBER_UPDATE),
		LoginRequired,
		Validator('param', GuildIdParam),
		Validator('json', MyGuildMemberUpdateRequest),
		OpenAPI({
			operationId: 'update_current_guild_member',
			summary: 'Update current user guild member',
			responseSchema: GuildMemberResponse,
			statusCode: 200,
			security: ['botToken', 'bearerToken', 'sessionToken'],
			tags: ['Guilds'],
			description: 'Update current user guild member. User can modify their own nickname within the guild.',
		}),
		async (ctx) => {
			const userId = ctx.get('user').id;
			const guildId = createGuildID(ctx.req.valid('param').guild_id);
			const requestCache = ctx.get('requestCache');
			const data = ctx.req.valid('json');
			const auditLogReason = ctx.get('auditLogReason') ?? null;
			const result = await ctx
				.get('guildService')
				.members.updateMember({userId, targetId: userId, guildId, data, requestCache}, auditLogReason);
			return ctx.json(result);
		},
	);
	app.patch(
		'/guilds/:guild_id/members/:user_id',
		RequestBodyLimit(jsonAssetBodyLimit({avatar: 1, banner: 1})),
		RateLimitMiddleware(RateLimitConfigs.GUILD_MEMBER_UPDATE),
		LoginRequired,
		Validator('param', GuildIdUserIdParam),
		Validator('json', GuildMemberUpdateRequest),
		OpenAPI({
			operationId: 'update_guild_member',
			summary: 'Update guild member',
			responseSchema: GuildMemberResponse,
			statusCode: 200,
			security: ['botToken', 'bearerToken', 'sessionToken'],
			tags: ['Guilds'],
			description:
				'Update guild member. Requires manage_members permission. Can modify member nickname, voice state, and other member properties.',
		}),
		async (ctx) => {
			const {guild_id, user_id} = ctx.req.valid('param');
			const userId = ctx.get('user').id;
			const targetId = createUserID(user_id);
			const guildId = createGuildID(guild_id);
			const data = ctx.req.valid('json');
			const requestCache = ctx.get('requestCache');
			const auditLogReason = ctx.get('auditLogReason') ?? null;
			const result = await ctx
				.get('guildService')
				.members.updateMember({userId, targetId, guildId, data, requestCache}, auditLogReason);
			return ctx.json(result);
		},
	);
	app.delete(
		'/guilds/:guild_id/members/:user_id',
		RateLimitMiddleware(RateLimitConfigs.GUILD_MEMBER_REMOVE),
		LoginRequired,
		Validator('param', GuildIdUserIdParam),
		OpenAPI({
			operationId: 'remove_guild_member',
			summary: 'Remove guild member',
			responseSchema: null,
			statusCode: 204,
			security: ['botToken', 'bearerToken', 'sessionToken'],
			tags: ['Guilds'],
			description: 'Remove guild member. Requires kick_members permission. Removes the specified user from the guild.',
		}),
		async (ctx) => {
			const {guild_id, user_id} = ctx.req.valid('param');
			const userId = ctx.get('user').id;
			const targetId = createUserID(user_id);
			const guildId = createGuildID(guild_id);
			const auditLogReason = ctx.get('auditLogReason') ?? null;
			await ctx.get('guildService').members.removeMember({userId, targetId, guildId}, auditLogReason);
			return ctx.body(null, 204);
		},
	);
	app.post(
		'/guilds/:guild_id/transfer-ownership',
		RateLimitMiddleware(RateLimitConfigs.GUILD_UPDATE),
		LoginRequired,
		Validator('param', GuildIdParam),
		SudoModeMiddleware,
		Validator('json', GuildTransferOwnershipWithVerificationRequest),
		OpenAPI({
			operationId: 'transfer_guild_ownership',
			summary: 'Transfer guild ownership',
			responseSchema: GuildResponse,
			statusCode: 200,
			security: ['botToken', 'bearerToken', 'sessionToken'],
			tags: ['Guilds'],
			description:
				'Transfer guild ownership. Only current owner can transfer. Requires sudo mode verification (MFA). Transfers all guild permissions to a new owner.',
		}),
		async (ctx) => {
			const user = ctx.get('user');
			const userId = user.id;
			const guildId = createGuildID(ctx.req.valid('param').guild_id);
			const body = ctx.req.valid('json');
			await requireSudoMode(ctx, user, body);
			const {new_owner_id} = body;
			const newOwnerId = createUserID(new_owner_id);
			const auditLogReason = ctx.get('auditLogReason') ?? null;
			return ctx.json(
				await ctx.get('guildService').data.ownership.transferOwnership({userId, guildId, newOwnerId}, auditLogReason),
			);
		},
	);
	app.get(
		'/guilds/:guild_id/bans',
		RateLimitMiddleware(RateLimitConfigs.GUILD_MEMBERS),
		LoginRequired,
		Validator('param', GuildIdParam),
		OpenAPI({
			operationId: 'list_guild_bans',
			summary: 'List guild bans',
			responseSchema: GuildBanListResponse,
			statusCode: 200,
			security: ['botToken', 'bearerToken', 'sessionToken'],
			tags: ['Guilds'],
			description:
				'List guild bans. Requires ban_members permission. Returns all banned users for the guild including ban reasons and expiry times.',
		}),
		async (ctx) => {
			const userId = ctx.get('user').id;
			const guildId = createGuildID(ctx.req.valid('param').guild_id);
			const requestCache = ctx.get('requestCache');
			return ctx.json(await ctx.get('guildService').moderation.listBans({userId, guildId, requestCache}));
		},
	);
	app.put(
		'/guilds/:guild_id/bans/:user_id',
		RateLimitMiddleware(RateLimitConfigs.GUILD_MEMBER_REMOVE),
		LoginRequired,
		Validator('param', GuildIdUserIdParam),
		Validator('json', GuildBanCreateRequest),
		OpenAPI({
			operationId: 'ban_guild_member',
			summary: 'Ban guild member',
			responseSchema: null,
			statusCode: 204,
			security: ['botToken', 'bearerToken', 'sessionToken'],
			tags: ['Guilds'],
			description:
				'Ban guild member. Requires ban_members permission. Prevents user from joining; optionally deletes recent messages and sets ban expiry duration.',
		}),
		async (ctx) => {
			const {guild_id, user_id} = ctx.req.valid('param');
			const userId = ctx.get('user').id;
			const targetId = createUserID(user_id);
			const guildId = createGuildID(guild_id);
			const {delete_message_days, delete_message_seconds, reason, ban_duration_seconds} = ctx.req.valid('json');
			const auditLogReason = ctx.get('auditLogReason') ?? null;
			const effectiveReason = reason ?? auditLogReason ?? undefined;
			await ctx.get('guildService').moderation.banMember(
				{
					userId,
					guildId,
					targetId,
					deleteMessageDays: delete_message_days,
					deleteMessageSeconds: delete_message_seconds,
					reason: effectiveReason,
					banDurationSeconds: ban_duration_seconds,
				},
				auditLogReason,
			);
			return ctx.body(null, 204);
		},
	);
	app.delete(
		'/guilds/:guild_id/bans/:user_id',
		RateLimitMiddleware(RateLimitConfigs.GUILD_MEMBER_REMOVE),
		LoginRequired,
		Validator('param', GuildIdUserIdParam),
		OpenAPI({
			operationId: 'unban_guild_member',
			summary: 'Unban guild member',
			responseSchema: null,
			statusCode: 204,
			security: ['botToken', 'bearerToken', 'sessionToken'],
			tags: ['Guilds'],
			description:
				'Unban guild member. Requires ban_members permission. Removes ban and allows user to rejoin the guild.',
		}),
		async (ctx) => {
			const {guild_id, user_id} = ctx.req.valid('param');
			const userId = ctx.get('user').id;
			const targetId = createUserID(user_id);
			const guildId = createGuildID(guild_id);
			const auditLogReason = ctx.get('auditLogReason') ?? null;
			await ctx.get('guildService').moderation.unbanMember({userId, guildId, targetId}, auditLogReason);
			return ctx.body(null, 204);
		},
	);
	app.put(
		'/guilds/:guild_id/members/:user_id/roles/:role_id',
		RateLimitMiddleware(RateLimitConfigs.GUILD_MEMBER_ROLE_ADD),
		LoginRequired,
		Validator('param', GuildIdUserIdRoleIdParam),
		OpenAPI({
			operationId: 'add_guild_member_role',
			summary: 'Add role to guild member',
			responseSchema: null,
			statusCode: 204,
			security: ['botToken', 'bearerToken', 'sessionToken'],
			tags: ['Guilds'],
			description:
				'Add role to guild member. Requires manage_roles permission. Grants the specified role to the user in the guild.',
		}),
		async (ctx) => {
			const {guild_id, user_id, role_id} = ctx.req.valid('param');
			const userId = ctx.get('user').id;
			const targetId = createUserID(user_id);
			const guildId = createGuildID(guild_id);
			const roleId = createRoleID(role_id);
			const requestCache = ctx.get('requestCache');
			const auditLogReason = ctx.get('auditLogReason') ?? null;
			await ctx
				.get('guildService')
				.members.addMemberRole({userId, targetId, guildId, roleId, requestCache}, auditLogReason);
			return ctx.body(null, 204);
		},
	);
	app.delete(
		'/guilds/:guild_id/members/:user_id/roles/:role_id',
		RateLimitMiddleware(RateLimitConfigs.GUILD_MEMBER_ROLE_REMOVE),
		LoginRequired,
		Validator('param', GuildIdUserIdRoleIdParam),
		OpenAPI({
			operationId: 'remove_guild_member_role',
			summary: 'Remove role from guild member',
			responseSchema: null,
			statusCode: 204,
			security: ['botToken', 'bearerToken', 'sessionToken'],
			tags: ['Guilds'],
			description:
				'Remove role from guild member. Requires manage_roles permission. Revokes the specified role from the user in the guild.',
		}),
		async (ctx) => {
			const {guild_id, user_id, role_id} = ctx.req.valid('param');
			const userId = ctx.get('user').id;
			const targetId = createUserID(user_id);
			const guildId = createGuildID(guild_id);
			const roleId = createRoleID(role_id);
			const requestCache = ctx.get('requestCache');
			const auditLogReason = ctx.get('auditLogReason') ?? null;
			await ctx
				.get('guildService')
				.members.removeMemberRole({userId, targetId, guildId, roleId, requestCache}, auditLogReason);
			return ctx.body(null, 204);
		},
	);
}