Clean up your NestJS Controller: Remote API Validation inside DTOs 🧼🚀

Matheus — Sat, 06 Dec 2025 19:31:06 +0000

The "Remote Validation" Struggle

Hey everyone! 👋

If you work with NestJS, you probably love class-validator. Putting an @IsEmail() decorator on a property and sleeping soundly knowing bad data won't reach your Service is a great feeling.

But that peace of mind usually vanishes when we need Remote Validation.

You know the scenario:

The frontend sends a userId, couponCode, or transactionId.
You need to hit an external Microservice or API to check if it's valid.
If it's valid, you often need to fetch extra data (like the user's name) to save it locally.

The "Dirty" Way (We've all done this):

// ❌ The common anti-pattern
@Post()
async create(@Body() dto: CreateOrderDto) {
  // Validation logic leaking into the Controller/Service
  const response = await this.http.get(`https://external-api.com/users/${dto.userId}`);

  if (response.status !== 200) {
    throw new BadRequestException('Invalid User ID');
  }

  // Business logic finally starts here...
}

This breaks the NestJS patterns. Your Controller should handle requests, and your Service should handle business logic. Validation should stay at the gate: in the DTO.

The Solution: `nestjs-remote-validate`

I got tired of writing this boilerplate code, so I built a library to solve exactly this: HTTP validation inside DTO decorators.

It's called nestjs-remote-validate.

It turns that manual validation into this:

// ✅ The clean way
export class CreateOrderDto {
  @ValidateApi({
    host: 'https://external-api.com/users/:userId', // Dynamic injection!
    method: 'GET',
    validate: ({ status }) => status === 200
  })
  userId: string;
}

The Killer Feature: DTO Enrichment 🐱

This is my favorite part. Often, you don't just want to validate; you want to use the data returned by the API.

The library allows you to extract data from the response and automatically inject it into another field of your DTO.

Check this out:

export class CreateTransactionDto {
  // 1. Validates if the ID exists remotely
  @ValidateApi({
    host: 'https://bank-api.com/accounts/:accountId',
    method: 'GET',
    validate: ({ status }) => status === 200,
    // 2. Extracts the owner name from the response body
    extractValue: (body) => body.ownerName, 
    // 3. Injects it into the field below
    targetField: 'accountOwnerName' 
  })
  accountId: string;

  // This field gets populated "magically" after validation!
  @Allow()
  accountOwnerName: string;
}

By the time the DTO reaches your Controller, accountOwnerName is already filled. Zero HTTP calls in your Service code. 🤯

Quick Start

It's lightweight and easy to setup.

1. Install

npm install nestjs-remote-validate

2. Setup (Important!)

Since the validator needs to perform async operations and injection, we need to register the provider and tell class-validator to use the NestJS container.

app.module.ts

import { ApiValidatorConstraint } from 'nestjs-remote-validate';

@Module({
  providers: [ApiValidatorConstraint], // Register the provider
})
export class AppModule {}

main.ts

import { useContainer } from 'class-validator';

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

  // Allow dependency injection inside validators
  useContainer(app.select(AppModule), { fallbackOnErrors: true });

  app.useGlobalPipes(new ValidationPipe({ whitelist: true, transform: true }));
  await app.listen(3000);
}
bootstrap();

🚧 Current Limitations & Roadmap (Let's build this!)

This project was born from a specific need, and while it works great for many cases, there is plenty of room to grow. I want to be transparent about where we are and where we can go:

Http Client: Currently, it uses native fetch under the hood. In the future, I'd love to support Axios injection so you can reuse your global interceptors (for logging, auth, etc.).
Caching: Right now, every validation triggers a request. Implementing a Caching Strategy (Memory/Redis) would be a huge performance boost for repeated validations.
Batching: Validating arrays of IDs in a single call.

This is where you come in! Since this is Open Source, these are great opportunities for "Good First Issues" or robust PRs.

Contribute! 🤝

If you think this library solves a pain point for you, give it a try!

If you have ideas on how to implement the Axios support or Caching, drop by the repository. Every Star, Issue, or PR helps the ecosystem grow.

🔗 GitHub: gsmatheus/nestjs-remote-validate
📦 NPM: npmjs.com/package/nestjs-remote-validate

Happy coding! 🚀

Easypanel: Um Painel Moderno para Gerenciamento de Servidores

Matheus — Fri, 22 Nov 2024 12:25:22 +0000

Gerencie seus Servidores de Forma Simples com Easypanel

Gerenciar servidores pode ser uma tarefa desafiadora, especialmente para equipes de desenvolvimento que buscam eficiência em deploys, configuração de aplicações e manutenção de serviços. Para simplificar esse processo, o Easypanel se apresenta como uma solução moderna e prática.

O que é o Easypanel?

O Easypanel é um painel de controle baseado em Docker, projetado para facilitar o gerenciamento de servidores e aplicações. Ele suporta várias linguagens de programação, como Node.js, Python, PHP, Ruby, Go e Java, além de permitir o uso de Dockerfiles personalizados. Sua interface intuitiva elimina a complexidade das tarefas administrativas, aumentando a produtividade.

Principais Recursos do Easypanel

Deploy Simplificado: Conecte suas aplicações ao GitHub para deploys diretos e rápidos.
Certificados SSL Automatizados: Certificados SSL gratuitos, configurados e renovados automaticamente.
Suporte a Bancos de Dados Populares: MySQL, PostgreSQL, MongoDB e Redis são facilmente configurados e gerenciados.
Deploy Zero-Downtime: Deploys garantidos sem interrupção dos serviços.
Terminal Integrado: Execute comandos e analise logs diretamente no navegador.
Templates Pré-construídos: Modelos prontos para aplicações populares como WordPress e Laravel, permitindo instalação com um clique.
Monitoramento de Performance: Gráficos de uso de CPU, memória e rede para facilitar a análise do servidor.

Por que Usar o Easypanel?

Equipes Pequenas ou Startups: Ideal para desenvolvedores com pouca experiência em DevOps ou equipes com orçamento limitado.
Fluxo CI/CD Facilitado: Integração direta com GitHub elimina a necessidade de pipelines complexos.
Ambientes de Desenvolvimento e Produção: Flexível para testar localmente ou gerenciar aplicações em produção.
Redução de Custos: Uma alternativa acessível a plataformas como Heroku ou AWS Elastic Beanstalk.
Gerenciamento de Banco de Dados Simplificado: Backups automáticos e interface amigável para manipulação dos dados.

Benefícios do Easypanel

Economia de Tempo: Minimiza tarefas manuais e repetitivas.
Interface Intuitiva: Facilita o uso até mesmo por quem não tem experiência avançada.
Flexibilidade: Compatível com qualquer servidor Linux que tenha Docker instalado.
Compatibilidade com Nuvem: Funciona com provedores como DigitalOcean, AWS, Vultr, Linode e outros.

Modelos Pré-construídos: Instalação com um Clique

Um dos maiores destaques do Easypanel é o suporte a templates pré-construídos, que permitem a instalação de aplicações populares com apenas um clique. Seja para criar um site com WordPress, um projeto em Laravel ou outras ferramentas populares, o Easypanel oferece rapidez e praticidade, economizando tempo e esforço.

Teste o Easypanel Agora Mesmo

Confira os links para começar sua jornada com o Easypanel:

🌐 Site Oficial do Easypanel
🎮 Demonstração Online

O Easypanel é uma solução poderosa para simplificar o gerenciamento de servidores. Se você busca otimizar sua produtividade e reduzir custos, vale a pena experimentar!

DEV Community: Matheus