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 { CreateLibraryDto, LibraryResponseDto, LibraryStatsResponseDto, UpdateLibraryDto, ValidateLibraryDto, ValidateLibraryResponseDto, } from 'src/dtos/library.dto'; import { ApiTag, Permission } from 'src/enum'; import { Authenticated } from 'src/middleware/auth.guard'; import { LibraryService } from 'src/services/library.service'; import { UUIDParamDto } from 'src/validation'; @ApiTags(ApiTag.Libraries) @Controller('libraries') export class LibraryController { constructor(private service: LibraryService) {} @Get() @Authenticated({ permission: Permission.LibraryRead, admin: true }) @Endpoint({ summary: 'Retrieve libraries', description: 'Retrieve a list of external libraries.', history: new HistoryBuilder().added('v1').beta('v1').stable('v2'), }) getAllLibraries(): Promise { return this.service.getAll(); } @Post() @Authenticated({ permission: Permission.LibraryCreate, admin: true }) @Endpoint({ summary: 'Create a library', description: 'Create a new external library.', history: new HistoryBuilder().added('v1').beta('v1').stable('v2'), }) createLibrary(@Body() dto: CreateLibraryDto): Promise { return this.service.create(dto); } @Get(':id') @Authenticated({ permission: Permission.LibraryRead, admin: true }) @Endpoint({ summary: 'Retrieve a library', description: 'Retrieve an external library by its ID.', history: new HistoryBuilder().added('v1').beta('v1').stable('v2'), }) getLibrary(@Param() { id }: UUIDParamDto): Promise { return this.service.get(id); } @Put(':id') @Authenticated({ permission: Permission.LibraryUpdate, admin: true }) @Endpoint({ summary: 'Update a library', description: 'Update an existing external library.', history: new HistoryBuilder().added('v1').beta('v1').stable('v2'), }) updateLibrary(@Param() { id }: UUIDParamDto, @Body() dto: UpdateLibraryDto): Promise { return this.service.update(id, dto); } @Delete(':id') @Authenticated({ permission: Permission.LibraryDelete, admin: true }) @HttpCode(HttpStatus.NO_CONTENT) @Endpoint({ summary: 'Delete a library', description: 'Delete an external library by its ID.', history: new HistoryBuilder().added('v1').beta('v1').stable('v2'), }) deleteLibrary(@Param() { id }: UUIDParamDto): Promise { return this.service.delete(id); } @Post(':id/validate') @Authenticated({ admin: true }) @HttpCode(HttpStatus.OK) @Endpoint({ summary: 'Validate library settings', description: 'Validate the settings of an external library.', history: new HistoryBuilder().added('v1').beta('v1').stable('v2'), }) // TODO: change endpoint to validate current settings instead validate(@Param() { id }: UUIDParamDto, @Body() dto: ValidateLibraryDto): Promise { return this.service.validate(id, dto); } @Get(':id/statistics') @Authenticated({ permission: Permission.LibraryStatistics, admin: true }) @Endpoint({ summary: 'Retrieve library statistics', description: 'Retrieve statistics for a specific external library, including number of videos, images, and storage usage.', history: new HistoryBuilder().added('v1').beta('v1').stable('v2'), }) getLibraryStatistics(@Param() { id }: UUIDParamDto): Promise { return this.service.getStatistics(id); } @Post(':id/scan') @Authenticated({ permission: Permission.LibraryUpdate, admin: true }) @HttpCode(HttpStatus.NO_CONTENT) @Endpoint({ summary: 'Scan a library', description: 'Queue a scan for the external library to find and import new assets.', history: new HistoryBuilder().added('v1').beta('v1').stable('v2'), }) scanLibrary(@Param() { id }: UUIDParamDto): Promise { return this.service.queueScan(id); } }