npm view 는 설치하지 않고 레지스트리에서 패키지 정보를 읽는다. versions 필드는 게시된 모든 버전 목록이고, time 필드는 버전마다 게시된 시각이다.

-- 설치하지 않고 레지스트리 메타데이터를 읽는다
npmView :: Package -> Field -> IO Json
npmView "cowsay" "versions"   -- 게시된 모든 버전
npmView "cowsay" "time"       -- 버전마다 게시된 시각
#210

npm 은 지금 실행 중인 스크립트 이름을 npm_lifecycle_event 환경 변수로 넘긴다. dev:hello 스크립트에서 ${npm_lifecycle_event#dev:} 로 접두사를 떼면 hello 가 남는다. 스크립트는 sh 로 돌기 때문에 bash 전용 ${var//a/b} 대신 POSIX ${var#prefix} 를 쓴다. 다만 이렇게 하기보다 스크립트를 따로 쓰는 편이 낫다.

-- npm 은 실행 중인 스크립트 이름을 npm_lifecycle_event 로 넘긴다
stage :: String -> Maybe String
stage = stripPrefix "dev:"       -- ${npm_lifecycle_event#dev:} — sh 로 돌아서 POSIX # 만 (bash 의 // 는 안 된다)

stage "dev:hello" == Just "hello"
-- 이렇게 하기보다 스크립트를 따로 쓰는 게 낫다
#213

dependencies 에서 이름은 키라 같은 이름은 한 번만 들어간다. <별칭>@npm:<이름>@<버전> 으로 설치하면 별칭이 키가 되어 같은 패키지의 여러 버전이 나란히 설치되고, 코드에서는 별칭으로 import 한다. 별칭은 내 프로젝트에만 적용되고 전이 의존성의 이름은 바꾸지 않는다.

-- dependencies 는 이름이 키 — 같은 이름은 하나뿐. 별칭을 키로 쓰면 여러 버전이 나란히
alias :: Name -> Package -> Version -> (Name, Spec)
alias a p v = (a, "npm:" ++ p ++ "@" ++ v)

-- yarn add react-tooltip-5@npm:react-tooltip@5.8.3
alias "react-tooltip-5" "react-tooltip" "5.8.3" == ("react-tooltip-5", "npm:react-tooltip@5.8.3")
-- 별칭은 내 프로젝트에만, 전이 의존성 이름은 바꾸지 않는다
#249

npm link 는 패키지 폴더를 symlink 해서 node_modules 해석·중복 React 같은 문제가 생긴다. yalc 는 패키지에서 yalc publish 하면 npm 에 올라갈 파일만 ~/.yalc 전역 저장소에 복사하고, 앱에서 yalc add 하면 그걸 .yalc 로 끌어와 의존성으로 건다. yalc push 는 저장하면서 연결된 모든 앱에 바로 반영한다 — tsup –watch –onSuccess “yalc push” 로 걸어 두면 저장할 때마다 앱이 갱신된다. .yalc 와 yalc.lock 은 gitignore 한다.

-- 로컬 패키지를 다른 프로젝트에서 바로 — npm link(symlink) 대신 파일 복사
publish = copy (filesToPublish pkg) "~/.yalc"        -- npm 에 올라갈 파일만
add m   = copy ("~/.yalc" </> m) ".yalc" >> link m   -- 앱에서
push    = publish >> mapM_ update linkedApps         -- = publish --push

-- 저장할 때마다 반영: "dev": "tsup src/index.ts --watch --onSuccess 'yalc push'"
-- 정리: yalc remove my-module && npm install
-- .gitignore: .yalc · yalc.lock
#503

npm install 실패는 원인에 따라 플래그가 다르다. Node 버전이 engines 와 안 맞는 경우 npm 은 기본이 경고(EBADENGINE)뿐이라, 막혔다면 engine-strict 가 켜진 것이니 –engine-strict=false 로 끈다. –ignore-engines 는 yarn 플래그라 npm 은 무시한다. 가장 흔한 peer dependency 충돌(예: React 18 프로젝트에 peer 가 react 16.8·17 인 react-beautiful-dnd — 실제로는 돈다)은 –legacy-peer-deps 로 peer 를 무시한다. 프로젝트 전체에 적용하려면 .npmrc 에 legacy-peer-deps=true. –force 는 마지막 수단이다.

-- npm install 이 실패하면 원인으로 플래그를 고른다
flag :: InstallError -> Flag
flag EngineMismatch = "--engine-strict=false"   -- 기본은 경고(EBADENGINE)뿐 — 막혔다면 engine-strict 가 켜진 것
                                                -- --ignore-engines 는 yarn 플래그, npm 은 무시
flag PeerConflict   = "--legacy-peer-deps"      -- 가장 흔함. peerDependencies 를 통째로 무시 (npm 3~6 처럼)
flag _              = "--force"                 -- 마지막 수단, 권장 안 함

-- peer 충돌의 전형: 공식 지원은 안 하지만 실제로는 돈다
deps = [("react", "^18.2.0"), ("react-beautiful-dnd", "^13.1.1")]   -- peer: react@^16.8 || ^17

-- 프로젝트 전체: echo "legacy-peer-deps=true" > .npmrc
#522

npm install –save ../foo/bar 처럼 로컬 디렉터리를 설치하면 package.json 에 상대 경로로 정규화되어 “bar”: “file:../foo/bar” 로 저장된다. 레지스트리를 거치지 않고 파일 시스템의 패키지를 의존성으로 건다.

-- 로컬 디렉터리를 의존성으로 — 상대 경로로 정규화되어 저장된다
dep :: Path -> (Name, Spec)
dep path = (packageName path, "file:" ++ relative path)

dep "../foo/bar" == ("bar", "file:../foo/bar")   -- npm install --save ../foo/bar
#65