A free and open source instant messaging and VoIP chat app built for friends, groups, and communities.
// SPDX-License-Identifier: AGPL-3.0-or-later
import {createGuildID, createUserID} from '@app/api/BrandedTypes';
import {viewerActive, viewerFromCtx} from '@app/api/experiment/ChannelThreadsGate';
import {LoginRequired} from '@app/api/middleware/AuthMiddleware';
import {RateLimitMiddleware} from '@app/api/middleware/RateLimitMiddleware';
import {OpenAPI} from '@app/api/middleware/ResponseTypeMiddleware';
import {RateLimitConfigs} from '@app/api/RateLimitConfig';
import type {HonoApp, HonoEnv} from '@app/api/types/HonoEnv';
import {Validator} from '@app/api/Validator';
import {GuildIdParam} from '@fluxer/schema/src/domains/common/CommonParamSchemas';
import {
GuildAuditLogListQuery,
GuildAuditLogListQueryWithThreads,
GuildAuditLogListResponse,
} from '@fluxer/schema/src/domains/guild/GuildAuditLogSchemas';
import type {MiddlewareHandler} from 'hono';
const controlAuditLogQuery = Validator('query', GuildAuditLogListQuery) as unknown as MiddlewareHandler<HonoEnv>;
const ControlAuditLogQueryForNonViewers: MiddlewareHandler<HonoEnv> = async (ctx, next) => {
const guildId = ctx.req.param('guild_id');
if (guildId !== undefined && viewerActive(viewerFromCtx(ctx), guildId)) return next();
return controlAuditLogQuery(ctx, next);
};
export function GuildAuditLogController(app: HonoApp) {
app.get(
'/guilds/:guild_id/audit-logs',
RateLimitMiddleware(RateLimitConfigs.GUILD_AUDIT_LOGS),
LoginRequired,
Validator('param', GuildIdParam),
ControlAuditLogQueryForNonViewers,
Validator('query', GuildAuditLogListQueryWithThreads),
OpenAPI({
operationId: 'list_guild_audit_logs',
summary: 'List guild audit logs',
responseSchema: GuildAuditLogListResponse,
statusCode: 200,
security: ['botToken', 'bearerToken', 'sessionToken'],
tags: ['Guilds'],
description:
'List guild audit logs. Requires view_audit_logs permission. Returns guild activity history with pagination and action filtering.',
}),
async (ctx) => {
const userId = ctx.get('user').id;
const guildId = createGuildID(ctx.req.valid('param').guild_id);
const query = ctx.req.valid('query');
const requestCache = ctx.get('requestCache');
const response = await ctx.get('guildService').listGuildAuditLogs({
userId,
viewer: viewerFromCtx(ctx),
guildId,
requestCache,
limit: query.limit ?? undefined,
beforeLogId: query.before ?? undefined,
afterLogId: query.after ?? undefined,
filterUserId: query.user_id ? createUserID(query.user_id) : undefined,
actionType: query.action_type,
});
return ctx.json(response);
},
);
}