// SPDX-License-Identifier: AGPL-3.0-or-later import {AdminACLs} from '@fluxer/constants/src/AdminACLs'; import {GetProcessMemoryStatsRequest} from '@fluxer/schema/src/domains/admin/AdminGuildSchemas'; import { GatewayVoiceStateCountsResponse, GuildMemoryStatsResponse, NodeStatsResponse, ReloadAllGuildsResponse, ReloadGuildsRequest, } from '@fluxer/schema/src/domains/admin/AdminSchemas'; import {createGuildID} from '../../BrandedTypes'; import {requireAdminACL} from '../../middleware/AdminMiddleware'; import {RateLimitMiddleware} from '../../middleware/RateLimitMiddleware'; import {OpenAPI} from '../../middleware/ResponseTypeMiddleware'; import {RateLimitConfigs} from '../../RateLimitConfig'; import type {HonoApp} from '../../types/HonoEnv'; import {Validator} from '../../Validator'; export function GatewayAdminController(app: HonoApp) { app.post( '/admin/gateway/memory-stats', RateLimitMiddleware(RateLimitConfigs.ADMIN_LOOKUP), requireAdminACL(AdminACLs.GATEWAY_MEMORY_STATS), Validator('json', GetProcessMemoryStatsRequest), OpenAPI({ operationId: 'get_guild_memory_statistics', summary: 'Get guild memory statistics', description: 'Returns heap and resident memory usage per guild. Requires GATEWAY_MEMORY_STATS permission.', responseSchema: GuildMemoryStatsResponse, statusCode: 200, security: 'adminApiKey', tags: 'Admin', }), async (ctx) => { const adminService = ctx.get('adminService'); const body = ctx.req.valid('json'); return ctx.json(await adminService.guildServiceAggregate.managementService.getGuildMemoryStats(body.limit)); }, ); app.post( '/admin/gateway/reload-all', RateLimitMiddleware(RateLimitConfigs.ADMIN_GATEWAY_RELOAD), requireAdminACL(AdminACLs.GATEWAY_RELOAD_ALL), Validator('json', ReloadGuildsRequest), OpenAPI({ operationId: 'reload_all_specified_guilds', summary: 'Reload specified guilds', description: 'Reconnects to the database and re-syncs guild state. Used for recovery after data inconsistencies. Requires GATEWAY_RELOAD_ALL permission.', responseSchema: ReloadAllGuildsResponse, statusCode: 200, security: 'adminApiKey', tags: 'Admin', }), async (ctx) => { const adminService = ctx.get('adminService'); const body = ctx.req.valid('json'); const guildIds = body.guild_ids.map((id) => createGuildID(id)); return ctx.json(await adminService.guildServiceAggregate.managementService.reloadAllGuilds(guildIds)); }, ); app.get( '/admin/gateway/stats', RateLimitMiddleware(RateLimitConfigs.ADMIN_LOOKUP), requireAdminACL(AdminACLs.GATEWAY_MEMORY_STATS), OpenAPI({ operationId: 'get_gateway_node_statistics', summary: 'Get gateway node statistics', description: 'Returns uptime, process memory, and guild count. Used to monitor gateway health and performance. Requires GATEWAY_MEMORY_STATS permission.', responseSchema: NodeStatsResponse, statusCode: 200, security: 'adminApiKey', tags: 'Admin', }), async (ctx) => { const adminService = ctx.get('adminService'); return ctx.json(await adminService.guildServiceAggregate.managementService.getNodeStats()); }, ); app.get( '/admin/gateway/voice-state-counts', RateLimitMiddleware(RateLimitConfigs.ADMIN_LOOKUP), requireAdminACL(AdminACLs.GATEWAY_MEMORY_STATS), OpenAPI({ operationId: 'get_gateway_voice_state_counts', summary: 'Get gateway voice state counts', description: 'Returns active voice state counts grouped by voice region and voice server. Requires GATEWAY_MEMORY_STATS permission.', responseSchema: GatewayVoiceStateCountsResponse, statusCode: 200, security: 'adminApiKey', tags: 'Admin', }), async (ctx) => { const adminService = ctx.get('adminService'); return ctx.json(await adminService.guildServiceAggregate.managementService.getVoiceStateCounts()); }, ); }