Actualización de dependencias en NEST y TimeWareM

Clase 32 de 36Curso de NestJS: Persistencia de Datos con TypeORM

Resumen

¿Cómo actualizar las dependencias en NEST?

El mundo del desarrollo de software evoluciona rápidamente, y mantener tu proyecto actualizado puede ser todo un desafío, especialmente cuando se trata de actualizaciones de versiones en frameworks como NEST. Aquí te explicamos cómo abordar el proceso de actualizar tu aplicación de NEST versión 7 a la más actual (versión 9) y cómo manejar las dependencias actualizadas de TimeWareM.

¿Cuáles son los pasos para actualizar a una nueva versión de NEST?

  1. Revisar la guía de migración: Comienza por revisar la guía de migración de NEST. Esta proporciona instrucciones detalladas sobre cómo pasar de una versión a otra, en este caso, de la 8 a la 9.

  2. Migraciones incrementales: Si estás en una versión anterior, como la 7, necesitarás realizar migraciones incrementales utilizando la documentación de cada versión sucesiva (de la 7 a la 8, y luego de la 8 a la 9).

  3. Instalación de un nuevo proyecto base: Crea un proyecto nuevo utilizando el comando nest new, lo que te permitirá ver cuáles son las versiones sugeridas de las dependencias en la versión actual, ayudándote a gestionar la compatibilidad con tu proyecto.

¿Cómo actualizamos el CLI de NEST Globalmente?

El CLI de NEST debe estar actualizado a nivel global para que puedas crear y manejar proyectos con la versión más reciente. Aquí está el comando para hacerlo:

npm install -g @nestjs/cli

¿Cómo realizar la actualización de dependencias en el proyecto?

El objetivo es que las dependencias del proyecto se alineen con las sugeridas por un nuevo proyecto en NEST 9. Aquí te muestro cómo hacerlo de manera efectiva:

  1. Eliminar los módulos actuales: Usa el siguiente comando para borrar los módulos existentes:

    rm -rf node_modules
    
  2. Reinstalar las nuevas dependencias básicas de NEST 9: En el archivo package.json, incluye las dependencias por defecto de un proyecto de NEST 9, luego ejecuta el comando:

    npm install
    
  3. Agregar las dependencias específicas de tu proyecto: Las dependencias que necesitas específicamente para tu proyecto, como TimeWareM y Swagger, deben ser añadidas manualmente:

    npm install @nestjs/config @nestjs/swagger typeorm class-transformer class-validator @hapi/joi mysql2 pg
    

¿Cómo documentar el proceso de actualización?

Crear un archivo de markdown puede ser esencial para documentar cambios de versiones y mantenimiento futuro. Aquí está el ejemplo de cómo estructurar esta documentación:

# Actualización de dependencias

## Versión 9
- `@nestjs/cli`: 9.x.x
- `@nestjs/core`: 9.x.x
- `rxjs`: 7.x.x
- `typeorm`: 0.3.x

## Versión 7
- `nestjs`: 7.x.x
- `typeorm`: 0.2.x

¿Qué problemas podemos anticipar al actualizar?

Una vez actualizadas las dependencias, pueden surgir problemas, especialmente relacionados con TimeWareM, debido a las actualizaciones de API. Estas son algunas recomendaciones:

  • Revisar cambios en el API de TimeWareM: La migración de TimeWareM de la versión 0.2 a la 0.3 incluye varios errores significativos (breaking changes) que deben ser manejados cuidadosamente.

  • Probar el proyecto: Ejecutar npm start para comprobar que el proyecto compila y ejecuta sin problemas. Espera posibles mensajes de error que necesitarán ser ajustados según la nueva API.

Con estos pasos, habrás actualizado exitosamente tu proyecto a NEST 9, alineándolo con las mejores prácticas y asegurando que te beneficies de las mejoras y nuevas funcionalidades. Recuerda que este proceso, aunque lleva algo de esfuerzo manual, es fundamental para mantener la compatibilidad y seguridad del proyecto. ¡Sigue adelante, tu aventura de desarrollo continúa!