pnpm 10.16

마이너 변경 사항#

종속성 업데이트 지연을 위한 새 설정#

최근 인기 패키지가 실제로 공격당한 사고가 여러 차례 있었습니다. 침해된 버전을 설치할 위험을 줄이기 위해, 새로 릴리스된 종속성의 설치를 지연시키는 새 설정을 도입합니다. 대부분의 경우 이러한 공격은 빠르게 발견되며, 악성 버전은 한 시간 이내에 레지스트리에서 제거됩니다.

새 설정의 이름은 minimumReleaseAge입니다. 이 설정은 버전이 게시된 후 pnpm이 해당 버전을 설치하기까지 경과해야 하는 시간을 분 단위로 지정합니다. 예를 들어 minimumReleaseAge: 1440으로 설정하면 최소 하루 전에 릴리스된 패키지만 설치할 수 있습니다.

minimumReleaseAge를 설정했지만 특정 종속성에 대해서는 이 제한을 해제해야 한다면 minimumReleaseAgeExclude 설정에 해당 종속성을 나열할 수 있습니다. 예를 들어 다음 구성을 사용하면 pnpm은 릴리스 시점과 관계없이 항상 최신 버전의 webpack을 설치합니다:

minimumReleaseAgeExclude:
- webpack

관련 이슈: #9921.

고급 종속성 필터링: finder 함수 활용#

finders 지원을 추가했습니다.

이전에는 pnpm list와 pnpm why가 이름(및 선택적으로 버전)으로만 종속성을 검색할 수 있었습니다. 예시:

pnpm why minimist

설치된 모든 minimist 인스턴스에 이르는 종속성 체인을 출력합니다:

verdaccio 5.20.1
├─┬ handlebars 4.7.7
│ └── minimist 1.2.8
└─┬ mv 2.1.1
└─┬ mkdirp 0.5.6
  └── minimist 1.2.8

종속성의 이름뿐만 아니라 다른 속성으로 검색하고 싶다면 어떨까요? 예를 들어 피어 종속성에 react@17이 있는 모든 패키지를 찾으려면 어떻게 해야 할까요?

이제 "finder 함수"로 이것이 가능합니다. 이러한 finder 함수는 .pnpmfile.cjs에 선언할 수 있으며, pnpm list 또는 pnpm why를 실행할 때 --find-by=<function name> 플래그로 호출할 수 있습니다.

피어 종속성에 React 17이 있는 종속성을 찾고 싶다고 가정해 보겠습니다. 다음 finder를 .pnpmfile.cjs에 추가할 수 있습니다:

module.exports = {
finders: {
  react17: (ctx) => {
    return ctx.readManifest().peerDependencies?.react === "^17.0.0";
  },
},
};

이제 다음을 실행하여 이 finder 함수를 사용할 수 있습니다:

pnpm why --find-by=react17

pnpm은 피어 종속성에 이 React가 있는 모든 종속성을 찾아 종속성 그래프에서의 정확한 위치를 출력합니다.

@apollo/client 4.0.4
├── @graphql-typed-document-node/core 3.2.0
└── graphql-tag 2.12.6

출력에 추가 정보를 표시할 수도 있습니다. finder에서 문자열을 반환하면 됩니다. 예를 들어 다음 finder를 사용하면:

module.exports = {
finders: {
  react17: (ctx) => {
    const manifest = ctx.readManifest();
    if (manifest.peerDependencies?.react === "^17.0.0") {
      return `license: ${manifest.license}`;
    }
    return false;
  },
},
};

일치하는 모든 패키지는 package.json의 라이선스도 출력합니다:

@apollo/client 4.0.4
├── @graphql-typed-document-node/core 3.2.0
│   license: MIT
└── graphql-tag 2.12.6
  license: MIT

관련 PR: #9946.

패치 변경 사항#

  • Node.js 24에서 pnpm을 실행할 때 출력되는 사용 중단 경고를 수정했습니다 #9529.
  • nodeVersion이 정확한 semver 버전으로 설정되지 않은 경우 오류를 발생시킵니다 #9934.
  • pnpm publish가 .tar.gz 파일을 게시할 수 있어야 합니다 #9927.
  • Ctrl-C로 실행 중인 프로세스를 취소하면 pnpm run이 비정상 종료 코드를 반환해야 합니다 #9626.