skill-nestjs-api

Skill: NestJS API DARE

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

Stack canônica

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

---

Estrutura de módulo (Layered Design)

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

---

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);
  }
}

Regras:

• Apenas: recebe → valida via DTO → chama Service → retorna ResponseDto
• NUNCA: Prisma direto, lógica de negócio, validação inline