Migración y ajustes en TimewareM 0.3: Cambios en métodos y servicios

Curso de NestJS: Persistencia de Datos con TypeORM

Contenido del curso

Introducción

Database

TypeORM

Migraciones

Relaciones

Consultas

Migración a NestJS 9 y TypeORM 0.3

Próximos pasos

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0022:05

Migración y ajustes en TimewareM 0.3: Cambios en métodos y servicios

Curso de NestJS: Persistencia de Datos con TypeORM

Clase 33 de 36

Clase 33 / 36

Recursos

Actualizar TypeORM a su versión 0.3 implica ajustes concretos en la forma en que consultamos la base de datos desde nuestros servicios en NestJS. Aunque la arquitectura general de la aplicación se mantiene intacta, los métodos de búsqueda cambiaron su API y es necesario adaptarlos uno por uno. A continuación se detallan los cambios más relevantes y cómo resolverlos de forma ordenada.

¿Qué cambió en los tipos y opciones de búsqueda de TypeORM 0.3?

El primer cambio visible es que el tipo FindConditions dejó de existir [01:20]. En versiones anteriores se utilizaba para construir filtros dinámicos: si llegaban parámetros como limit u offset, se armaba el where progresivamente y se enviaba la consulta. Ahora, ese tipo se reemplaza por FindOptionsWhere, que se importa directamente desde TypeORM. El ajuste es mínimo: basta con sustituir el tipo en la declaración y todo sigue funcionando.

El cambio más significativo está en findOne [01:55]. Antes recibía el ID como primer parámetro de forma directa y las opciones (como relaciones) como segundo parámetro. En la versión 0.3, findOne ya no acepta el ID directamente: todo se envía dentro de un objeto de opciones con la cláusula where.

Antes: findOne(id, { relations }) recibía el ID en primer lugar.
Ahora: findOne({ where: { id }, relations }) encapsula el filtro dentro de where.

Este patrón se repite en cada servicio donde se utilice findOne, ya sea para buscar un producto, una marca con su brandId, una categoría o cualquier otra entidad [02:40].

¿Cómo se reemplaza findByIds con el operador In?

La función findByIds también quedó marcada como deprecated [03:15]. TypeORM sugiere utilizar findBy junto con el operador In, que se importa directamente desde el paquete. La sintaxis queda así:

typescript import { In } from 'typeorm';

const products = await this.productRepo.findBy({ id: In(ids) });

El operador In recibe el arreglo de IDs y genera la consulta correspondiente. Este enfoque forma parte de la estrategia de TypeORM 0.3 para ofrecer una API más robusta y compatible con distintos tipos de bases de datos.

¿Qué pasa con findOneBy y los servicios restantes?

El método findOneBy reemplaza al antiguo findOne cuando solo se necesita filtrar por un campo sin relaciones adicionales [04:08]. Se le envía directamente el objeto con la condición:

typescript const item = await this.repo.findOneBy({ id });

El proceso de migración en los servicios se vuelve metódico: recorrer cada findOne y mover el ID desde el primer parámetro hacia el where [05:50]. Las entidades no requieren cambios; tampoco los controladores, ya que la capa de servicios absorbe toda la actualización.

¿Cómo se migra el HttpModule en NestJS 9?

Otro cambio importante es que HttpModule ya no vive en @nestjs/common [07:35]. Ahora se encuentra en un paquete separado que debe instalarse:

bash npm install @nestjs/axios axios

Donde antes se importaba HttpService desde @nestjs/common, ahora se importa desde @nestjs/axios. El servicio mantiene el mismo nombre y funcionalidad.

Además, el método toPromise está marcado como deprecated [08:15]. La alternativa recomendada es utilizar lastValueFrom de RxJS:

typescript import { lastValueFrom } from 'rxjs';

const request = this.httpService.get(url); const { data } = await lastValueFrom(request);

¿Qué papel juegan las variables de entorno en la migración?

Al levantar el servicio tras la migración, es posible que aparezcan errores relacionados con variables de entorno faltantes [09:05]. Si previamente se implementó validación de configuración —una buena práctica—, el sistema exigirá que variables como API_KEY, DATABASE_NAME, DATABASE_PORT, POSTGRES_USER, POSTGRES_PASSWORD y el HOST estén definidas en el archivo .env.

Verificar el archivo docker-compose para obtener los valores correctos.
Completar tanto las variables de PostgreSQL como las de MySQL si se utiliza el switch de TypeORM.
Validar todas las variables necesarias en el esquema de configuración para evitar arranques incompletos.

Una vez configuradas, el servicio arranca sin errores de TypeORM ni de configuración [11:30]. Los métodos create, update y delete permanecen exactamente igual; solo las consultas de tipo find y sus variantes requirieron actualización.

Si ya completaste esta migración, comparte qué parte te resultó más repetitiva o si encontraste algún caso particular que no se haya cubierto aquí.

Resumen

¿Qué cambió en los tipos y opciones de búsqueda de TypeORM 0.3?

Antes: findOne(id, { relations }) recibía el ID en primer lugar.
Ahora: findOne({ where: { id }, relations }) encapsula el filtro dentro de where.

Este patrón se repite en cada servicio donde se utilice findOne, ya sea para buscar un producto, una marca con su brandId, una categoría o cualquier otra entidad [02:40].

¿Cómo se reemplaza findByIds con el operador In?

