DTO와 유효성 검사

// src/users/dto/create-user.dto.ts
export class CreateUserDto {
  name: string;
  email: string;
  age: number;
}

npm install class-validator class-transformer

// src/users/dto/create-user.dto.ts
import { IsString, IsEmail, IsNotEmpty, IsInt, Min, Max } from 'class-validator';

export class CreateUserDto {
  @IsString({ message: '이름은 문자열이어야 합니다.' })
  @IsNotEmpty({ message: '이름은 필수 항목입니다.' })
  name: string;

  @IsEmail({}, { message: '유효한 이메일 형식이 아닙니다.' })
  @IsNotEmpty({ message: '이메일은 필수 항목입니다.' })
  email: string;

  @IsInt({ message: '나이는 정수여야 합니다.' })
  @Min(0, { message: '나이는 0보다 커야 합니다.' })
  @Max(150, { message: '나이는 150보다 작거나 같아야 합니다.' })
  age: number; // 새로운 필드 추가
}

// src/users/dto/update-user.dto.ts
import { PartialType } from '@nestjs/mapped-types'; // npm install @nestjs/mapped-types
import { CreateUserDto } from './create-user.dto';

// PartialType은 CreateUserDto의 모든 필드를 선택적(optional)으로 만듭니다.
// 즉, name?: string; email?: string; age?: number; 와 동일합니다.
export class UpdateUserDto extends PartialType(CreateUserDto) {}

// src/main.ts
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import { ValidationPipe } from '@nestjs/common'; // ValidationPipe 임포트

async function bootstrap() {
  const app = await NestFactory.create(AppModule);

  // 전역 유효성 검사 파이프 설정
  app.useGlobalPipes(new ValidationPipe({
    whitelist: true, // DTO에 정의되지 않은 속성은 요청 본문에서 자동으로 제거합니다.
                     // 클라이언트가 불필요하거나 악의적인 속성을 보낼 때 유용합니다.
    forbidNonWhitelisted: true, // DTO에 정의되지 않은 속성이 존재하면 요청을 거부하고 400 Bad Request 에러를 발생시킵니다.
    transform: true, // 요청 본문을 해당 DTO 클래스의 인스턴스로 자동 변환합니다.
                     // (예: 문자열 '123'을 숫자 123으로, "true"를 boolean true로)
                     // 이 옵션이 있어야 class-transformer가 작동하고, @class-validator가 올바른 타입에서 유효성 검사를 수행합니다.
    disableErrorMessages: process.env.NODE_ENV === 'production', // 프로덕션 환경에서 상세 에러 메시지 비활성화 (보안)
  }));

  await app.listen(3000);
}
bootstrap();

// src/users/users.controller.ts (업데이트)
import { Controller, Get, Post, Body, Param, Patch, Delete, HttpCode, HttpStatus, NotFoundException, UsePipes } from '@nestjs/common';
import { UsersService } from './users.service';
import { CreateUserDto } from './dto/create-user.dto';
import { UpdateUserDto } from './dto/update-user.dto';
// import { ValidationPipe } from '@nestjs/common'; // 개별 파이프 적용 시 임포트

@Controller('users')
export class UsersController {
  constructor(private readonly usersService: UsersService) {}

  // ... (findAll, findOne 등 기존 메서드는 동일)

  @Post()
  @HttpCode(HttpStatus.CREATED)
  // @UsePipes(new ValidationPipe()) // 전역 파이프를 사용하므로 이 부분은 필요 없습니다.
  create(@Body() createUserDto: CreateUserDto) {
    // ValidationPipe가 자동으로 createUserDto의 유효성을 검사하고,
    // 유효하면 CreateUserDto 인스턴스로 변환하여 여기에 주입합니다.
    // 유효하지 않으면 400 Bad Request 응답을 자동으로 보냅니다.
    return this.usersService.create(createUserDto);
  }

  @Patch(':id')
  update(@Param('id') id: string, @Body() updateUserDto: UpdateUserDto) {
    const updatedUser = this.usersService.update(+id, updateUserDto);
    if (!updatedUser) {
      throw new NotFoundException(`User with ID ${id} not found`);
    }
    return updatedUser;
  }

  // ... (remove 등 기존 메서드는 동일)
}