@pnpm/lockfile.fs 1100.1.16 → 1100.2.0

package/CHANGELOG.md

@@ -1,5 +1,72 @@
 # @pnpm/lockfile-file
 
+## 1100.2.0
+
+### Minor Changes
+
+- **Security fix.** Affects projects using `namedRegistries` on pnpm 11.1.0–11.19.x. It is **semi-breaking** for those projects — see "If you use named registries" below.
+
+  The lockfile recorded no marker for which registry a package came from. Packages were keyed by `name@version` alone, and entry lookup went through `refToRelative(ref, name)`, so a dependency you declared against one registry could be satisfied by an entry that was actually resolved from another. When two registries served the same name and version, both collapsed onto a single `packages:` entry and whichever resolved first decided the tarball every consumer got.
+
+  That is a package-substitution risk: a package you expect from your private registry could be installed from a different registry that publishes the same name and version, and the lockfile recorded nothing that would let you tell.
+
+  Packages resolved from a named registry are now recorded under registry-qualified keys (`<name>@<registryName>:<version>`, e.g. `foo@work:1.0.0`), so each registry gets its own entry and the lockfile pins which one a dependency came from.
+
+  The lockfile format version is unchanged. Registry-qualified keys appear only for packages resolved from a named registry, so a project that does not use `namedRegistries` sees no difference, and older pnpm versions keep reading the file.
+
+  ### If you use named registries
+
+  Your next non-frozen install re-keys those entries, which shows up as a lockfile diff. Commit it — that diff is the fix being applied. Review it: an entry that moves to a registry you did not expect is worth investigating.
+
+  Everyone working on the project should be on this version or newer before you do. An older pnpm reads the re-keyed lockfile fine — frozen installs are unaffected — but it does not produce registry-qualified keys itself, so any install that updates the lockfile writes those entries back to the old shape, and the next install on a current pnpm re-qualifies them. The result is a lockfile that flips back and forth, and while it is in the old shape the project is exposed again. Because the lockfile format version is deliberately unchanged, pnpm cannot detect this and warn you about it.
+
+  There is no setting to keep the old behavior: the old shape is the vulnerability.
+
+  Tarball URLs that follow the standard registry layout are no longer written to the lockfile for named-registry packages; they are recomputed from the `namedRegistries` setting on demand.
+
+  To use named registries, map your aliases in `pnpm-workspace.yaml`:
+
+  ```yaml
+  namedRegistries:
+    work: https://npm.enterprise.example.com/
+  ```
+
+  ### New built-in `npmjs:` alias
+
+  `npmjs:` now resolves to `https://registry.npmjs.org/` with no configuration, alongside the existing `gh:` alias for GitHub Packages. It pins a dependency to the public registry even when `registry` points elsewhere, such as an internal proxy:
+
+  ```json
+  { "dependencies": { "left-pad": "npmjs:^1.3.0" } }
+  ```
+
+  `npm:` cannot do this — it is the alias protocol (`npm:<name>@<range>`) and resolves through whatever `registry` points at.
+
+  **If you mirror or proxy npmjs, point the alias at your mirror:**
+
+  ```yaml
+  namedRegistries:
+    npmjs: https://npm.internal.example.com/
+  ```
+
+  Built-in registry URLs are also the prefixes a lockfile's recorded tarball URL is matched against when pnpm verifies a package. Without the override, an entry whose tarball URL is on `registry.npmjs.org` is verified against the public registry rather than your mirror. This only affects lockfiles that record such URLs — a canonical URL for your configured registry is omitted from the lockfile and unaffected — and only when a tarball-URL, `minimumReleaseAge`, or `trustPolicy` check runs. Overriding the alias is the same escape hatch GHES users already have for `gh`.
+
+  Every alias the lockfile references must stay in `namedRegistries`: reading an entry whose alias is gone fails with `ERR_PNPM_MISSING_NAMED_REGISTRY` rather than silently falling back to the default registry, since that would fetch a different package. Renaming an alias re-resolves the packages that used it.
+
+  Named registry aliases that shadow a reserved dependency specifier prefix (`file`, `link`, `workspace`, `runtime`, `npm`, `jsr`, ...) are now rejected with `ERR_PNPM_RESERVED_NAMED_REGISTRY_NAME` instead of being silently shadowed by the corresponding resolver.
+
+  `pnpm licenses` and `pnpm sbom` now keep the two artifacts apart as well: license records carry the registry alias, and SBOM components carry the purl `repository_url` qualifier.
+
+### Patch Changes
+
+- Updated dependencies:
+  - @pnpm/constants@1101.0.0
+  - @pnpm/deps.path@1100.1.0
+  - @pnpm/error@1100.1.1
+  - @pnpm/lockfile.merger@1100.0.19
+  - @pnpm/lockfile.types@1100.0.19
+  - @pnpm/lockfile.utils@1101.0.0
+  - @pnpm/types@1101.9.0
+
 ## 1100.1.16
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnpm/lockfile.fs",
-  "version": "1100.1.16",
+  "version": "1100.2.0",
   "description": "Read/write pnpm-lock.yaml files",
   "keywords": [
     "pnpm",
@@ -29,15 +29,15 @@
     "!*.map"
   ],
   "dependencies": {
-    "@pnpm/constants": "1100.0.1",
-    "@pnpm/deps.path": "1100.0.13",
-    "@pnpm/error": "1100.1.0",
-    "@pnpm/lockfile.merger": "1100.0.18",
-    "@pnpm/lockfile.types": "1100.0.18",
-    "@pnpm/lockfile.utils": "1100.1.7",
+    "@pnpm/constants": "1101.0.0",
+    "@pnpm/deps.path": "1100.1.0",
+    "@pnpm/error": "1100.1.1",
+    "@pnpm/lockfile.merger": "1100.0.19",
+    "@pnpm/lockfile.types": "1100.0.19",
+    "@pnpm/lockfile.utils": "1101.0.0",
     "@pnpm/network.git-utils": "1100.0.3",
     "@pnpm/object.key-sorting": "1100.0.2",
-    "@pnpm/types": "1101.8.0",
+    "@pnpm/types": "1101.9.0",
     "@zkochan/rimraf": "^4.0.0",
     "comver-to-semver": "^2.0.0",
     "js-yaml": "npm:@zkochan/js-yaml@0.0.11",
@@ -52,7 +52,7 @@
   },
   "devDependencies": {
     "@jest/globals": "30.4.1",
-    "@pnpm/lockfile.fs": "1100.1.16",
+    "@pnpm/lockfile.fs": "1100.2.0",
     "@pnpm/logger": "1100.0.0",
     "@types/js-yaml": "^4.0.9",
     "@types/normalize-path": "^3.0.2",