WIP Projects DTO

Author: RICHARD-Quentin

service/src/core/projects/_dto/project.dto.ts

@@ -1,7 +1,37 @@
-import { PartialType } from "@nestjs/swagger"
+import { IsString, IsOptional, IsDate, IsObject, IsMongoId } from 'class-validator'
+import { ApiProperty } from '@nestjs/swagger'
+import { AbstractCustomFieldsDto } from '~/_common/abstracts/dto/abstract.custom-fields.dto'
 
-export class ProjectCreateDto {
+export class ProjectCreateDto extends AbstractCustomFieldsDto {
+  @IsString()
+  @ApiProperty()
+  public name: string
 
+  @IsDate()
+  @IsOptional()
+  @ApiProperty()
+  public startDate?: Date
+
+  @IsDate()
+  @IsOptional()
+  @ApiProperty()
+  public endDate?: Date
+
+  @IsObject()
+  @IsOptional()
+  @ApiProperty()
+  public rules?: { [key: string]: any }
+
+  @IsString()
+  @IsOptional()
+  @ApiProperty()
+  public description?: string
+}
+
+export class ProjectDto extends ProjectCreateDto {
+  @IsMongoId()
+  @ApiProperty()
+  public _id: string
 }
 
-export class ProjectUpdateDto extends PartialType(ProjectCreateDto) {}
+export class ProjectUpdateDto extends ProjectCreateDto {}

service/src/core/projects/project.controller.ts

@@ -1,16 +1,23 @@
-import { Body, Controller, Delete, Get, HttpStatus, Param, Patch, Post, Req, Res } from '@nestjs/common'
-import { ProjectCreateDto, ProjectUpdateDto } from './_dto/project.dto'
+import { Body, Controller, Delete, Get, HttpStatus, Param, Patch, Post, Res } from '@nestjs/common'
+import { ProjectCreateDto, ProjectDto, ProjectUpdateDto } from './_dto/project.dto'
 import { ProjectService } from './project.service'
 import { AbstractController } from '~/_common/abstracts/abstract.controller'
 import { ApiParam, ApiTags } from '@nestjs/swagger'
 import { SearchFilterSchema, FilterSchema, SearchFilterOptions, FilterOptions, ObjectIdValidationPipe } from '@streamkits/nestjs_module_scrud'
 import { Types } from 'mongoose'
-import { Request, Response } from 'express'
+import { Response } from 'express'
+import { ApiCreateDecorator } from '~/_common/decorators/api-create.decorator'
+import { ApiDeletedResponseDecorator } from '~/_common/decorators/api-deleted-response.decorator'
+import { ApiPaginatedDecorator } from '~/_common/decorators/api-paginated.decorator'
+import { ApiReadResponseDecorator } from '~/_common/decorators/api-read-response.decorator'
+import { ApiUpdateDecorator } from '~/_common/decorators/api-update.decorator'
+import { PickProjectionHelper } from '~/_common/helpers/pick-projection.helper'
+import { PartialProjectionType } from '~/_common/types/partial-projection.type'
 
 @ApiTags('core')
 @Controller('project')
 export class ProjectController extends AbstractController {
-  protected readonly projection = {
+  protected static readonly projection: PartialProjectionType<ProjectDto> = {
     name: 1,
     startDate: 1,
     endDate: 1,
@@ -22,7 +29,8 @@ export class ProjectController extends AbstractController {
   }
 
   @Post()
-  public async create(@Req() req: Request, @Res() res: Response, @Body() body: ProjectCreateDto) {
+  @ApiCreateDecorator(ProjectCreateDto, ProjectDto)
+  public async create(@Res() res: Response, @Body() body: ProjectCreateDto): Promise<Response> {
     const data = await this._service.create(body)
     return res.status(HttpStatus.CREATED).json({
       statusCode: HttpStatus.CREATED,
@@ -31,8 +39,9 @@ export class ProjectController extends AbstractController {
   }
 
   @Get()
-  public async search(@Res() res: Response, @SearchFilterSchema() searchFilterSchema: FilterSchema, @SearchFilterOptions() searchFilterOptions: FilterOptions) {
-    const [data, total] = await this._service.findAndCount(searchFilterSchema, this.projection, searchFilterOptions)
+  @ApiPaginatedDecorator(PickProjectionHelper(ProjectDto, ProjectController.projection))
+  public async search(@Res() res: Response, @SearchFilterSchema() searchFilterSchema: FilterSchema, @SearchFilterOptions() searchFilterOptions: FilterOptions): Promise<Response> {
+    const [data, total] = await this._service.findAndCount(searchFilterSchema, ProjectController.projection, searchFilterOptions)
     return res.status(HttpStatus.OK).json({
       statusCode: HttpStatus.OK,
       total,
@@ -42,7 +51,8 @@ export class ProjectController extends AbstractController {
 
   @Get(':_id([0-9a-fA-F]{24})')
   @ApiParam({ name: '_id', type: String })
-  public async read(@Param('_id', ObjectIdValidationPipe) _id: Types.ObjectId, @Res() res: Response) {
+  @ApiReadResponseDecorator(ProjectDto)
+  public async read(@Param('_id', ObjectIdValidationPipe) _id: Types.ObjectId, @Res() res: Response): Promise<Response> {
     const data = await this._service.findById(_id)
     return res.status(HttpStatus.OK).json({
       statusCode: HttpStatus.OK,
@@ -52,7 +62,8 @@ export class ProjectController extends AbstractController {
 
   @Patch(':_id([0-9a-fA-F]{24})')
   @ApiParam({ name: '_id', type: String })
-  public async update(@Param('_id', ObjectIdValidationPipe) _id: Types.ObjectId, @Body() body: ProjectUpdateDto, @Res() res: Response) {
+  @ApiUpdateDecorator(ProjectUpdateDto, ProjectDto)
+  public async update(@Param('_id', ObjectIdValidationPipe) _id: Types.ObjectId, @Body() body: ProjectUpdateDto, @Res() res: Response): Promise<Response> {
     const data = await this._service.update(_id, body)
     return res.status(HttpStatus.OK).json({
       statusCode: HttpStatus.OK,
@@ -62,7 +73,8 @@ export class ProjectController extends AbstractController {
 
   @Delete(':_id([0-9a-fA-F]{24})')
   @ApiParam({ name: '_id', type: String })
-  public async remove(@Param('_id', ObjectIdValidationPipe) _id: Types.ObjectId, @Res() res: Response) {
+  @ApiDeletedResponseDecorator(ProjectDto)
+  public async remove(@Param('_id', ObjectIdValidationPipe) _id: Types.ObjectId, @Res() res: Response): Promise<Response> {
     const data = await this._service.delete(_id)
     return res.status(HttpStatus.OK).json({
       statusCode: HttpStatus.OK,