feat: add req body validation & swagger docs to shelter managers routes

Author: ocsoares

src/shelter-managers/dtos/CreateShelterManagerDTO.ts

@@ -0,0 +1,14 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsNotEmpty, IsString } from 'class-validator';
+
+export class CreateShelterManagerDTO {
+  @ApiProperty({ type: 'string', example: 'ID do Abrigo' })
+  @IsNotEmpty()
+  @IsString()
+  readonly shelterId = '';
+
+  @ApiProperty({ type: 'string', example: 'ID do Usuário' })
+  @IsNotEmpty()
+  @IsString()
+  readonly userId = '';
+}

src/shelter-managers/shelter-managers.controller.ts

@@ -9,13 +9,22 @@ import {
   Query,
   UseGuards,
 } from '@nestjs/common';
-import { ApiTags } from '@nestjs/swagger';
+import {
+  ApiBadRequestResponse,
+  ApiBearerAuth,
+  ApiInternalServerErrorResponse,
+  ApiOkResponse,
+  ApiTags,
+  ApiUnauthorizedResponse,
+} from '@nestjs/swagger';
 
 import { ShelterManagersService } from './shelter-managers.service';
 import { ServerResponse } from '../utils';
 import { AdminGuard } from '@/guards/admin.guard';
+import { CreateShelterManagerDTO } from './dtos/CreateShelterManagerDTO';
 
 @ApiTags('Admin de Abrigo')
+@ApiInternalServerErrorResponse()
 @Controller('shelter/managers')
 export class ShelterManagersController {
   private logger = new Logger(ShelterManagersController.name);
@@ -24,9 +33,13 @@ export class ShelterManagersController {
     private readonly shelterManagerServices: ShelterManagersService,
   ) {}
 
+  @ApiBearerAuth()
+  @ApiUnauthorizedResponse()
+  @ApiBadRequestResponse()
+  @ApiOkResponse()
   @Post('')
   @UseGuards(AdminGuard)
-  async store(@Body() body) {
+  async store(@Body() body: CreateShelterManagerDTO) {
     try {
       await this.shelterManagerServices.store(body);
       return new ServerResponse(200, 'Successfully added manager to shelter');
@@ -36,6 +49,7 @@ export class ShelterManagersController {
     }
   }
 
+  @ApiOkResponse()
   @Get(':shelterId')
   async index(
     @Param('shelterId') shelterId: string,

src/shelter-managers/shelter-managers.service.ts

@@ -1,14 +1,14 @@
-import { z } from 'zod';
 import { Injectable } from '@nestjs/common';
 
 import { PrismaService } from '../prisma/prisma.service';
 import { CreateShelterManagerSchema } from './types';
+import { CreateShelterManagerDTO } from './dtos/CreateShelterManagerDTO';
 
 @Injectable()
 export class ShelterManagersService {
   constructor(private readonly prismaService: PrismaService) {}
 
-  async store(body: z.infer<typeof CreateShelterManagerSchema>) {
+  async store(body: CreateShelterManagerDTO) {
     const { shelterId, userId } = CreateShelterManagerSchema.parse(body);
     await this.prismaService.shelterManagers.create({
       data: {