NestJS 프레임워크

// src/app.module.ts
import { Module } from '@nestjs/common';
import { AppController } from './app.controller';
import { AppService } from './app.service';

@Module({
  imports: [],       // 이 모듈에서 사용할 다른 모듈들을 임포트합니다.
  controllers: [AppController], // 이 모듈에 속한 컨트롤러들을 정의합니다.
  providers: [AppService],   // 이 모듈에 속한 프로바이더(서비스, 리포지토리 등)들을 정의합니다.
})
export class AppModule {}

// src/app.controller.ts
import { Controller, Get, Post, Body, Param } from '@nestjs/common';
import { AppService } from './app.service';

// DTO (Data Transfer Object) 정의: 요청 본문의 타입을 명시합니다.
interface CreateUserDto {
  name: string;
  email: string;
}

@Controller('users') // '/users' 경로에 대한 요청을 처리합니다.
export class AppController {
  constructor(private readonly appService: AppService) {} // 의존성 주입 (AppService)

  @Get() // GET /users
  getHello(): string {
    return this.appService.getHello();
  }

  @Get(':id') // GET /users/:id
  // @Param() 데코레이터는 URL 파라미터를 가져오고, 타입스크립트가 타입을 추론합니다.
  getUserById(@Param('id') id: string): string {
    return `User ID: ${id}`;
  }

  @Post() // POST /users
  // @Body() 데코레이터는 요청 본문을 가져오고, CreateUserDto 타입을 명시하여 타입 안정성을 확보합니다.
  createUser(@Body() createUserDto: CreateUserDto): string {
    console.log('Received new user:', createUserDto);
    return `User ${createUserDto.name} (${createUserDto.email}) created!`;
  }
}

// src/app.service.ts
import { Injectable } from '@nestjs/common';

@Injectable() // 이 클래스가 NestJS의 의존성 주입 시스템에 의해 관리될 수 있음을 나타냅니다.
export class AppService {
  getHello(): string {
    return 'Hello World from AppService!';
  }

  // 예시: 사용자 데이터 처리 로직 (실제로는 데이터베이스 연동)
  createUser(name: string, email: string): { id: number; name: string; email: string } {
    const newUser = { id: Math.floor(Math.random() * 1000), name, email };
    console.log('User created in service:', newUser);
    return newUser;
  }
}

// src/pipes/parse-int.pipe.ts
import { PipeTransform, Injectable, ArgumentMetadata, BadRequestException } from '@nestjs/common';

@Injectable()
export class ParseIntPipe implements PipeTransform<string, number> {
  transform(value: string, metadata: ArgumentMetadata): number {
    const val = parseInt(value, 10);
    if (isNaN(val)) {
      throw new BadRequestException('Validation failed: Parameter is not an integer.');
    }
    return val;
  }
}

// src/app.controller.ts (사용 예시)
import { Controller, Get, Param, ParseIntPipe } from '@nestjs/common';
// ...

@Controller('users')
export class AppController {
  // ...
  @Get(':id')
  // @Param('id', ParseIntPipe)를 사용하여 id 파라미터가 숫자로 변환되고 유효성 검사됩니다.
  getUserById(@Param('id', ParseIntPipe) id: number): string {
    // 이제 id는 number 타입임을 보장할 수 있습니다.
    return `User ID: ${id}`;
  }
}

// src/guards/auth.guard.ts
import { CanActivate, ExecutionContext, Injectable } from '@nestjs/common';
import { Observable } from 'rxjs';

@Injectable()
export class AuthGuard implements CanActivate {
  canActivate(
    context: ExecutionContext,
  ): boolean | Promise<boolean> | Observable<boolean> {
    const request = context.switchToHttp().getRequest();
    // 실제로는 JWT 토큰 검증, 세션 확인 등의 로직이 들어갑니다.
    const hasAuthHeader = request.headers.authorization ? true : false;
    console.log('AuthGuard is running. Has Auth Header:', hasAuthHeader);
    return hasAuthHeader; // 인증 성공 시 true, 실패 시 false 반환
  }
}

// src/app.controller.ts (사용 예시)
import { Controller, Get, UseGuards } from '@nestjs/common';
import { AuthGuard } from './guards/auth.guard';
// ...

@Controller('admin')
@UseGuards(AuthGuard) // 이 컨트롤러의 모든 라우트에 AuthGuard 적용
export class AdminController {
  @Get('dashboard') // GET /admin/dashboard
  getDashboard(): string {
    return 'Welcome to the Admin Dashboard!';
  }
}