Introducción y entorno

NestJS representa una evolución natural en el desarrollo de aplicaciones del lado del servidor con Node.js. Este framework combina la flexibilidad de JavaScript con la robustez de TypeScript, ofreciendo una arquitectura escalable inspirada en Angular que facilita la construcción de aplicaciones empresariales complejas.

¿Qué es NestJS?

NestJS es un framework progresivo para Node.js que utiliza TypeScript como lenguaje principal. Su diseño se basa en patrones arquitectónicos sólidos como la inyección de dependencias, los decoradores y la programación orientada a objetos, proporcionando una estructura clara y mantenible para proyectos de cualquier escala.

La filosofía de Nest se centra en crear aplicaciones altamente testeable, escalables y débilmente acopladas. Esto se logra mediante una arquitectura modular que separa claramente las responsabilidades y facilita tanto el desarrollo como el mantenimiento del código.

Arquitectura modular

El sistema de módulos constituye el núcleo organizativo de NestJS. Cada módulo encapsula un conjunto relacionado de funcionalidades, incluyendo controladores, servicios y otros componentes necesarios. Esta aproximación modular permite:

• Reutilización de código entre diferentes partes de la aplicación
• Separación clara de responsabilidades según el dominio del negocio
• Facilidad para realizar pruebas unitarias e integración
• Escalabilidad horizontal mediante la composición de módulos

Los módulos se definen utilizando el decorador @Module(), que especifica los componentes que pertenecen a cada módulo y cómo se relacionan entre sí.

Decoradores y metadatos

Los decoradores son una característica fundamental que NestJS hereda de TypeScript. Estos proporcionan una forma elegante de añadir metadatos a clases, métodos y propiedades, permitiendo que el framework comprenda cómo debe comportarse cada componente.

@Controller('users')
export class UsersController {
  @Get()
  findAll(): string {
    return 'Esta acción devuelve todos los usuarios';
  }
}

En este ejemplo, @Controller() indica que la clase maneja peticiones HTTP, mientras que @Get() especifica que el método responde a peticiones GET.

Inyección de dependencias

El sistema de inyección de dependencias de NestJS gestiona automáticamente la creación y distribución de instancias de servicios. Este patrón reduce el acoplamiento entre componentes y facilita las pruebas unitarias al permitir la sustitución fácil de dependencias.

@Injectable()
export class UsersService {
  private readonly users = [];

  findAll(): any[] {
    return this.users;
  }
}

@Controller('users')
export class UsersController {
  constructor(private readonly usersService: UsersService) {}

  @Get()
  findAll(): any[] {
    return this.usersService.findAll();
  }
}

El decorador @Injectable() marca una clase como un proveedor que puede ser inyectado en otros componentes, mientras que el constructor del controlador recibe automáticamente la instancia del servicio.

Configuración del entorno de desarrollo

Para comenzar con NestJS, es necesario tener Node.js instalado en el sistema. El framework requiere una versión moderna de Node.js que soporte las características de ES6+ y TypeScript.

La CLI de NestJS proporciona herramientas esenciales para la creación y gestión de proyectos:

npm i -g @nestjs/cli
nest new mi-proyecto

Este comando genera una estructura de proyecto completa con:

• Configuración de TypeScript optimizada para NestJS
• Scripts de desarrollo y producción preconfigurados
• Estructura de carpetas siguiendo las mejores prácticas
• Archivos de pruebas básicos para comenzar con testing

Estructura del proyecto

Un proyecto NestJS típico organiza el código en una jerarquía clara que facilita la navegación y el mantenimiento:

src/
├── app.controller.ts
├── app.module.ts
├── app.service.ts
└── main.ts

• main.ts: Punto de entrada de la aplicación donde se configura y arranca el servidor
• app.module.ts: Módulo raíz que organiza toda la aplicación
• app.controller.ts: Controlador principal que maneja las rutas básicas
• app.service.ts: Servicio que contiene la lógica de negocio

Integración con el ecosistema Node.js

NestJS se integra perfectamente con el ecosistema existente de Node.js. Puede utilizar cualquier librería de npm y es compatible con frameworks HTTP populares como Express y Fastify. Esta flexibilidad permite aprovechar herramientas y librerías existentes mientras se beneficia de la estructura arquitectónica que proporciona Nest.

El framework también incluye soporte nativo para WebSockets, microservicios, GraphQL y bases de datos, proporcionando un conjunto completo de herramientas para el desarrollo de aplicaciones modernas.

La configuración por defecto incluye características como recarga automática durante el desarrollo, compilación incremental de TypeScript y integración con herramientas de debugging, creando un entorno de desarrollo productivo desde el primer momento.