PR-URL: https://github.com/nodejs/node/pull/20190 Reviewed-By: Rich Trott <rtrott@gmail.com> Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de> Reviewed-By: Tiancheng "Timothy" Gu <timothygu99@gmail.com> Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com> Reviewed-By: Michaël Zasso <targos@protonmail.com>
35 KiB
v6.1.0 (2018-05-17):
FIX WRITE AFTER END ERROR
First introduced in 5.8.0, this finally puts to bed errors where you would
occasionally see Error: write after end at MiniPass.write
.
171f3182f
node-tar#180 npm.community#35pacote@8.1.5
: Fix write-after-end errors. (@zkat)
DETECT CHANGES IN GIT SPECIFIERS
0e1726c03
We can now determine if the commitid of a git dependency in the lockfile is derived from the specifier in the package.json and if it isn't we now trigger an update for it. (@iarna)
OTHER BUGS
442d2484f
2f0c88351
631d30a34
When requesting the update of a direct dependency that was also a transitive dependency to a version incompatible with the transitive requirement and you had a lock-file but did not have anode_modules
folder then npm would fail to provide a new copy of the transitive dependency, resulting in an invalid lock-file that could not self heal. (@iarna)be5dd0f49
#20715 Cleanup output ofnpm ci
summary report. (@legodude17)98ffe4adb
Node.js now has a test that scans for things that look like conflict markers in source code. This was triggering false positives on a fixture in a test of npm's ability to heal lockfiles with conflicts in them. (@iarna)
DEPENDENCY UPDATES
3f2e306b8
Usingnpm audit fix
, replace some transitive dependencies with security issues with versions that don't have any. (@iarna)1d07134e0
tar@4.4.1
: Dropping to 4.4.1 from 4.4.2 due to https://github.com/npm/node-tar/issues/183 (@zkat)
v6.1.0-next.0 (2018-05-17):
Look at that! A feature bump! npm@6
was super-exciting not just because it
used a bigger number than ever before, but also because it included a super
shiny new command: npm audit
. Well, we've kept working on it since then and
have some really nice improvements for it. You can expect more of them, and the
occasional fix, in the next few releases as more users start playing with it and
we get more feedback about what y'all would like to see from something like
this.
I, for one, have started running it (and the new subcommand...) in all my projects, and it's one of those things that I don't know how I ever functioned -without- it! This will make a world of difference to so many people as far as making the npm ecosystem a higher-quality, safer commons for all of us.
This is also a good time to remind y'all that we have a new RFCs repository, along with a new process for them. This repo is open to anyone's RFCs, and has already received some great ideas about where we can take the CLI (and, to a certain extent, the registry). It's a great place to get feedback, and completely replaces feature requests in the main repo, so we won't be accepting feature requests there at all anymore. Check it out if you have something you'd like to suggest, or if you want to keep track of what the future might look like!
NEW FEATURE: npm audit fix
This is the biggie with this release! npm audit fix
does exactly what it says
on the tin. It takes all the actionable reports from your npm audit
and runs
the installs automatically for you, so you don't have to try to do all that
mechanical work yourself!
Note that by default, npm audit fix
will stick to semver-compatible changes,
so you should be able to safely run it on most projects and carry on with your
day without having to track down what breaking changes were included. If you
want your (toplevel) dependencies to accept semver-major bumps as well, you can
use npm audit fix --force
and it'll toss those in, as well. Since it's running
the npm installer under the hood, it also supports --production
and
--only=dev
flags, as well as things like --dry-run
, --json
, and
--package-lock-only
, if you want more control over what it does.
Give it a whirl and tell us what you think! See npm help audit
for full docs!
OTHER NEW audit
FEATURES
1854b1c7f
#20568 Add support fornpm audit --json
to print the report in JSON format. (@finnp)85b86169d
#20570 Include number of audited packages innpm install
summary output. (@zkat)957cbe275
npm-audit-report@1.2.1
: Overhaul audit install and detail output format. The new format is terser and fits more closely into the visual style of the CLI, while still providing you with the important bits of information you need. They also include a bit more detail on the footer about what actions you can take! (@zkat)
NEW FEATURE: GIT DEPS AND npm init <pkg>
!
Another exciting change that came with npm@6
was the new npm init
command
that allows for community-authored generators. That means you can, for example,
do npm init react-app
and it'll one-off download, install, and run
create-react-app
for you, without requiring
or keeping around any global installs. That is, it basically just calls out to
npx
.
The first version of this command only really supported registry dependencies, but now, @jdalton went ahead and extended this feature so you can use hosted git dependencies, and their shorthands.
So go ahead and do npm init facebook/create-react-app
and it'll grab the
package from the github repo now! Or you can use it with a private github
repository to maintain your organizational scaffolding tools or whatnot. ✨
BUGFIXES
a41c0393c
#20538 Make the newnpm view
work when the license field is an object instead of a string. (@zkat)eb7522073
#20582 Add support for environments (like Docker) where the expected binary for opening external URLs is not available. (@bcoe)212266529
#20536 Fix a spurious colon in the new update notifier message and add support for the npm canary. (@zkat)5ee1384d0
#20597 Infer a version range when apackage.json
has a dist-tag instead of a version range in one of its dependency specs. Previously, this would cause dependencies to be flagged as invalid. (@zkat)4fa68ae41
#20585 Make sure scoped bundled deps are shown in the new publish preview, too. (@zkat)1f3ee6b7e
cacache@11.0.2
: Stop droppingsize
from metadata onnpm cache verify
. (@jfmartinez)91ef93691
#20513 Fix nested command aliases. (@mmermerkaya)18b2b3cf7
npm-lifecycle@2.0.3
: Make sure different versions of thePath
env var on Windows all getnode_modules/.bin
prepended when running lifecycle scripts. (@laggingreflex)
DOCUMENTATION
a91d87072
#20550 Update required node versions in README. (@legodude17)bf3cfa7b8
Pull in changelogs from the lastnpm@5
release. (@iarna)b2f14b14c
#20629 Make tone inpublishConfig
docs more neutral. (@jeremyckahn)
DEPENDENCY BUMPS
5fca4eae8
byte-size@4.0.3
(@75lb)d9ef3fba7
lru-cache@4.1.3
(@isaacs)f1baf011a
request@2.86.0
(@simonv)005fa5420
require-inject@1.4.3
(@iarna)1becdf09a
tap@11.1.5
(@isaacs)
v6.0.1 (2018-05-09):
AUDIT SHOULDN'T WAIT FOREVER
This will likely be reduced further with the goal that the audit process shouldn't noticibly slow down your builds regardless of your network situation.
Looking forward
We're still a way from having node@11, so now's a good time to ensure we don't warn about being used with it.
v6.0.1-next.0 (2018-05-03):
CTRL-C OUT DURING PACKAGE EXTRACTION AS MUCH AS YOU WANT!
b267bbbb9
npm/lockfile#29lockfile@1.0.4
: Switches tosignal-exit
to detect abnormal exits and remove locks. (@Redsandro)
SHRONKWRAPS AND LACKFILES
If a published modules had legacy npm-shrinkwrap.json
we were saving
ordinary registry dependencies (name@version
) to your package-lock.json
as https://
URLs instead of versions.
89102c0d9
When saving the lock-file compute how the dependency is being required instead of using_resolved
in thepackage.json
. This fixes the bug that was converting registry dependencies intohttps://
dependencies. (@iarna)676f1239a
When encountering ahttps://
URL in our lockfiles that point at our default registry, extract the version and use them as registry dependencies. This lets us healpackage-lock.json
files produced by 6.0.0 (@iarna)
AUDIT AUDIT EVERYWHERE
You can't use it quite yet, but we do have a few last moment patches to npm audit
to make
it even better when it is turned on!
b2e4f48f5
Make sure we hide stream errors on background audit submissions. Previously some classes of error could end up being displayed (harmlessly) during installs. (@iarna)1fe0c7fea
Include session and scope in requests (as we do in other requests to the registry). (@iarna)d04656461
Exit with non-zero status when vulnerabilities are found. So you can havenpm audit
as a test or prepublish step! (@iarna)fcdbcbacc
Verify lockfile integrity before running. You'd get an error either way, but this way it's faster and can give you more concrete instructions on how to fix it. (@iarna)2ac8edd42
Refuse to run in global mode. Audits require a lockfile and globals don't have one. Yet. (@iarna)
DOCUMENTATION IMPROVEMENTS
b7fca1084
#20407 Update the lock-file spec doc to mention that we now generate the from field forgit
-type dependencies. (@watilde)7a6555e61
#20408 Describe what the colors in outdated mean. (@teameh)
DEPENDENCY UPDATES
5e56b3209
npm-audit-report@1.0.8
(@evilpacket)58a0b31b4
lock-verify@2.0.2
(@iarna)e7a8c364f
zkat/pacote#148pacote@8.1.1
(@redonkulus)46c0090a5
tar@4.4.2
(@isaacs)8a16db3e3
update-notifier@2.5.0
(@alexccl)696375903
safe-buffer@5.1.2
(@feross)c949eb26a
query-string@6.1.0
(@sindresorhus)
v6.0.0 (2018-04-20):
Hey y'all! Here's another npm@6
release -- with node@10
around the corner,
this might well be the last prerelease before we tag 6.0.0
! There's two major
features included with this release, along with a few miscellaneous fixes and
changes.
EXTENDED npm init
SCAFFOLDING
Thanks to the wonderful efforts of @jdalton of
lodash fame, npm init
can now be used to invoke custom scaffolding tools!
You can now do things like npm init react-app
or npm init esm
to scaffold an
npm package by running create-react-app
and create-esm
, respectively. This
also adds an npm create
alias, to correspond to Yarn's yarn create
feature,
which inspired this.
008a83642
ed81d1426
833046e45
#20303 Add annpm init
feature that calls out tonpx
when invoked with positional arguments. (@jdalton)
DEPENDENCY AUDITING
This version of npm adds a new command, npm audit
, which will run a security
audit of your project's dependency tree and notify you about any actions you may
need to take.
The registry-side services required for this command to work will be available on the main npm registry in the coming weeks. Until then, you won't get much out of trying to use this on the CLI.
As part of this change, the npm CLI now sends scrubbed and cryptographically
anonymized metadata about your dependency tree to your configured registry, to
allow notifying you about the existence of critical security flaws. For details
about how the CLI protects your privacy when it shares this metadata, see npm help audit
, or read the docs for npm audit
online. You
can disable this altogether by doing npm config set audit false
, but will no
longer benefit from the service.
f4bc648ea
#20389npm-registry-fetch@1.1.0
(@iarna)594d16987
#20389npm-audit-report@1.0.5
(@iarna)8c77dde74
1d8ac2492
552ff6d64
09c734803
#20389 Add newnpm audit
command. (@iarna)be393a290
#20389 Temporarily suppress git metadata till there's an opt-in. (@iarna)8e713344f
#20389 Document the new command. (@iarna)- #20389 Default audit to off when running the npm test suite itself. (@iarna)
MORE package-lock.json
FORMAT CHANGES?!
820f74ae2
#20384 Addfrom
field back into package-lock for git dependencies. This will give npm the information it needs to figure out whether git deps are valid, specially when running with legacy install metadata or in--package-lock-only
mode when there's nonode_modules
. This should help remove a significant amount of git-related churn on the lock-file. (@zkat)
BUGFIXES
9d5d0a18a
#20358npm install-test
(akanpm it
) will no longer generatepackage-lock.json
when running with--no-package-lock
orpackage-lock=false
. (@raymondfeng)e4ed976e2
2facb35fb
9c1eb945b
#20390 Fix a scenario where a git dependency had a comittish associated with it that was not a complete commitid.npm
would never consider that entry in thepackage.json
as matching the entry in thepackage-lock.json
and this resulted in inappropriate pruning or reinstallation of git dependencies. This has been addressed in two ways, first, the addition of thefrom
field as described in #20384 means we can exactly match thepackage.json
. Second, when that's missing (when working with olderpackage-lock.json
files), we assume that the match is ok. (If it's not, we'll fix it up when a real installation is done.) (@iarna)
DEPENDENCIES
DOCS
a1c77d614
#20331 Fix broken link to 'private-modules' page. The redirect went away when the new npm website went up, but the new URL is better anyway. (@vipranarayan14)ad7a5962d
#20279 Document the--if-present
option fornpm run-script
. (@aleclarson)
v6.0.0-next.1 (2018-04-12):
NEW FEATURES
a9e722118
#20256 Add support for managing npm webhooks. This brings over functionality previously provided by thewombat
CLI. (@zkat)8a1a64203
#20126 Addnpm cit
command that's equivalent ofnpm ci && npm t
that's equivalent ofnpm it
. (@SimenB)fe867aaf1
49d18b4d8
ff6b31f77
78eab3cda
Therequires
field in your lock-file will be upgraded to use ranges from versions on your first use of npm. (@iarna)cf4d7b4de
#20257 Add shasum and integrity to the newnpm view
output. (@zkat)
BUG FIXES
-
685764308
Fix a bug where OTPs passed in via the commandline would have leading zeros deleted resulted in authentication failures. (@iarna) -
8f3faa323
6800f76ff
ec90c06c7
825b5d2c6
4785f13fb
bd16485f5
Restore the ability to bundle dependencies that are uninstallable from the registry. This also eliminates needless registry lookups for bundled dependencies.Fixed a bug where attempting to install a dependency that is bundled inside another module without reinstalling that module would result in ENOENT errors. (@iarna)
-
429498a8c
#20029 Allow packages with non-registry specifiers to follow the fast path that the we use with the lock-file for registry specifiers. This will improve install time especially when operating only on the package-lock (--package-lock-only
). (@zkat)Fix the a bug where
npm i --only=prod
could remove development dependencies from lock-file. (@iarna) -
834b46ff4
#20122 Improve the update-notifier messaging (borrowing ideas from pnpm) and eliminate false positives. (@zkat) -
f9de7ef3a
#20154 Let version succeed whenpackage-lock.json
is gitignored. (@nwoltman) -
f8ec52073
#20212 Ensure that we only create anetc
directory if we are actually going to write files to it. (@buddydvd) -
ab489b753
#20140 Note in documentation thatpackage-lock.json
version gets touched bynpm version
. (@srl295) -
857c2138d
#20032 Fix bug where unauthenticated errors would get reported as both 404s and 401s, i.e.npm ERR! 404 Registry returned 401
. In these cases the error message will now be much more informative. (@iarna) -
d2d290bca
#20082 Allow optional @ prefix on scope withnpm team
commands for parity with other commands. (@bcoe) -
b5babf0a9
#19580 Improve messaging when two-factor authentication is required while publishing. (@jdeniau) -
471ee1c5b
0da38b7b4
Fix a bug where optional status of a dependency was not being saved to the package-lock on the initial install. (@iarna) -
b3f98d8ba
9dea95e31
Ensure that--no-optional
does not remove optional dependencies from the lock-file. (@iarna)
MISCELLANEOUS
DEPENDENCY UPDATES
73dc97455
zkat/cipm#46libcipm@1.6.2
: Detect binding.gyp for default install lifecycle. Let'snpm ci
work on projects that have their own C code. (@caleblloyd)77c3f7a00
iferr@1.0.0
dce733e37
zkat/json-parse-better-errors#1json-parse-better-errors@1.0.2
(@Hoishin)c52765ff3
readable-stream@2.3.6
(@mcollina)e160adf9f
update-notifier@2.4.0
(@sindersorhus)9a9d7809e
marked@0.3.1
(@joshbruce)f2fbd8577
#20256figgy-pudding@2.0.1
(@zkat)44972d53d
#20256libnpmhook@3.0.0
(@zkat)cfe562c58
#20276node-gyp@3.6.2
3c0bbcb8e
zkat/npx#172libnpx@10.1.1
(@jdalton)0573d91e5
zkat/cacache#128cacache@11.0.1
(@zkat)396afa99f
figgy-pudding@3.1.0
(@zkat)e7f869c36
pacote@8.0.0
(@zkat)77dac72df
ssri@6.0.0
(@zkat)0b802f2a0
retry@0.12.0
(@iarna)4781b64bc
libnpmhook@4.0.1
(@zkat)7bdbaeea6
npm-package-arg@6.1.0
(@zkat)5f2bf4222
read-package-tree@5.2.1
(@zkat)
v6.0.0-0 (2018-03-23):
Sometimes major releases are a big splash, sometimes they're something
smaller. This is the latter kind. That said, we expect to keep this in
release candidate status until Node 10 ships at the end of April. There
will likely be a few more features for the 6.0.0 release line between now
and then. We do expect to have a bigger one later this year though, so keep
an eye out for npm@7
!
BREAKING AVOID DEPRECATED
When selecting versions to install, we now avoid deprecated versions if possible. For example:
Module: example
Versions:
1.0.0
1.1.0
1.1.2
1.1.3 (deprecated)
1.2.0 (latest)
If you ask npm
to install example@~1.1.0
, npm
will now give you 1.1.2
.
By contrast, if you installed example@~1.1.3
then you'd get 1.1.3
, as
it's the only version that can match the range.
BREAKING UPDATE AND OUTDATED
When npm install
is finding a version to install, it first checks to see
if the specifier you requested matches the latest
tag. If it doesn't,
then it looks for the highest version that does. This means you can do
release candidates on tags other than latest
and users won't see them
unless they ask for them. Promoting them is as easy as setting the latest
tag to point at them.
Historically npm update
and npm outdated
worked differently. They just
looked for the most recent thing that matched the semver range, disregarding
the latest
tag. We're changing it to match npm install
's behavior.
3aaa6ef42
Make update and outdated respect latest interaction with semver as install does. (@iarna)e5fbbd2c9
npm-pick-manifest@2.1.0
(@iarna)
PLUS ONE SMALLER PATCH
Technically this is a bug fix, but the change in behavior is enough of an edge case that I held off on bringing it in until a major version.
When we extract a binary and it starts with a shebang (or "hash bang"), that is, something like:
#!/usr/bin/env node
If the file has Windows line endings we strip them off of the first line. The reason for this is that shebangs are only used in Unix-like environments and the files with them can't be run if the shebang has a Windows line ending.
Previously we converted ALL line endings from Windows to Unix. With this patch we only convert the line with the shebang. (Node.js works just fine with either set of line endings.)
814658371
7265198eb
bin-links@1.1.2
: Only rewrite the CR after a shebang (if any) when fixing up CR/LFs. (@iarna)
BREAKING SUPPORTED NODE VERSIONS
Per our supported Node.js policy, we're dropping support for both Node 4 and Node 7, which are no longer supported by the Node.js project.