[Spike] Investigate publish lifecycle scripts

[darcyclarke]

Problem statement

Looks like these are improperly document &/or implemented today...

Exit criteria

• understanding of & improved documentation of npm publish lifecycle scripts

[wraithgar]

Still need to note which events only run on 'directory' spec type and what that means.

npm event lifecycle

cache add
  - prepare
ci
  - preinstall
  - install
  - postinstall
  - prepublish
  - preprepare
  - prepare
  - postprepare
diff
  - prepare
env
  - env (which is overwritten during env to a custom script)
exec
  - npx
explore
  - _explore (which is overwritten during explore to a custom script)
install (and install <pkg-name> -g)
  - preinstall
  - install
  - postinstall
  - prepublish
  - preprepare
  - prepare
  - postprepare
pack
  - prepack
  - prepare
  - postpack
publish
  - prepublishOnly
  - prepack
  - prepare (not during dry-run)
  - postpack
  - publish
  - postpublish
rebuild (all are run in background unless --foreground-scripts is set)
  - preinstall
  - install
  - postinstall
  - prepare (links only)
restart
  - restart (if there is no restart, stop is run if it is present, then start is run no matter what)
run <user defined>
  - pre<user defined>
  - <user defined>
  - post<user defined>
stop
  - stop
start
  - start
test
  - test
version
  - preversion
  - version
  - postversion


prepare is also potentially run during:
  - update
  - link
  - uninstall <package-name>
  - prune
  - install <package-name>

[wraithgar]

Looks like rebuild got missed here somehow.