El 10 de noviembre de 2026, el mantenedor principal Zoltan Kochan publicó en el blog oficial el lanzamiento del gestor de paquetes pnpm 12.19.0, desarrollado en su repositorio abierto en GitHub. Por el número de versión podría parecer una entrega rutinaria, pero detrás hay mejoras que cambian el día a día de los proyectos grandes. De esta lista de cambios me llamó la atención de inmediato cómo resolvieron los autores la compilación de paquetes en el almacenamiento compartido y los vínculos ocultos dentro de un mismo repositorio.
Cuando en un mismo espacio de trabajo (pnpm workspace) conviven varios proyectos —por ejemplo, la tienda @my-org/web y un servicio de backend vecino—, suelen surgir fricciones entre ellos. ¿Cómo evitar que un monorrepositorio así recompile una y otra vez los mismos módulos y impedir que las herramientas de depuración de un paquete se filtren en la compilación de producción del vecino? La versión 12.19.0 resuelve ambos problemas mediante caché de compilaciones en el almacén global, límites estrictos para dependencias peer opcionales y un nuevo formato del archivo de bloqueo.
Apoyo transparente a los autores con el comando pnpm fund
Empecemos por una incorporación en la interfaz de consola que faltaba para igualarse con las herramientas estándar del ecosistema. Un proyecto moderno se apoya en cientos de bibliotecas abiertas, y muchos autores indican en sus manifiestos enlaces para recibir apoyo financiero. Antes, para recopilarlos en un proyecto con pnpm, había que revisar los archivos de configuración a mano.
Ahora el gestor incluye el comando pnpm fund. Recorre las dependencias instaladas y muestra en la terminal un árbol con los enlaces a las páginas de financiación. Para abrir directamente la página de un paquete en el navegador, basta con pasar su nombre: pnpm fund <pkg>. Si una biblioteca indica varias plataformas de donación, la opción --which permite elegir el enlace por su número.
En un monorrepositorio, mostrar los datos de todos los servicios a la vez resulta incómodo, así que el comando admite los flags --recursive, --filter y el formato --json. Por ejemplo, ejecutar pnpm fund --filter @my-org/web --json genera un informe JSON solo con las dependencias de la tienda @my-org/web. Esa exportación se integra fácilmente en un panel interno de la empresa para repartir el presupuesto de patrocinio. Y una vez clara la lista de paquetes, llega la siguiente cuestión: cómo enlazar y compilar rápidamente esos módulos en disco.
Evolución de loaded node linker y caché de compilaciones en sideEffectsCache
El modo habitual de pnpm construye dentro de node_modules un laberinto de enlaces simbólicos y duros hacia el almacén central. En 2026 apareció el modo alternativo nodeLinker.type: loaded (analizamos su funcionamiento en el artículo sobre el lanzamiento de pnpm 12.10.0). Explicado de forma sencilla, es como pasar de colgar carteles de papel por todas las habitaciones a tener un fichero único: el entorno de ejecución carga el código de las bibliotecas directamente desde el almacén global sin miles de symlinks.
Hasta la versión 12.19.0 este modo tenía un punto débil: los paquetes con scripts de compilación (postinstall). Antes había que añadirlos manualmente a las exclusiones de nodeLinker.excluded. En este lanzamiento se elimina ese requisito obligatorio al combinar el modo loaded con la caché de efectos secundarios (sideEffectsCache).
La relación entre beneficio y coste al activar lectura y escritura de sideEffectsCache queda así:
- Ganancia en velocidad y ahorro de disco: cuando un paquete en
@my-org/webnecesita compilación, pnpm lo compila una sola vez en un directorio privado, guarda el resultado ensideEffectsCachey lo sirve directamente desde el almacén. Incluso si el script no modificó ningún archivo, el gestor lo recuerda y no vuelve a ejecutarlo en otros proyectos con el mismo store. Los paquetes sin acierto en caché, los addons nativos.nodey sus dependencias se materializan automáticamente en disco. - Límites de aplicabilidad y exclusiones: no se puede cachear todo sin distinción. En primer lugar, los paquetes cuyo script debe ejecutarse de nuevo en cada proyecto (por ejemplo, instaladores de git-hooks) deben indicarse explícitamente en
sideEffectsCache.exclude. En segundo lugar, pnpm escanea el código JavaScript en busca de__dirname,import.metae importaciones de archivos, materializando esos paquetes en disco. El escáner estático detecta accesos directos, pero no reconoce rutas calculadas dinámicamente: las bibliotecas que concatenan rutas al vuelo deben seguir ennodeLinker.excluded.
Aislamiento de workspaces con projectScopedOptionalPeers y protección frente a paquetes ajenos
Una vez afinada la compilación de módulos, en el monorrepositorio asoma una clase de errores aún más traicionera: la fuga de dependencias peer opcionales entre proyectos. Imagina una cocina compartida donde cada inquilino tiene su estante, pero alguien coge por descuido una especia de la mesa de al lado.
Supongamos que en el proyecto @my-org/web hay instalada en devDependencies una herramienta de consola del empaquetador para maquetación local. Al lado, en el mismo monorrepositorio, vive un servicio de backend que usa un plugin donde esa herramienta figura como dependencia peer opcional (optional peer dependency). Antes, el resolvedor veía que la herramienta ya existía en el monorrepositorio del vecino y la conectaba desde las devDependencies ajenas directamente a las dependencias de producción (production) del paquete del servidor. En local los tests pasaban, pero al desplegar el servicio de backend en un contenedor aislado la compilación cambiaba de comportamiento o fallaba.
Para cerrar esa brecha, en la versión 12.19.0 se añadió el ajuste projectScopedOptionalPeers (en .npmrc se configura como project-scoped-optional-peers=true). Al activarlo, un proyecto del workspace recibe una dependencia peer opcional únicamente cuando está instalada de forma explícita en sus propias dependencias. Las devDependencies ajenas dejan de filtrarse entre fronteras de proyectos, mientras dedupePeerDependents sigue deduplicando con normalidad el resto de paquetes. Incluso con dedupePeerDependents: false, los paquetes peer opcionales ausentes ya no se toman de los vecinos (la resolución desde la raíz solo se mantiene con resolvePeersFromWorkspaceRoot: true).
De paso, los autores corrigieron casos límite relacionados en la resolución del grafo, ampliando la auditoría de dependencias del resumen de pnpm 12.17.0. El gestor dejó de inyectar una dependencia peer opcional si sus peer obligatorias entran en conflicto con las versiones del proyecto. Y pnpm install --filter en clonados parciales del repositorio (sparse checkout) ahora tiene en cuenta las dependencias de paquetes del workspace ausentes en disco, manteniendo el archivo de bloqueo idéntico al de una descarga completa.
Formato experimental lockfile v13 y validación del entorno del workspace
Incluso con un aislamiento limpio de paquetes, a los equipos les estorban los conflictos de fusión en pnpm-lock.yaml. En la estructura anterior, los metadatos de versiones estaban en la sección packages y las combinaciones de peer resueltas aparte en snapshots, de modo que actualizar un paquete modificaba el archivo en dos sitios a la vez.
En la versión 12.19.0 aparece la opción experimental lockfile.format: v13. Pasa pnpm-lock.yaml a una sintaxis YAML similar a JSON con sangría por tabulaciones y comas finales. En lugar de dividir entre packages y snapshots, cada versión de un paquete tiene una única entrada en packages, donde las versiones de las dependencias peer figuran directamente como propiedades. Actualizar un paquete asociado cambia solo las líneas de su versión, reduciendo los conflictos en git. El propio pnpm lee ambos formatos bajo cualquier configuración, pero el estado de v13 sigue siendo experimental: escáneres de CI externos y bots que leen pnpm-lock.yaml sin pasar por la CLI podrían no reconocer el nuevo formato.
Además de las cuatro novedades principales, el lanzamiento trajo mejoras de seguridad y velocidad. Ante un fallo de instalación offline por un archivo ausente, se eliminaron de la salida las URL con tokens de autorización del registro, y las plantillas sin expandir ${VAR} en direcciones de registros dentro de pnpm-workspace.yaml y .npmrc ahora lanzan un error. Los comandos de instalación y ejecución (pnpm run -r, pnpm exec -r) comprueban los campos engines (pnpm, node) y la plataforma (os, cpu, libc) en todos los paquetes del workspace, incluida la raíz y devEngines.runtime. La descompresión de paquetes grandes se aceleró un 30% (en el ejemplo del archivo de TypeScript), la instalación en frío de un proyecto de 1350 paquetes con clonado en macOS bajo software de seguridad activo se volvió un 29% más rápida, pnpm store add añade de forma recursiva carpetas con archivos comprimidos, y la lista de binarios sumó compilación para NetBSD 10 x64.
Para que la actualización del monorrepositorio transcurra sin sorpresas, repasa esta lista de tres puntos:
- Añade
project-scoped-optional-peers=trueen.npmrc, para cortar la captura oculta de paquetes peer opcionales desde lasdevDependenciesde servicios vecinos. - Al activar
nodeLinker.type: loadedconsideEffectsCache, incluye los instaladores de git-hooks ensideEffectsCache.excludey deja ennodeLinker.excludedlos paquetes con rutas de archivos calculadas dinámicamente. - Antes de pasar al equipo a
lockfile.format: v13, comprueba el nuevopnpm-lock.yamlcon tus escáneres de seguridad en CI y bots de actualización automática.
Esta configuración permite obtener de inmediato compilaciones rápidas desde la caché compartida y un aislamiento real de paquetes en el workspace sin romper el pipeline de entrega actual.

