NestJS: persistencia con TypeORM

NestJS representa una evolución natural en el desarrollo de aplicaciones Node.js, combinando la flexibilidad de JavaScript con la robustez de TypeScript y los patrones arquitectónicos más sólidos del desarrollo empresarial. Este framework adopta un enfoque modular y basado en decoradores, facilitando la creación de aplicaciones escalables y mantenibles.

La persistencia de datos constituye uno de los pilares fundamentales de cualquier aplicación empresarial. En el ecosistema NestJS, TypeORM emerge como la solución más elegante para gestionar la capa de acceso a datos, proporcionando un Object-Relational Mapping (ORM) que abstrae las complejidades del SQL mientras mantiene el control y la flexibilidad necesarios para aplicaciones profesionales.

Arquitectura modular y sistema de inyección

El corazón de NestJS reside en su sistema de inyección de dependencias, inspirado en frameworks como Angular y Spring. Este sistema permite crear aplicaciones con bajo acoplamiento y alta cohesión, facilitando tanto el desarrollo como las pruebas unitarias.

Los providers actúan como los componentes fundamentales de esta arquitectura. Un provider puede ser cualquier clase que pueda ser inyectada como dependencia: servicios, repositorios, factories, helpers o cualquier otro valor. El framework gestiona automáticamente la creación e inyección de estas dependencias, liberando al desarrollador de la gestión manual del ciclo de vida de los objetos.

@Injectable()
export class UserService {
  constructor(private readonly userRepository: UserRepository) {}
  
  async findAll(): Promise<User[]> {
    return this.userRepository.find();
  }
}

Los servicios encapsulan la lógica de negocio y actúan como intermediarios entre los controladores y la capa de persistencia. Esta separación de responsabilidades facilita la reutilización de código y mejora la testabilidad de la aplicación.

Gestión avanzada de dependencias

El sistema de inyección de NestJS ofrece características avanzadas para escenarios complejos. Los scopes de inyección determinan el ciclo de vida de los providers, permitiendo desde instancias singleton hasta providers específicos por request, adaptándose a diferentes necesidades de rendimiento y aislamiento.

@Injectable({ scope: Scope.REQUEST })
export class RequestScopedService {
  private readonly requestId = Math.random();
  
  getRequestId(): number {
    return this.requestId;
  }
}

Las dependencias circulares pueden surgir en aplicaciones complejas donde dos o más providers se referencian mutuamente. NestJS proporciona mecanismos elegantes para resolver estas situaciones mediante forward references y lazy loading.

Los providers asíncronos permiten la inicialización de dependencias que requieren operaciones asíncronas, como conexiones a bases de datos o configuraciones remotas. Esta característica es fundamental para aplicaciones que dependen de recursos externos.

Middlewares y procesamiento de requests

Los middlewares en NestJS funcionan de manera similar a Express.js, pero con la ventaja adicional de estar completamente integrados en el sistema de inyección de dependencias. Permiten ejecutar código antes de que la request llegue al controlador, facilitando tareas como autenticación, logging, validación o transformación de datos.

@Injectable()
export class LoggerMiddleware implements NestMiddleware {
  use(req: Request, res: Response, next: NextFunction) {
    console.log(`${req.method} ${req.originalUrl}`);
    next();
  }
}

Organización modular

Los módulos constituyen la unidad organizativa fundamental en NestJS. Cada módulo encapsula un conjunto relacionado de providers, controladores y otros módulos, creando límites claros entre diferentes áreas funcionales de la aplicación.

La referencia a módulos mediante ModuleRef proporciona acceso programático al contenedor de inyección de dependencias, permitiendo la resolución dinámica de providers y la implementación de patrones avanzados como factories dinámicos.

@Module({
  imports: [TypeOrmModule.forFeature([User])],
  providers: [UserService],
  controllers: [UserController],
  exports: [UserService]
})
export class UserModule {}

Integración con TypeORM

TypeORM se integra perfectamente con NestJS, proporcionando una capa de abstracción elegante sobre las bases de datos relacionales. La configuración con MySQL es directa y permite aprovechar todas las características avanzadas del ORM.

Las entidades representan las tablas de la base de datos como clases TypeScript, utilizando decoradores para definir la estructura, relaciones y comportamientos. Esta aproximación code-first permite que el esquema de la base de datos evolucione junto con el código.

@Entity()
export class User {
  @PrimaryGeneratedColumn()
  id: number;

  @Column({ unique: true })
  email: string;

  @Column()
  name: string;

  @CreateDateColumn()
  createdAt: Date;
}

Los decoradores de entidades proporcionan un control granular sobre la estructura de las tablas, incluyendo tipos de datos, restricciones, índices y relaciones. Esta flexibilidad permite modelar esquemas complejos manteniendo la legibilidad del código.