NestJS — Iniciación

Este curso está dirigido a desarrolladores con conocimientos básicos de TypeScript y Node.js que se aproximan por primera vez a NestJS y necesitan comprender su arquitectura antes de incorporarlo a proyectos reales. A lo largo de las 8 horas los participantes explorarán los bloques estructurales del framework —módulos, controladores y servicios—, configurarán un entorno de desarrollo funcional mediante el CLI oficial y construirán de forma guiada una pequeña API REST con inyección de dependencias, terminando con la capacidad de arrancar un proyecto NestJS propio, exponer endpoints HTTP básicos y diagnosticar los errores de inicio más frecuentes.

1. Describir la responsabilidad de cada bloque fundamental de NestJS —módulo, controlador y servicio— y el flujo que sigue una petición HTTP a través de ellos.
2. Identificar la estructura de carpetas y archivos generada por el CLI al crear un proyecto nuevo, reconociendo la función de cada archivo raíz.
3. Ejecutar la instalación del CLI, la creación de un proyecto desde cero y la generación de artefactos con nest generate, verificando que la aplicación arranca correctamente.
4. Aplicar los decoradores @Controller, @Get y @Post para exponer endpoints en un controlador, e integrar un servicio mediante inyección de dependencias para llamar a sus métodos desde un handler HTTP.
5. Identificar y asociar a su causa los mensajes de error más comunes del arranque de NestJS, aplicando un criterio de diagnóstico básico ante dependencias no registradas, decoradores ausentes o conflictos de puerto.

Bloque 1 — Arquitectura y conceptos clave de NestJS Se introduce el framework desde su propósito y diseño: qué problema resuelve NestJS en el ecosistema Node.js y cómo organiza el código en torno a tres bloques principales. Se analiza la responsabilidad diferenciada del módulo como unidad de organización, del controlador como punto de entrada de las peticiones HTTP y del servicio como capa de lógica de negocio reutilizable. El bloque culmina describiendo el flujo completo de una petición desde que entra al módulo raíz hasta que el servicio procesa la operación y devuelve la respuesta, lo que proporciona el mapa mental necesario para el resto del curso.

Bloque 2 — Entorno de desarrollo y estructura de proyecto Se trabaja la puesta en marcha del entorno: instalación global del CLI de NestJS, creación de un proyecto nuevo y análisis detallado de la estructura de carpetas y archivos generada automáticamente. Se revisan los archivos raíz —main.ts, app.module.ts, app.controller.ts y app.service.ts— señalando la función concreta de cada uno. Al finalizar el bloque el participante habrá verificado que la aplicación responde en http://localhost:3000 y comprenderá qué ocurre en cada capa antes de escribir una sola línea de código personalizado.

Bloque 3 — Controladores, decoradores e inyección de dependencias Se aborda la creación y registro de artefactos mediante nest generate y su integración en el módulo padre. A continuación se aplican los decoradores @Controller, @Get y @Post para definir rutas y exponer al menos dos endpoints. El bloque cierra con la inyección de dependencias: cómo declarar un servicio como proveedor, inyectarlo en el constructor del controlador y invocar sus métodos desde los handlers HTTP, consolidando así el ciclo completo de una petición gestionada con NestJS.

Bloque 4 — Diagnóstico y resolución de errores frecuentes Se revisan los mensajes de error más habituales durante el arranque: dependencia no registrada en el módulo, decorador ausente en la clase y puerto ya ocupado. Mediante ejercicios de diagnóstico los participantes asocian cada traza de error a su causa raíz y aplican la corrección correspondiente, desarrollando un criterio básico de depuración que reducirá el tiempo de resolución en proyectos reales.

• Node.js 18 LTS o superior instalado y accesible desde la terminal.
• npm 9+ o pnpm 8+ para la gestión de dependencias.
• CLI de NestJS instalable vía npm install -g @nestjs/cli (se instala durante el curso; conexión a internet requerida).
• Editor de código con soporte TypeScript; se recomienda Visual Studio Code con la extensión oficial de TypeScript.
• Puerto 3000 disponible en la máquina local para arrancar la aplicación de práctica.

• Programación orientada a objetos con TypeScript: clases, decoradores, tipos e interfaces.
• Fundamentos de Node.js: módulos CommonJS/ESM, gestión de paquetes con npm y ejecución de scripts.
• Conceptos básicos de HTTP: métodos GET y POST, códigos de estado y estructura de una petición/respuesta.
• Manejo básico de la línea de comandos (terminal) en cualquier sistema operativo.