pnpm 12.23.0 dan 11.29.0 dirilis pada 22 November 2026. Kalau kamu menerbitkan paket, memakai pnpm dlx, pnpm create, atau perintah global di CI, cek empat perubahan ini sebelum menaikkan versi. Platform variants dihapus, pnpm pack dan pnpm publish menolak paket non-private yang bergantung pada workspace package private, dlx dan create mengabaikan konfigurasi lokal, dan pnpm install menolak dependensi file lokal yang dideklarasikan paket dari registry. Catatan rilis tidak menyebut versi Node minimum, jadi cek lingkungan CI-mu sendiri.

Empat perubahan yang bisa mematahkan CI

Pertama, platform variants hilang: pnpm tidak lagi membaca publishConfig.variants atau field variant, dan opsi pnpm pack --variant serta --upload-variant, --variant-integrity, --no-variants di pnpm publish dihapus. Terbitkan tiap build platform sebagai paket terpisah dan daftarkan di optionalDependencies. Frozen install dari lockfile yang mencatat variant gagal dengan ERR_PNPM_BROKEN_LOCKFILE, jadi jalankan pnpm install untuk me-resolve ulang.

Kedua, pnpm pack dan pnpm publish gagal kalau paket non-private mencantumkan workspace package private di dependencies. devDependencies, optionalDependencies, peerDependencies, dan bundled dependencies tetap boleh.

Ketiga, pnpm dlx, pnx, dan pnpm create mengabaikan konfigurasi lokal di direktori kerja: .pnpmfile.cjs, proxy dan TLS di .npmrc proyek, serta setting eksekusi, layout, dan resolusi di pnpm-workspace.yaml lokal. Setting dari config.yaml global tetap berlaku. Perintah global (-g) juga tidak lagi memuat .pnpmfile.cjs, pnpm-workspace.yaml, atau .npmrc dari direktori saat ini. Kalau pipeline kamu bergantung pada proxy di .npmrc proyek untuk dlx, pindahkan ke konfigurasi global.

Keempat, pnpm install menolak dependensi filesystem lokal (file:, link:, dan workspace: berbasis path) yang dideklarasikan paket non-lokal, dengan error ERR_PNPM_LOCAL_SUBDEP_NOT_ALLOWED. Setting blockExoticSubdeps kini juga ditegakkan terhadap entri pnpm-lock.yaml, termasuk saat --frozen-lockfile, padahal sebelumnya subdependensi git atau URL tarball tetap terpasang meski setting itu aktif.

Kredensial dan OTP tidak lagi dibaca dari konfigurasi proyek

Menurut catatan rilis, repositori bisa menulis otp: ${NPM_TOKEN} di samping registry: sehingga pnpm publish mengirim isi variabel lingkungan itu ke registry lewat header npm-otp. Mulai sekarang otp tidak dibaca dari file konfigurasi apa pun, dan nilainya di pnpm-workspace.yaml diabaikan dengan peringatan. Pakai opsi atau variabel lingkungan:

pnpm publish --otp 123456
PNPM_CONFIG_OTP=123456 pnpm publish

Kredensial registry kini hanya dikirim lewat HTTPS atau HTTP loopback, dan pnpm config get menolak mencetak setting autentikasi yang dilindungi.

Fitur baru yang layak dicoba

pnpm catalog migrate memindahkan specifier dependensi ke default catalog dan menggantinya dengan catalog: di package.json, tetapi hanya untuk dependensi yang dideklarasikan identik di semua proyek. pnpm edit membuka direktori paket terpasang di editor, dan pnpm link --hard menaut paket berprotokol file: lewat hard link. pnpm remove menerima glob dengan pengecualian, misalnya pnpm remove "eslint-*" "!eslint-plugin-import". Untuk keamanan rantai pasok, flag --minimum-release-age dan --minimum-release-age-exclude berlaku untuk satu kali jalan di install, add, update, dan dlx, mirip pola masa tunggu yang kami bahas di post Rust 1.100 dan Cargo.

Catatan dari 12.22: cache registry melewati minimumReleaseAge

Rilis 12.22.0 (17 November) memperbaiki masalah: setelah registry default atau scoped berganti, pnpm install memakai ulang hasil resolusi yang di-cache untuk registry lama dan melewati pengecekan minimumReleaseAge dan trustPolicy terhadap registry baru. Kalau kamu pindah ke mirror atau registry privat sambil mengandalkan masa tunggu rilis, naikkan ke 12.22.0 atau lebih baru. Halaman rilis tidak menyebut rentang versi terdampak. Semua sumber di bawah adalah catatan rilis pnpm sendiri, dan saya belum membaca liputan media independen.

Sumber