NestJS Node.js (Cómo funciona para desarrolladores)

Soporte para TypeScript

TypeScript, un superconjunto estáticamente tipado de JavaScript que proporciona autocompletado sofisticado, seguridad de tipos y características modernas del lenguaje, se utiliza en la construcción de NestJS. Esto aumenta el mantenimiento del código y ayuda en la detección de errores durante la compilación. NestJS admite JavaScript y TypeScript de manera predeterminada, brindando a los desarrolladores más libertad.

Arquitectura modular

NestJS fomenta la organización del código basada en módulos. Es más fácil mantener, escalar y organizar el código cuando los componentes relacionados como controladores, proveedores y servicios se encapsulan en un solo módulo. Los módulos de la aplicación pueden utilizarse en otras áreas, fomentando la filosofía DRY (Don't Repeat Yourself).

Inyección de dependencia

Una de las características principales de NestJS que facilita la gestión de dependencias es un sistema sofisticado de inyección de dependencias. Mediante el uso de la inyección de dependencias en lugar de codificarlas, NestJS crea componentes libremente acoplados y testeables. Este estilo también permite un código más modular y una mejor separación de preocupaciones.

Decoradores

Los decoradores se utilizan ampliamente en NestJS para crear y configurar clases y sus miembros. El uso de decoradores como @Controller(), @Get(), @Post(), @Injectable(), y otros mejoran la legibilidad y expresividad del código haciendo evidente lo que hace cada componente de la aplicación y cómo se comporta.

Compatibilidad con Express y Fastify

Debido a su adaptabilidad, NestJS ofrece a los desarrolladores la opción de usar Fastify o Express como el servidor HTTP subyacente. Mientras que Fastify proporciona mejor rendimiento, Express es reconocido por ser fácil de usar y eficiente. Debido a esta versatilidad, los desarrolladores pueden adaptar sus aplicaciones para satisfacer requisitos únicos.

Middleware

NestJS admite funcionalidades de middleware similares a Express. Antes de que las solicitudes lleguen a los manejadores de rutas, el middleware puede manejarlas, proporcionando características como análisis de cuerpo, autenticación y registro. Esto facilita la implementación de lógica reutilizable para el manejo de solicitudes.

Manejo de excepciones

NestJS tiene un sistema sólido de manejo de excepciones que permite a los programadores crear filtros de excepciones únicos. Estos filtros pueden mejorar la gestión de errores y la uniformidad de respuestas en toda la aplicación al capturar y manejar excepciones de manera estandarizada.

Tubos y guardias

Tuberías: La transformación y validación de datos se logra utilizando tuberías. Pueden implementarse a nivel de controlador, a nivel de manejador de rutas o globalmente. Las tuberías de validación y transformación son internas, y también se pueden crear tuberías personalizadas.

Guardias: Los guardias implementan la lógica de autorización y autenticación. Utilizan reglas específicas, como verificar roles de usuario o permisos, para decidir si aprobar una solicitud.

Instalar NestJS CLI

Primero instala el CLI de NestJS globalmente, ya sea con Yarn o npm.

npm install -g @nestjs/cli

npm install -g @nestjs/cli

Crear un nuevo proyecto

Para iniciar un nuevo proyecto de NestJS, utiliza el CLI. Cambia "my-nest-app" por el nombre del proyecto que desees.

nest new my-nest-app

nest new my-nest-app

Estructura del proyecto

Este es un breve resumen de la estructura estándar del proyecto:

src/
├── app.controller.ts
├── app.controller.spec.ts
├── app.module.ts
├── app.service.ts
├── main.ts
test/
├── app.e2e-spec.ts
└── jest-e2e.json

• app.controller.ts: Contiene el controlador principal de la aplicación.
• app.service.ts: Contiene el servicio principal de la aplicación.
• app.module.ts: El módulo raíz de la aplicación.
• main.ts: El punto de entrada de la aplicación.

Módulo de configuración

Para gestionar configuraciones, instala el paquete @nestjs/config.

npm install @nestjs/config

npm install @nestjs/config

Agrega el módulo de configuración al archivo app.module.ts.

import { Module } from '@nestjs/common';
import { ConfigModule } from '@nestjs/config';
import { AppController } from './app.controller';
import { AppService } from './app.service';

@Module({
  imports: [
    ConfigModule.forRoot({
      isGlobal: true, // Make the module global
    }),
  ],
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}

Para acceder a las variables de entorno, utiliza el servicio de configuración.

import { Injectable } from '@nestjs/common';
import { ConfigService } from '@nestjs/config';

@Injectable()
export class AppService {
  constructor(private configService: ConfigService) {}

  getHello(): string {
    return `Hello World!`;
  }
}

Características de IronPDF

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

Crear un servicio PDF

Para gestionar la generación de PDFs, crea un nuevo servicio. Este servicio convertirá información HTML en PDFs usando IronPDF.

nest generate service pdf

nest generate service pdf

Aplica la lógica de generación de PDF en el archivo pdf.service.ts creado.

// src/pdf/pdf.service.ts
import { Injectable } from '@nestjs/common';
const IronPdf = require('@ironsoftware/ironpdf');
const document = IronPdf.PdfDocument;
var config = IronPdf.IronPdfGlobalConfig;
config.setConfig({ licenseKey: '' });

@Injectable()
export class PdfService {
  async generatePdf(htmlContent: string): Promise<Buffer> {
    const pdf = await document.fromHtml(htmlContent);
    const pdfBuffer = await pdf.saveAsBuffer();
    return pdfBuffer;
  }
}

Crear un controlador PDF

Crea un controlador para hacer disponible un punto final para la creación de PDFs.

nest generate controller pdf

nest generate controller pdf

Crea un punto final en el archivo pdf.controller.ts resultante que tome entrada HTML y produzca un PDF.

// src/pdf/pdf.controller.ts
import { Controller, Post, Body, Res } from '@nestjs/common';
import { PdfService } from './pdf.service';
import { Response } from 'express';

@Controller('pdf')
export class PdfController {
  constructor(private readonly pdfService: PdfService) {}

  @Post('generate')
  async generatePdf(@Body('html') htmlContent: string, @Res() res: Response) {
    const pdfBuffer = await this.pdfService.generatePdf(htmlContent);
    res.set({
      'Content-Type': 'application/pdf',
      'Content-Disposition': 'attachment; filename=generated.pdf',
      'Content-Length': pdfBuffer.length,
    });
    res.end(pdfBuffer);
  }
}

IronPDF se utiliza para transformar el contenido HTML en un búfer PDF, que luego se devuelve usando el PdfService. El PdfService usa IronPDF para renderizar HTML como un PDF. Esta integración se maneja fácilmente a través del controlador de NestJS. El siguiente paso es definir un punto final POST, /generate, para recibir el contenido HTML del cliente. Usando la biblioteca IronPDF, convertimos los datos HTML proporcionados en un PDF dentro de la API.

Para ser más precisos, creamos un búfer binario del archivo PDF usando pdf.saveAsBuffer() y creamos un objeto PDF a partir de contenido HTML utilizando IronPdf.fromHtml(htmlContent). Luego, este búfer se devuelve al cliente con el tipo MIME apropiado (application/pdf). El servidor escucha en el puerto 3000 y registra cualquier problema encontrado durante el proceso de creación de PDFs. En respuesta, el cliente recibe un código de estado 500 en caso de error. Este sistema ayuda cuando se crean facturas, informes u otros documentos para una aplicación web, ya que permite crear PDFs dinámicos a partir de contenido HTML.