feat: add req body validation & swagger docs to shelters routes

Author: ocsoares

src/shelter/dtos/FullUpdateShelterDTO.ts

@@ -0,0 +1,70 @@
+import { ApiProperty } from '@nestjs/swagger';
+import {
+  IsOptional,
+  IsString,
+  IsBoolean,
+  IsNumber,
+  Min,
+} from 'class-validator';
+
+export class FullUpdateShelterDTO {
+  @ApiProperty({ required: false, type: 'string', example: 'Nome do Abrigo' })
+  @IsOptional()
+  @IsString()
+  readonly name?: string;
+
+  @ApiProperty({ required: false, type: 'string', example: 'PIX do Abrigo' })
+  @IsOptional()
+  @IsString()
+  readonly pix?: string;
+
+  @ApiProperty({
+    required: false,
+    type: 'string',
+    example: 'Endereço do Abrigo',
+  })
+  @IsOptional()
+  @IsString()
+  readonly address?: string;
+
+  @ApiProperty({ required: false, type: 'boolean', example: true })
+  @IsOptional()
+  @IsBoolean()
+  readonly petFriendly?: boolean;
+
+  @ApiProperty({ required: false, type: 'number', example: 10 })
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  readonly shelteredPeople?: number;
+
+  @ApiProperty({ required: false, type: 'number', example: 123.456 })
+  @IsOptional()
+  @IsNumber()
+  readonly latitude?: number;
+
+  @ApiProperty({ required: false, type: 'number', example: 654.321 })
+  @IsOptional()
+  @IsNumber()
+  readonly longitude?: number;
+
+  @ApiProperty({ required: false, type: 'number', example: 50 })
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  readonly capacity?: number;
+
+  @ApiProperty({
+    required: false,
+    type: 'string',
+    example: 'Contato do Abrigo',
+  })
+  @IsOptional()
+  @IsString()
+  readonly contact?: string;
+
+  @ApiProperty({ required: false, type: 'boolean' })
+  @IsOptional()
+  @IsBoolean()
+  readonly verified?: boolean;
+}

src/shelter/shelter.controller.ts

@@ -27,6 +27,7 @@ import { UserDecorator } from '@/decorators/UserDecorator/user.decorator';
 import { ShelterQueryDTO } from './dtos/ShelterQuerysDTO';
 import { CreateShelterDTO } from './dtos/CreateShelterDTO';
 import { UpdateShelterDTO } from './dtos/UpdateShelterDTO';
+import { FullUpdateShelterDTO } from './dtos/FullUpdateShelterDTO';
 
 @ApiTags('Abrigos')
 @ApiInternalServerErrorResponse()
@@ -113,7 +114,10 @@ export class ShelterController {
   @ApiOkResponse()
   @Put(':id/admin')
   @UseGuards(StaffGuard)
-  async fullUpdate(@Param('id') id: string, @Body() body: UpdateShelterDTO) {
+  async fullUpdate(
+    @Param('id') id: string,
+    @Body() body: FullUpdateShelterDTO,
+  ) {
     try {
       const data = await this.shelterService.fullUpdate(id, body);
       return new ServerResponse(200, 'Successfully updated shelter', data);

src/shelter/shelter.service.ts

@@ -2,7 +2,6 @@ import { Injectable } from '@nestjs/common';
 import { Prisma } from '@prisma/client';
 import { DefaultArgs } from '@prisma/client/runtime/library';
 import * as qs from 'qs';
-import { z } from 'zod';
 
 import { PrismaService } from '../prisma/prisma.service';
 import {
@@ -18,6 +17,7 @@ import { CreateShelterDTO } from './dtos/CreateShelterDTO';
 import { ShelterQueryDTO } from './dtos/ShelterQuerysDTO';
 import { UpdateShelterDTO } from './dtos/UpdateShelterDTO';
 import { ShelterSearchPropsSchema } from './types/search.types';
+import { FullUpdateShelterDTO } from './dtos/FullUpdateShelterDTO';
 
 @Injectable()
 export class ShelterService {
@@ -52,7 +52,7 @@ export class ShelterService {
     });
   }
 
-  async fullUpdate(id: string, body: z.infer<typeof FullUpdateShelterSchema>) {
+  async fullUpdate(id: string, body: FullUpdateShelterDTO) {
     const payload = FullUpdateShelterSchema.parse(body);
     await this.prismaService.shelter.update({
       where: {