import { Body, Controller, Delete, Get, HttpCode, HttpStatus, Param, Post, Put } from '@nestjs/common'; import { ApiTags } from '@nestjs/swagger'; import { Endpoint, HistoryBuilder } from 'src/decorators'; import { AuthDto } from 'src/dtos/auth.dto'; import { SessionCreateDto, SessionCreateResponseDto, SessionResponseDto, SessionUpdateDto } from 'src/dtos/session.dto'; import { ApiTag, Permission } from 'src/enum'; import { Auth, Authenticated } from 'src/middleware/auth.guard'; import { SessionService } from 'src/services/session.service'; import { UUIDParamDto } from 'src/validation'; @ApiTags(ApiTag.Sessions) @Controller('sessions') export class SessionController { constructor(private service: SessionService) {} @Post() @Authenticated({ permission: Permission.SessionCreate }) @Endpoint({ summary: 'Create a session', description: 'Create a session as a child to the current session. This endpoint is used for casting.', history: new HistoryBuilder().added('v1').beta('v1').stable('v2'), }) createSession(@Auth() auth: AuthDto, @Body() dto: SessionCreateDto): Promise { return this.service.create(auth, dto); } @Get() @Authenticated({ permission: Permission.SessionRead }) @Endpoint({ summary: 'Retrieve sessions', description: 'Retrieve a list of sessions for the user.', history: new HistoryBuilder().added('v1').beta('v1').stable('v2'), }) getSessions(@Auth() auth: AuthDto): Promise { return this.service.getAll(auth); } @Delete() @Authenticated({ permission: Permission.SessionDelete }) @HttpCode(HttpStatus.NO_CONTENT) @Endpoint({ summary: 'Delete all sessions', description: 'Delete all sessions for the user. This will not delete the current session.', history: new HistoryBuilder().added('v1').beta('v1').stable('v2'), }) deleteAllSessions(@Auth() auth: AuthDto): Promise { return this.service.deleteAll(auth); } @Put(':id') @Authenticated({ permission: Permission.SessionUpdate }) @Endpoint({ summary: 'Update a session', description: 'Update a specific session identified by id.', history: new HistoryBuilder().added('v1').beta('v1').stable('v2'), }) updateSession( @Auth() auth: AuthDto, @Param() { id }: UUIDParamDto, @Body() dto: SessionUpdateDto, ): Promise { return this.service.update(auth, id, dto); } @Delete(':id') @Authenticated({ permission: Permission.SessionDelete }) @HttpCode(HttpStatus.NO_CONTENT) @Endpoint({ summary: 'Delete a session', description: 'Delete a specific session by id.', history: new HistoryBuilder().added('v1').beta('v1').stable('v2'), }) deleteSession(@Auth() auth: AuthDto, @Param() { id }: UUIDParamDto): Promise { return this.service.delete(auth, id); } @Post(':id/lock') @Authenticated({ permission: Permission.SessionLock }) @HttpCode(HttpStatus.NO_CONTENT) @Endpoint({ summary: 'Lock a session', description: 'Lock a specific session by id.', history: new HistoryBuilder().added('v1').beta('v1').stable('v2'), }) lockSession(@Auth() auth: AuthDto, @Param() { id }: UUIDParamDto): Promise { return this.service.lock(auth, id); } }