109 lines
3.6 KiB
TypeScript
109 lines
3.6 KiB
TypeScript
import { Body, Controller, Delete, Get, HttpCode, HttpStatus, Param, Patch, Post, Put } from '@nestjs/common';
|
|
import { ApiExcludeEndpoint, ApiTags } from '@nestjs/swagger';
|
|
import type { AuthDto } from 'src/dtos/auth.dto.js';
|
|
import { Endpoint, HistoryBuilder } from 'src/decorators.js';
|
|
import {
|
|
SessionCreateDto,
|
|
SessionCreateResponseDto,
|
|
SessionResponseDto,
|
|
SessionUpdateDto,
|
|
} from 'src/dtos/session.dto.js';
|
|
import { ApiTag, Permission } from 'src/enum.js';
|
|
import { Auth, Authenticated } from 'src/middleware/auth.guard.js';
|
|
import { SessionService } from 'src/services/session.service.js';
|
|
import { UUIDParamDto } from 'src/validation.js';
|
|
|
|
@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<SessionCreateResponseDto> {
|
|
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<SessionResponseDto[]> {
|
|
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<void> {
|
|
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')
|
|
.deprecated('v3', { replacementId: 'updateSession' }),
|
|
})
|
|
updateSession(
|
|
@Auth() auth: AuthDto,
|
|
@Param() { id }: UUIDParamDto,
|
|
@Body() dto: SessionUpdateDto,
|
|
): Promise<SessionResponseDto> {
|
|
return this.service.update(auth, id, dto);
|
|
}
|
|
|
|
@Patch(':id')
|
|
@ApiExcludeEndpoint()
|
|
@Authenticated({ permission: Permission.SessionUpdate })
|
|
updateSessionV3(
|
|
@Auth() auth: AuthDto,
|
|
@Param() { id }: UUIDParamDto,
|
|
@Body() dto: SessionUpdateDto,
|
|
): Promise<SessionResponseDto> {
|
|
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<void> {
|
|
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<void> {
|
|
return this.service.lock(auth, id);
|
|
}
|
|
}
|