Add API operation descriptions to user device permission controller

This commit is contained in:
faris Aljohari
2024-11-23 22:51:30 -06:00
parent e47cb82e33
commit 977cc6fb07

View File

@ -9,17 +9,18 @@ import {
Put,
UseGuards,
} from '@nestjs/common';
import { ApiBearerAuth, ApiTags } from '@nestjs/swagger';
import { ApiBearerAuth, ApiTags, ApiOperation } from '@nestjs/swagger';
import { UserDevicePermissionService } from '../services/user-device-permission.service';
import { UserDevicePermissionAddDto } from '../dtos/user-device-permission.add.dto';
import { UserDevicePermissionEditDto } from '../dtos/user-device-permission.edit.dto';
import { AdminRoleGuard } from 'src/guards/admin.role.guard';
import { EnableDisableStatusEnum } from '@app/common/constants/days.enum';
import { ControllerRoute } from '@app/common/constants/controller-route';
@ApiTags('Device Permission Module')
@Controller({
version: EnableDisableStatusEnum.ENABLED,
path: 'device-permission',
path: ControllerRoute.DEVICE_PERMISSION.ROUTE,
})
export class UserDevicePermissionController {
constructor(
@ -29,6 +30,11 @@ export class UserDevicePermissionController {
@ApiBearerAuth()
@UseGuards(AdminRoleGuard)
@Post()
@ApiOperation({
summary: ControllerRoute.DEVICE_PERMISSION.ACTIONS.ADD_PERMISSION_SUMMARY,
description:
ControllerRoute.DEVICE_PERMISSION.ACTIONS.ADD_PERMISSION_DESCRIPTION,
})
async addDevicePermission(
@Body() userDevicePermissionDto: UserDevicePermissionAddDto,
) {
@ -45,6 +51,11 @@ export class UserDevicePermissionController {
@ApiBearerAuth()
@UseGuards(AdminRoleGuard)
@Put(':devicePermissionUuid')
@ApiOperation({
summary: ControllerRoute.DEVICE_PERMISSION.ACTIONS.EDIT_PERMISSION_SUMMARY,
description:
ControllerRoute.DEVICE_PERMISSION.ACTIONS.EDIT_PERMISSION_DESCRIPTION,
})
async editDevicePermission(
@Param('devicePermissionUuid') devicePermissionUuid: string,
@Body() userDevicePermissionEditDto: UserDevicePermissionEditDto,
@ -62,6 +73,11 @@ export class UserDevicePermissionController {
@ApiBearerAuth()
@UseGuards(AdminRoleGuard)
@Get(':deviceUuid')
@ApiOperation({
summary: ControllerRoute.DEVICE_PERMISSION.ACTIONS.FETCH_PERMISSION_SUMMARY,
description:
ControllerRoute.DEVICE_PERMISSION.ACTIONS.FETCH_PERMISSION_DESCRIPTION,
})
async fetchDevicePermission(@Param('deviceUuid') deviceUuid: string) {
const deviceDetails =
await this.userDevicePermissionService.fetchUserPermission(deviceUuid);
@ -71,9 +87,16 @@ export class UserDevicePermissionController {
data: deviceDetails,
};
}
@ApiBearerAuth()
@UseGuards(AdminRoleGuard)
@Delete(':devicePermissionUuid')
@ApiOperation({
summary:
ControllerRoute.DEVICE_PERMISSION.ACTIONS.DELETE_PERMISSION_SUMMARY,
description:
ControllerRoute.DEVICE_PERMISSION.ACTIONS.DELETE_PERMISSION_DESCRIPTION,
})
async deleteDevicePermission(
@Param('devicePermissionUuid') devicePermissionUuid: string,
) {