NPM-HOOK

Section: User Commands (1)
Updated: December 2022
Index Return to Main Contents
 

NAME

npm-hook  

Synopsis

<!-- AUTOGENERATED USAGE DESCRIPTIONS -->

Note: This command is unaware of workspaces.  

Description

Allows you to manage npm
hooks,
including adding, removing, listing, and updating.

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.

To create a package hook, simply reference the package name.

To create an owner hook, prefix the owner name with ~ (as in,
~youruser).

To create a scope hook, prefix the scope name with @ (as in,
@yourscope).

The hook id used by update and rm are the IDs listed in npm hook ls
for that particular hook.

The shared secret will be sent along to the URL endpoint so you can verify
the request came from your own configured hook.  

Example

Add a hook to watch a package for changes:

$ npm hook add lodash https://example.com/ my-shared-secret

Add a hook to watch packages belonging to the user substack:

$ npm hook add ~substack https://example.com/ my-shared-secret

Add a hook to watch packages in the scope @npm

$ npm hook add @npm https://example.com/ my-shared-secret

List all your active hooks:

$ npm hook ls

List your active hooks for the lodash package:

$ npm hook ls lodash

Update an existing hook's url:

$ npm hook update id-deadbeef https://my-new-website.here/

Remove a hook:

$ npm hook rm id-deadbeef
 

Configuration

<!-- AUTOGENERATED CONFIG DESCRIPTIONS -->

 

See Also

"Introducing Hooks" blog post


 

Index

NAME
Synopsis
Description
Example
Configuration
See Also

This document was created by man2html, using the manual pages.
Time: 14:50:54 GMT, April 27, 2024