Esquema de actualización de dependencias para proyectos Node (npm, pnpm, yarn)

En los proyectos Node.js, revisar y actualizar las dependencias es una operación habitual de mantenimiento. A continuación se detallan soluciones específicas para los tres gestores de paquetes principales: `npm`, `pnpm` y `yarn`, junto con una recomendación de una herramienta de terceros especialmente útil.

## 1. Verificar dependencias instaladas actualmente

Si quieres ver qué paquetes y versiones específicas están instalados en tu proyecto:

| **Herramienta** | **Comando**              | **Descripción**                        |
| ---------------- | ------------------------ | -------------------------------------- |
| **npm**          | `npm ls --depth=0`       | Lista las versiones de dependencias de primer nivel |
| **pnpm**         | `pnpm ls`                | Por defecto muestra dependencias de primer nivel, muy claro |
| **yarn**         | `yarn list --depth=0`    | Lista el árbol de dependencias instaladas (común en v1) |

> **Sugerencia:** Si quieres saber por qué se instaló un paquete específico (cadena de dependencias), puedes usar `npm why <nombre-del-paquete>` o `pnpm why <nombre-del-paquete>`.

## 2. Verificar dependencias actualizables (solución nativa)

El comando `outdated` incorporado en las herramientas nativas compara las versiones en `package.json` con las disponibles en el repositorio remoto.

### Los resultados típicamente incluyen:

- **Current**: Versión actualmente instalada
- **Wanted**: Máxima versión permitida por el rango semántico en `package.json` (ej. `^1.0.0`)
- **Latest**: Última versión disponible en el repositorio (puede incluir actualizaciones mayores)

#### Comandos por herramienta:

- **npm**: `npm outdated`
- **pnpm**: `pnpm outdated`
- **yarn**: `yarn outdated`

## 3. Opciones para actualizar dependencias

### Opción A: Actualización segura (solo hasta la versión Wanted)

Esto normalmente involucra actualizaciones de parches (Patch) o versiones menores (Minor), con bajo riesgo y sin modificar los rangos en `package.json`.

- **npm**: `npm update`
- **pnpm**: `pnpm up`
- **yarn**: `yarn upgrade`

### Opción B: Actualización completa (hasta la versión Latest)

Si quieres ignorar las restricciones de `^` o `~` e ir directamente a la última versión (puede incluir actualizaciones con cambios importantes), se recomienda usar estos comandos interactivos:

#### **pnpm (altamente recomendado)**

pnpm incluye una interfaz interactiva muy intuitiva:

```Bash
pnpm up -i --latest
```

*Esto mostrará una lista donde puedes seleccionar con espacio los paquetes a actualizar, muy visual.*

#### **Yarn**

```Bash
yarn upgrade-interactive --latest
```

#### **npm (requiere herramienta de terceros)**

npm nativo tiene soporte limitado para "actualizar todo a la última", generalmente se recomienda usar **`npm-check-updates` (ncu)**.

## 4. Herramienta definitiva: npm-check-updates (ncu)

Esta es actualmente la solución más versátil y compatible, soporta npm/pnpm/yarn, y puede modificar directamente los versionados en `package.json`.

1. **Verificar actualizaciones**:

   ```Bash
   npx npm-check-updates
   ```

2. **Modificar automáticamente package.json**:

   ```Bash
   npx npm-check-updates -u
   ```

3. **Instalar cambios**:

   Tras modificar `package.json`, ejecuta `npm install` o `pnpm install` según tu gestor.

## Resumen y recomendaciones

1. **Verificación diaria**: Usa `pnpm outdated` o `npm outdated`
2. **Actualización interactiva rápida**: Recomendado `pnpm up -i --latest`
3. **Actualización masiva potente**: Usa `ncu -u`
4. **Seguridad**: Tras actualizaciones mayores (Major), ejecuta siempre las pruebas unitarias para prevenir fallos por cambios en las APIs de las dependencias