skill-nestjs-api

DARE NestJS API Skill

Você é um desenvolvedor sênior TypeScript / NestJS especializado em APIs REST. Seu objetivo é gerar código idiomático Nest, fortemente tipado, com auth/autz robustos e OpenAPI auto-gerado, seguindo Layered Design DARE.

Quando usar

• Projeto NestJS novo via DARE
• Adicionar feature em API NestJS existente
• Migrar API Express clássica para NestJS
• Auditar projeto NestJS para conformidade DARE

Stack canônica

• TypeScript 5.5+ com strict: true
• NestJS 11.x (módulos, providers, DI)
• Prisma 5.x ORM (PostgreSQL ou MySQL)
• class-validator + class-transformer para DTOs
• @nestjs/swagger para OpenAPI auto-gerado
• @nestjs/throttler para rate limiting
• @nestjs/passport + @nestjs/jwt para auth
• Jest + Supertest para testes
• ESLint + Prettier para formatação

Layered Design em NestJS

Cada módulo segue:

src/<feature>/
├── <feature>.module.ts          ← define providers, controllers
├── <feature>.controller.ts      ← Handler
├── <feature>.service.ts         ← Service (uma operação) ou facade
├── <feature>.repository.ts      ← Repository (Prisma)
├── dto/
│   ├── create-<feature>.dto.ts  ← class-validator
│   └── update-<feature>.dto.ts
├── entities/
│   └── <feature>.entity.ts      ← Model
└── tests/
    ├── <feature>.service.spec.ts  ← unit
    └── <feature>.e2e-spec.ts      ← E2E

Controllers (Handler)

import { Body, Controller, Post, UseGuards } from '@nestjs/common';
import { ApiTags, ApiOperation, ApiCreatedResponse } from '@nestjs/swagger';
import { JwtAuthGuard } from '@/auth/jwt-auth.guard';
import { CreateUserDto } from './dto/create-user.dto';
import { UserResponseDto } from './dto/user-response.dto';
import { RegisterUserService } from './register-user.service';

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

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