138 lines
3.0 KiB
Groff
138 lines
3.0 KiB
Groff
.TH "NPM\-HOOK" "1" "February 2022" "" ""
|
|
.SH "NAME"
|
|
\fBnpm-hook\fR \- Manage registry hooks
|
|
.SS Synopsis
|
|
.P
|
|
.RS 2
|
|
.nf
|
|
npm hook ls [pkg]
|
|
npm hook add <entity> <url> <secret>
|
|
npm hook update <id> <url> [secret]
|
|
npm hook rm <id>
|
|
.fi
|
|
.RE
|
|
.P
|
|
Note: This command is unaware of workspaces\.
|
|
.SS Description
|
|
.P
|
|
Allows you to manage npm
|
|
hooks \fIhttps://blog\.npmjs\.org/post/145260155635/introducing\-hooks\-get\-notifications\-of\-npm\fR,
|
|
including adding, removing, listing, and updating\.
|
|
.P
|
|
Hooks allow you to configure URL endpoints that will be notified whenever a
|
|
change happens to any of the supported entity types\. Three different types
|
|
of entities can be watched by hooks: packages, owners, and scopes\.
|
|
.P
|
|
To create a package hook, simply reference the package name\.
|
|
.P
|
|
To create an owner hook, prefix the owner name with \fB~\fP (as in,
|
|
\fB~youruser\fP)\.
|
|
.P
|
|
To create a scope hook, prefix the scope name with \fB@\fP (as in,
|
|
\fB@yourscope\fP)\.
|
|
.P
|
|
The hook \fBid\fP used by \fBupdate\fP and \fBrm\fP are the IDs listed in \fBnpm hook ls\fP
|
|
for that particular hook\.
|
|
.P
|
|
The shared secret will be sent along to the URL endpoint so you can verify
|
|
the request came from your own configured hook\.
|
|
.SS Example
|
|
.P
|
|
Add a hook to watch a package for changes:
|
|
.P
|
|
.RS 2
|
|
.nf
|
|
$ npm hook add lodash https://example\.com/ my\-shared\-secret
|
|
.fi
|
|
.RE
|
|
.P
|
|
Add a hook to watch packages belonging to the user \fBsubstack\fP:
|
|
.P
|
|
.RS 2
|
|
.nf
|
|
$ npm hook add ~substack https://example\.com/ my\-shared\-secret
|
|
.fi
|
|
.RE
|
|
.P
|
|
Add a hook to watch packages in the scope \fB@npm\fP
|
|
.P
|
|
.RS 2
|
|
.nf
|
|
$ npm hook add @npm https://example\.com/ my\-shared\-secret
|
|
.fi
|
|
.RE
|
|
.P
|
|
List all your active hooks:
|
|
.P
|
|
.RS 2
|
|
.nf
|
|
$ npm hook ls
|
|
.fi
|
|
.RE
|
|
.P
|
|
List your active hooks for the \fBlodash\fP package:
|
|
.P
|
|
.RS 2
|
|
.nf
|
|
$ npm hook ls lodash
|
|
.fi
|
|
.RE
|
|
.P
|
|
Update an existing hook's url:
|
|
.P
|
|
.RS 2
|
|
.nf
|
|
$ npm hook update id\-deadbeef https://my\-new\-website\.here/
|
|
.fi
|
|
.RE
|
|
.P
|
|
Remove a hook:
|
|
.P
|
|
.RS 2
|
|
.nf
|
|
$ npm hook rm id\-deadbeef
|
|
.fi
|
|
.RE
|
|
.SS Configuration
|
|
<!\-\- AUTOGENERATED CONFIG DESCRIPTIONS START \-\->
|
|
<!\-\- automatically generated, do not edit manually \-\->
|
|
<!\-\- see lib/utils/config/definitions\.js \-\->
|
|
.SS \fBregistry\fP
|
|
.RS 0
|
|
.IP \(bu 2
|
|
Default: "https://registry\.npmjs\.org/"
|
|
.IP \(bu 2
|
|
Type: URL
|
|
|
|
.RE
|
|
.P
|
|
The base URL of the npm registry\.
|
|
<!\-\- automatically generated, do not edit manually \-\->
|
|
<!\-\- see lib/utils/config/definitions\.js \-\->
|
|
|
|
.SS \fBotp\fP
|
|
.RS 0
|
|
.IP \(bu 2
|
|
Default: null
|
|
.IP \(bu 2
|
|
Type: null or String
|
|
|
|
.RE
|
|
.P
|
|
This is a one\-time password from a two\-factor authenticator\. It's needed
|
|
when publishing or changing package permissions with \fBnpm access\fP\|\.
|
|
.P
|
|
If not set, and a registry response fails with a challenge for a one\-time
|
|
password, npm will prompt on the command line for one\.
|
|
<!\-\- automatically generated, do not edit manually \-\->
|
|
<!\-\- see lib/utils/config/definitions\.js \-\->
|
|
|
|
<!\-\- AUTOGENERATED CONFIG DESCRIPTIONS END \-\->
|
|
|
|
.SS See Also
|
|
.RS 0
|
|
.IP \(bu 2
|
|
"Introducing Hooks" blog post \fIhttps://blog\.npmjs\.org/post/145260155635/introducing\-hooks\-get\-notifications\-of\-npm\fR
|
|
|
|
.RE
|