typescript import { In } from 'typeorm';

const products = await this.productRepo.findBy({ id: In(ids) });

¿Qué pasa con findOneBy y los servicios restantes?

El método findOneBy reemplaza al antiguo findOne cuando solo se necesita filtrar por un campo sin relaciones adicionales [04:08]. Se le envía directamente el objeto con la condición:

typescript const item = await this.repo.findOneBy({ id });

¿Cómo se migra el HttpModule en NestJS 9?

Otro cambio importante es que HttpModule ya no vive en @nestjs/common [07:35]. Ahora se encuentra en un paquete separado que debe instalarse:

bash npm install @nestjs/axios axios

Donde antes se importaba HttpService desde @nestjs/common, ahora se importa desde @nestjs/axios. El servicio mantiene el mismo nombre y funcionalidad.

Además, el método toPromise está marcado como deprecated [08:15]. La alternativa recomendada es utilizar lastValueFrom de RxJS:

typescript import { lastValueFrom } from 'rxjs';

const request = this.httpService.get(url); const { data } = await lastValueFrom(request);

¿Qué papel juegan las variables de entorno en la migración?

Verificar el archivo docker-compose para obtener los valores correctos.
Completar tanto las variables de PostgreSQL como las de MySQL si se utiliza el switch de TypeORM.
Validar todas las variables necesarias en el esquema de configuración para evitar arranques incompletos.

Si ya completaste esta migración, comparte qué parte te resultó más repetitiva o si encontraste algún caso particular que no se haya cubierto aquí.

Comentarios (4)4 comentarios

Miguel Angel Reyes Moreno

Hace 3 años

Super que hayan hecho esta parte, incluso funciona todo bien con nest en su versión 10 :D

Carlos Rodríguez

En las relaciones, podemos usar de dos maneras,, recomienda la segunda para te tener errores de type. . 1 Primera forma, la convencional

// Relación de un nivel
const product = await this.productRepo.findOne({
	where: { id },
	relations: ['brand', 'categories'],
});

# Relación de dos niveles
const order = await this.orderRepo.findOne({
	where: { id },
	relations: ['items', 'items.product'],
});

.
2 Segunda forma, con tipado

// Relación de un nivel
const product = await this.productRepo.findOne({
	where: { id },
	relations: { brand: true, categories: true },
});

# Relación de dos niveles
const order = await this.orderRepo.findOne({
	where: { id },
	relations: { items: { product: true } },
});

José de Jesús Valera Durán

Hace 4 meses

Al 2026-06-07 cambio el audio de stereo a mono, se reciente cuando usas audifonos para reproducir la clase

James Philip Tellez Talero

Me encanta esta seccion, super util para documentar las actualizaciones para node incluso

Introducción

Conexiones a Bases de Datos con Time OEM y NetsGIS

Integración de Datos con Next.js y Time ORM en Proyectos E-commerce

Database

Instalación de Docker en Windows, macOS y Ubuntu

Configuración de Postgres en Docker Compose

Conexión a Postgres en Docker: Terminal y PgAdmin

Conexión de NestJS a Postgres con Node Postgres

Inyección de Dependencias en NETJS: Conexión a PostgreSQL

Conexión a Bases de Datos con Variables de Entorno en Node.js

TypeORM

Implementación de TypeORM con NestJS en Proyectos Node.js

Creación de Entidades en ORM para Tiendas Virtuales

Implementación del Patrón Repository en NestJS con TypeORM

Operaciones CRUD en ProductService usando TypeORM y Postgres

Cambio de Postgres a MySQL en Docker para CRUD de Productos

Migraciones

Configuración de Migraciones en Bases de Datos con TimeORM

Configuración y uso de migraciones con TimeORM y TypeScript

Ejecución y gestión de migraciones con Time1M en Node.js

Migraciones en bases de datos: agregar campos automáticamente

Relaciones

Relaciones 1 a 1 en Bases de Datos con TimeORM

Manipulación de Relaciones Uno a Uno en Controladores y Servicios

Relaciones Uno a Muchos en Bases de Datos con TypeORM

Gestión de Relaciones Uno a Muchos en Controladores de API

Relaciones Muchos a Muchos en Time1M: Creación y Manejo Práctico

Manipulación de Relaciones Muchos a Muchos en Controladores

Manipulación de Relaciones Muchos a Muchos con TimeORM en JavaScript

Relaciones Muchos a Muchos con Campos Agregados en TimeWareM

CRUD de órdenes de compra y gestión de ítems en NestJS

Consultas

Paginación de Productos con Limit y Offset en Controladores API

Filtrado de Precios con Rango Usando Between en Time Wareham

Indexación de Parámetros en Bases de Datos: Uso y Precauciones

Buenas prácticas de nombramiento en JavaScript y bases de datos

Serialización y Transformación de Datos en APIs con ClassTransformer

Migración a NestJS 9 y TypeORM 0.3

Actualización de dependencias en NEST y TimeWareM

Migración y ajustes en TimewareM 0.3: Cambios en métodos y servicios

Actualización de Migraciones en TimeWareM 0.3

Próximos pasos

Soluciones a referencias circulares en módulos NestJS

Persistencia de Datos con Time Ware M: Conexiones y Buenas Prácticas

Migración y ajustes en TimewareM 0.3: Cambios en métodos y servicios