Fix npm install hang fix due to npm bug

Author: aral

CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.0.1] - 2021-03-17
+
+## Fixed
+
+  - Hang during npm install due to npm bug in Auto Encrypt Localhost (AEL). Upgraded AEL to version 7.0.4 which includes a graphical sudo prompt workaround.
+
 ## [3.0.0] - 2021-03-09
 
 __Breaking change:__ ESM version. Includes Auto Encrypt 3.0.0 and Auto Encrypt Localhost 7.0.2.

README.md

@@ -36,6 +36,10 @@ Works on Linux, macOS, and Windows (WSL is not supported for certificates at loc
 npm i @small-tech/https
 ```
 
+Note that during installation, this module’s Auto Encrypt Localhost dependency will create your local certificate authority and install it in the system root store and generate locally-trusted certificates. These actions require elevated privileges (`sudo`). Since [npm does not handle sudo prompts correctly in lifecycle scripts](https://github.com/npm/cli/issues/2887), you will see a graphical sudo prompt pop up to ask you for your adminstrator password. Once you’ve provided it, installation will proceed as normal.
+
+![Screenshot of graphical sudo prompt “Authentication required: Authentication is needed to run /bin/bash as the super user”](https://small-tech.org/images/graphical-sudo-prompt.png)
+
 ## Examples
 
 ### At localhost with automatically-provisioned development certificates via mkcert.

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@small-tech/https",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "A drop-in standard Node.js HTTPS module replacement with both automatic development-time (localhost) certificates via Auto Encrypt Localhost and automatic production certificates via Auto Encrypt.",
   "main": "index.js",
   "files": [
@@ -44,7 +44,7 @@
   "license": "AGPL-3.0-or-later",
   "dependencies": {
     "@small-tech/auto-encrypt": "^3.0.0",
-    "@small-tech/auto-encrypt-localhost": "^7.0.2",
+    "@small-tech/auto-encrypt-localhost": "^7.0.4",
     "fs-extra": "^9.0.1"
   },
   "devDependencies": {