fix: monkeypatch util.debuglog() for extended console logging

the old logging functionality of gh-pages was removed in tschaub/gh-pages@380a9ae

Author: JohannesHoppe

README.md

@@ -247,9 +247,10 @@ In this case, provide **both** `name` and `email` string values to identify the
     * `ng deploy --no-silent` – Logging shows extended information.
 
 Logging is in silent mode by default.
-In silent mode, log messages are suppressed and error messages are sanitized.
+In silent mode, the error messages for git operations are always sanitized.
+(The message is always: `'Unspecified error (run without silent option for detail)'`)
 
-The `--no-silent` option enables extended console logging.
+The `--no-silent` option enables detailed error messages and extended console logging.
 Keep this untouched if the repository URL or other information passed to git commands is sensitive!
 
 > ⚠️ WARNING: This option should be kept as it is if the repository URL or other information passed to Git commands is sensitive and should not be logged (== you have a public build server and you are using the `GH_TOKEN` feature).

docs/README_standalone.md

@@ -148,12 +148,14 @@ In this case provide both `name` and `email` string values to identify the commi
     * `npx angular-cli-ghpages --no-silent` -- Logging shows extended information.
 
 Logging is in silent mode by default.
-In silent mode log messages are suppressed and error messages are sanitized.
+In silent mode, the error messages for git operations are always sanitized.
+(The message is always: `'Unspecified error (run without silent option for detail)'`)
 
-The `--no-silent` option enables extended console logging.
+The `--no-silent` option enables detailed error messages and extended console logging.
 Keep this untouched if the repository URL or other information passed to git commands is sensitive!
 
-> WARNING: This option should kept like it is if the repository URL or other information passed to git commands is sensitive and should not be logged (== you have a public build server). By default the silent mode is enabled to avoid sensitive data exposure.
+> ⚠️ WARNING: This option should be kept as it is if the repository URL or other information passed to Git commands is sensitive and should not be logged (== you have a public build server and you are using the `GH_TOKEN` feature).
+> By default the silent mode is enabled to avoid sensitive data exposure.
 
 
 #### --dir <a name="dir"></a>

src/engine/engine.ts

@@ -6,7 +6,6 @@ import { Schema } from '../deploy/schema';
 import { GHPages } from '../interfaces';
 import { defaults } from './defaults';
 
-const ghpages = require('gh-pages');
 
 export async function run(
   dir: string,
@@ -15,6 +14,9 @@ export async function run(
 ) {
   options = prepareOptions(options, logger);
 
+  // this has to occur _after_ the monkeypatch of util.debuglog:
+  const ghpages = require('gh-pages');
+
   // always clean the cache directory.
   // avoids "Error: Remote url mismatch."
   if (options.dryRun) {
@@ -23,14 +25,14 @@ export async function run(
     ghpages.clean();
   }
 
-    await checkIfDistFolderExists(dir);
-    await createNotFoundPage(dir, options, logger);
-    await createCnameFile(dir, options, logger);
-    await publishViaGhPages(ghpages, dir, options, logger);
+  await checkIfDistFolderExists(dir);
+  await createNotFoundPage(dir, options, logger);
+  await createCnameFile(dir, options, logger);
+  await publishViaGhPages(ghpages, dir, options, logger);
 
-    logger.info(
-      '🚀 Successfully published via angular-cli-ghpages! Have a nice day!'
-    );
+  logger.info(
+    '🚀 Successfully published via angular-cli-ghpages! Have a nice day!'
+  );
 }
 
 export function prepareOptions(origOptions: Schema, logger: logging.LoggerApi) {
@@ -41,6 +43,20 @@ export function prepareOptions(origOptions: Schema, logger: logging.LoggerApi) {
 
   if (origOptions.noSilent) {
     options.silent = !origOptions.noSilent;
+
+    // monkeypatch util.debuglog to get all the extra information
+    // see https://stackoverflow.com/a/39129886
+    const util = require('util');
+    let debuglog  = util.debuglog;
+    util.debuglog = set => {
+      if (set === 'gh-pages') {
+        return function() {
+          let message = util.format.apply(util, arguments);
+          logger.info(message);
+        }
+      }
+      return debuglog(set);
+    }
   }
 
   if (origOptions.noDotfiles) {
@@ -58,11 +74,6 @@ export function prepareOptions(origOptions: Schema, logger: logging.LoggerApi) {
     };
   }
 
-  // gh-pages internal: forwards messages to logger
-  options['logger'] = function(message) {
-    logger.info(message);
-  };
-
   if (process.env.TRAVIS) {
     options.message +=
       ' -- ' +