1. Introducción a NestJS: Por qué TypeScript en el Backend, Arquitectura y Nest CLI
Comprende qué problema arquitectónico resuelve NestJS sobre Express/Fastify, cómo instalar @nestjs/cli y la estructura de un proyecto empresarial.
¿Qué es NestJS y qué problema resuelve en Node.js?
NestJS es un framework progresivo de Node.js para construir aplicaciones del lado del servidor eficientes, confiables y escalables utilizando TypeScript de forma nativa.
Mientras que librerías minimalistas como Express o Fastify ofrecen gran libertad inicial, carecen de una arquitectura definida: a medida que el equipo crece, cada desarrollador organiza las carpetas, validaciones y servicios a su manera, derivando en código espagueti difícil de mantener.
Instalación del Nest CLI y Creación del Proyecto
La herramienta oficial de línea de comandos (@nestjs/cli) permite inicializar proyectos con TypeScript configurado, ESLint, Prettier y Jest listos para usar, además de generar módulos, controladores y servicios siguiendo convenciones estrictas:
# 1. Instalar globalmente el CLI oficial de NestJS
npm i -g @nestjs/cli
# 2. Crear un nuevo proyecto empresarial con modo estricto
nest new kilopolis-api --strict
# 3. Iniciar el servidor en modo desarrollo con recarga en caliente (watch)
cd kilopolis-api
npm run start:dev
Archivo Base en src/ |
Responsabilidad Arquitectónica |
|---|---|
main.ts |
Punto de entrada de la aplicación. Utiliza NestFactory.create(AppModule) para arrancar el servidor HTTP. |
app.module.ts |
Módulo raíz (Root Module) donde se ensamblan los demás módulos de dominio de la plataforma. |
app.controller.ts |
Controlador básico encargado de recibir peticiones HTTP y delegarlas al servicio. |
app.service.ts |
Proveedor inyectable (@Injectable()) con la lógica de negocio aislada de la capa HTTP. |
⚡ Punto de Entrada de una Aplicación NestJS (src/main.ts)
Arranque asíncrono de la aplicación con NestFactory, prefijo global de API y puerto configurable:
import { NestFactory } from '@nestjs/core';
import { Logger } from '@nestjs/common';
import { AppModule } from './app.module';
async function bootstrap(): Promise<void> {
const logger = new Logger('Bootstrap');
// Crea la instancia de la aplicación NestJS (usa Express por defecto bajo el capó)
const app = await NestFactory.create(AppModule);
// Define el prefijo global para todos los endpoints REST (ej: /api/v1/...)
app.setGlobalPrefix('api/v1');
// Habilita CORS para permitir consumo desde frontends autorizados
app.enableCors({
origin: ['https://academia.kilopolis.com', 'http://kilopolis.local'],
credentials: true,
});
const port = process.env.PORT ? Number(process.env.PORT) : 3000;
await app.listen(port);
logger.log(`¡Hola Mundo! Servidor NestJS activo en http://localhost:${port}/api/v1`);
}
bootstrap();
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Qué clase estática del paquete @nestjs/core se utiliza en el archivo src/main.ts para inicializar y arrancar la aplicación a partir de AppModule?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar NestJS Framework Profesional y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.