skill-nestjs-api

/skill-nestjs-api

Padrões DARE para APIs REST em NestJS + TypeScript + Prisma + Swagger. Modules, Controllers, Services, DTOs com class-validator, Guards JWT, throttler, exceções globais, Jest + Supertest, OpenAPI auto-gerado.

Como usar

/skill-nestjs-api                          # audita projeto NestJS
/skill-nestjs-api scaffold users           # gera CRUD com módulo + camadas
/skill-nestjs-api migrate-validation       # extrai @Body any para DTOs com class-validator

Stack canônica

• TypeScript 5.5+ com strict: true
• NestJS 11.x
• Prisma 5.x (PostgreSQL)
• class-validator + class-transformer
• @nestjs/swagger (OpenAPI auto)
• @nestjs/throttler (rate limit)
• @nestjs/passport + @nestjs/jwt
• Jest + Supertest

Estrutura por módulo

src/<feature>/
├── <feature>.module.ts
├── <feature>.controller.ts      ← Handler
├── <feature>.service.ts         ← Service
├── <feature>.repository.ts      ← Repository (Prisma)
├── dto/
├── entities/
└── tests/

Controllers

@ApiTags('users')
@Controller('users')
@UseGuards(JwtAuthGuard)
export class UsersController {
  constructor(private readonly register: RegisterUserService) {}

  @Post()
  @ApiOperation({ summary: 'Criar usuário' })
  @ApiCreatedResponse({ type: UserResponseDto })
  async create(@Body() dto: CreateUserDto): Promise<UserResponseDto> {
    const user = await this.register.execute(dto);
    return UserResponseDto.from(user);
  }
}

DTOs (class-validator)

export class CreateUserDto {
  @ApiProperty({ example: '[email protected]' })
  @IsEmail() email!: string;

  @ApiProperty({ minLength: 12 })
  @IsString() @MinLength(12) password!: string;
}

main.ts:

app.useGlobalPipes(new ValidationPipe({ whitelist: true, forbidNonWhitelisted: true, transform: true }));

Services

@Injectable()
export class RegisterUserService {
  constructor(private readonly repo: UsersRepository) {}

  async execute(dto: CreateUserDto): Promise<User> {
    if (await this.repo.existsByEmail(dto.email)) throw new UserAlreadyExistsError();
    return this.repo.create({ ...dto, password: await hash(dto.password) });
  }
}