nodexh 1.1.0 → 2.1.0

package/README.md

@@ -56,4 +56,9 @@ Use `nodexh path/to/file.js` instead of `node path/to/file.js`, and you're good
 * [ ] fix async stacktraces (probably not yet handled correctly; might be issue with `stackman`?)
 * [ ] consider [utf8ize-sourcemaps](https://github.com/twada/utf8ize-sourcemaps) in case there should be
   problems w/ 32bit characters
+* [ ] truncate long lines in context
+* [ ] offer capabilities of NodeXH as API so applications (such as test libraries) can easily retrieve
+  source code, display source lines with contexts
+
+
 

package/bin/nodexh

@@ -1,3 +1,29 @@
 #!/usr/bin/env bash
-node --require "$(realpath "$0")"/../../lib/main.js --trace-warnings --enable-source-maps --stack-trace-limit=100 "$@"
+
+realpath() {
+  # thx to https://github.com/whatwg/html-build/issues/90
+  OURPWD=$PWD
+  cd "$(dirname "$1")"
+  LINK=$(readlink "$(basename "$1")")
+  while [ "$LINK" ]; do
+    cd "$(dirname "$LINK")"
+    LINK=$(readlink "$(basename "$1")")
+  done
+  REALPATH="$PWD/$(basename "$1")"
+  cd "$OURPWD"
+  echo "$REALPATH"
+}
+
+node                                              \
+  --require "$(realpath "$0")"/../../lib/main.js  \
+  --trace-warnings                                \
+  --enable-source-maps                            \
+  --stack-trace-limit=100                         \
+  --expose-gc                                     \
+  "$@"
+  # --nouse_idle_notification                       \
+  # --trace_gc                                      \
+
+
+
 

package/lib/main.js

@@ -1,6 +1,6 @@
 (function() {
   'use strict';
-  var CND, FS, PATH, alert, badge, bold, cyan, debug, echo, exit_handler, fetch_mapped_location, get_context, get_error_callsites, gold, green, grey, help, info, load_source_map, log, red, reverse, rpr, show_error_with_source_context, steel, underline, urge, warn, whisper, white, write_to_stderr, yellow;
+  var CND, FS, PATH, _get_context, alert, badge, bold, cyan, debug, echo, exit_handler, fetch_mapped_location, get_context, get_error_callsites, get_stacktracey, gold, green, grey, help, info, load_source_map, log, red, reverse, rpr, show_error_with_source_context, show_stacktracey, steel, underline, urge, warn, whisper, white, write_to_stderr, yellow;
 
   //###########################################################################################################
   CND = require('cnd');
@@ -57,7 +57,8 @@
       });
     } catch (error1) {
       error = error1;
-      warn('^7763-3^', "!!!!!!!!!!!!!!!!!", error.message);
+      // warn '^7763-3^', "!!!!!!!!!!!!!!!!!", { path, }
+      // warn '^7763-3^', "!!!!!!!!!!!!!!!!!", error.message
       return {path, linenr, colnr};
     }
     //.........................................................................................................
@@ -75,57 +76,62 @@
 
   //-----------------------------------------------------------------------------------------------------------
   get_context = function(path, linenr, colnr, width) {
-    var R, c0, c1, coldelta, delta, effect, error, first_idx, hilite, i, idx, last_idx, len, line, lines, ref, this_linenr, this_linenr_txt, width2;
+    var error;
     try {
-      //.........................................................................................................
-      lines = (FS.readFileSync(path, {
-        encoding: 'utf-8'
-      })).split('\n');
-      delta = 1;
-      coldelta = 5;
-      /* TAINT use more meaningful limit like n times the terminal width, assuming default of 100 */
-      // effect    = underline
-      // effect    = bold
-      effect = reverse;
-      first_idx = Math.max(0, linenr - 1 - delta);
-      last_idx = Math.min(lines.length - 1, linenr - 1 + delta);
-      R = [];
-      ref = lines.slice(first_idx, +last_idx + 1 || 9e9);
-      for (idx = i = 0, len = ref.length; i < len; idx = ++i) {
-        line = ref[idx];
-        this_linenr = first_idx + idx + 1;
-        this_linenr_txt = (this_linenr.toString().padStart(4)) + '│ ';
-        if (this_linenr === linenr) {
-          c0 = colnr - 1;
-          c1 = colnr + coldelta;
-          hilite = effect(line.slice(c0, c1));
-          line = line.slice(0, c0) + hilite + line.slice(c1);
-          if (c1 > width) {
-            width2 = Math.floor(width / 2);
-            line = '... ' + line.slice(c1 - width2, +(c1 + hilite.length - (c1 - c0) + width2) + 1 || 9e9) + ' ...';
-          } else {
-            line = line.slice(0, +width + 1 || 9e9);
-          }
-          R.push(`${grey(this_linenr_txt)}${cyan(line)}`);
-        } else {
-          R.push(`${grey(this_linenr_txt)}${grey(line)}`);
-        }
-      }
+      return _get_context(path, linenr, colnr, width);
     } catch (error1) {
-      // R = R.join '\n'
       error = error1;
       if (error.code !== 'ENOENT') {
         throw error;
       }
-      return [];
     }
-    // return [ ( red "!!! #{rpr error.message} !!!" ), ]
+    return [];
+  };
+
+  //-----------------------------------------------------------------------------------------------------------
+  // return [ ( red "!!! #{rpr error.message} !!!" ), ]
+  _get_context = function(path, linenr, colnr, width) {
+    /* TAINT perform line length adjustment, hiliting in dedicated method */
+    var R, c0, c1, coldelta, delta, effect, first_idx, hilite, i, idx, last_idx, len, line, lines, ref, this_linenr, this_linenr_txt, width2;
+    lines = (FS.readFileSync(path, {
+      encoding: 'utf-8'
+    })).split('\n');
+    delta = 1;
+    coldelta = 5;
+    effect = reverse;
+    first_idx = Math.max(0, linenr - 1 - delta);
+    last_idx = Math.min(lines.length - 1, linenr - 1 + delta);
+    R = [];
+    ref = lines.slice(first_idx, +last_idx + 1 || 9e9);
+    for (idx = i = 0, len = ref.length; i < len; idx = ++i) {
+      line = ref[idx];
+      this_linenr = first_idx + idx + 1;
+      this_linenr_txt = (this_linenr.toString().padStart(4)) + '│ ';
+      if (this_linenr !== linenr) {
+        /* TAINT should adjust overlong context lines as well */
+        R.push(`${grey(this_linenr_txt)}${grey(line)}`);
+        continue;
+      }
+      c0 = colnr - 1;
+      c1 = colnr + coldelta;
+      hilite = effect(line.slice(c0, c1));
+      line = line.slice(0, c0) + hilite + line.slice(c1);
+      if (c1 > width) {
+        width2 = Math.floor(width / 2);
+        line = '... ' + line.slice(c1 - width2, +(c1 + hilite.length - (c1 - c0) + width2) + 1 || 9e9) + ' ...';
+      } else {
+        line = line.slice(0, +width + 1 || 9e9);
+      }
+      R.push(`${grey(this_linenr_txt)}${cyan(line)}`);
+    }
+    // R = R.join '\n'
     return R;
   };
 
   //-----------------------------------------------------------------------------------------------------------
   show_error_with_source_context = async function(error, headline) {
-    var arrowhead, arrowshaft, callsite, callsites, colnr, context_line, i, j, len, len1, linenr, path, ref, relpath, width;
+    /* TAINT use proper methods to format with multiple colors */
+    var arrowhead, arrowshaft, callsite, callsites, colnr, context_line, fname, fname_txt, i, j, len, len1, linenr, path, ref, ref1, ref2, relpath, width, width1;
     /* From https://github.com/watson/stackman#gotchas: "This module works because V8 (the JavaScript engine
          behind Node.js) allows us to hook into the stack trace generator function before that stack trace is
          generated. It's triggered by accessing the .stack property on the Error object, so please don't do
@@ -137,7 +143,7 @@
     callsites = get_error_callsites(error);
     //.........................................................................................................
     if ((callsites == null) || (callsites.length === 0)) {
-      write_to_stderr(CND.red(CND.reverse("error has no associated callsites:")));
+      write_to_stderr(CND.red(CND.reverse("^455756^ error has no associated callsites:")));
       write_to_stderr(CND.red(CND.reverse(rpr(error))));
       return null;
     }
@@ -156,48 +162,135 @@
       linenr = callsite.getLineNumber();
       colnr = callsite.getColumnNumber();
       //.......................................................................................................
-      if (path.startsWith('internal/')) {
-        write_to_stderr(arrowhead, grey(`${path} #${linenr}`));
+      if ((path.startsWith('node:internal/')) || (path.startsWith('internal/'))) {
+        write_to_stderr(arrowhead, grey(`${path} @ ${linenr},${colnr}`));
         continue;
       }
       //.......................................................................................................
-      // debug '^344463^', { relpath, linenr, colnr, }
       // write_to_stderr()
       // write_to_stderr steel bold reverse ( "#{relpath} ##{linenr}:" ).padEnd 108
+      fname = (ref = (ref1 = callsite.getFunctionName()) != null ? ref1 : callsite.getMethodName()) != null ? ref : null;
       ({path, linenr, colnr} = (await fetch_mapped_location(path, linenr, colnr)));
       relpath = PATH.relative(process.cwd(), path);
-      write_to_stderr(arrowhead, gold(`${relpath} @ ${linenr},${colnr}: \x1b[38;05;234m`.padEnd(width, '—')));
-      ref = (await get_context(path, linenr, colnr, width));
-      for (j = 0, len1 = ref.length; j < len1; j++) {
-        context_line = ref[j];
+      if (fname != null) {
+        fname_txt = steel(fname);
+        width1 = width + (fname_txt.length - fname.length);
+        write_to_stderr(arrowhead, gold(`${relpath} @ ${linenr},${colnr}: ${fname_txt}() \x1b[38;05;234m`.padEnd(width1, '—')));
+      } else {
+        write_to_stderr(arrowhead, gold(`${relpath} @ ${linenr},${colnr}: \x1b[38;05;234m`.padEnd(width, '—')));
+      }
+      ref2 = (await get_context(path, linenr, colnr, width));
+      for (j = 0, len1 = ref2.length; j < len1; j++) {
+        context_line = ref2[j];
         write_to_stderr(arrowshaft, context_line);
       }
     }
     alert('^77765-2^', reverse(bold(headline)));
-    // if error?.message?
+    // urge "^94843^ error.stack:", rpr error.stack
+    // urge "^94843^ error.message:", rpr error.message
+    // urge "^94843^ error.code:", rpr error.code
+    // urge "^94843^ error.name:", rpr error.name
+    // urge "^94843^ error.type:", rpr error.type
+    // urge "^94843^ error.toString():", rpr error.toString()
+    // urge "^94843^ error:", rpr error
+    // CATALOGUING = require '../../multimix/lib/cataloguing'
+    // urge "^94843^", ( CATALOGUING.all_keys_of error )
     return null;
   };
 
   //-----------------------------------------------------------------------------------------------------------
-  exit_handler = async function(error) {
-    var message, ref;
-    message = ' EXCEPTION: ' + ((ref = error != null ? error.message : void 0) != null ? ref : "an unrecoverable condition occurred");
+  exit_handler = async function(error, origin) {
+    var message, ref, ref1, ref2, type;
+    /* TAINT origin never used */
+    // show_stacktracey error
+    // debug '^4488^', error
+    // debug '^4488^', await origin
+    // return null
+    type = (ref = (ref1 = error.code) != null ? ref1 : error.name) != null ? ref : 'EXCEPTION';
+    message = ` ${type}: ` + ((ref2 = error != null ? error.message : void 0) != null ? ref2 : "an unrecoverable condition occurred");
     await show_error_with_source_context(error, message);
     setImmediate((function() {
       return process.exit(111);
     }));
-    // process.exit 111
     return null;
   };
 
+  //###########################################################################################################
+  //###########################################################################################################
+  //###########################################################################################################
+  get_stacktracey = function(error) {
+    var R, StackTracey, d, i, idx, ref, s, stack;
+    StackTracey = require('stacktracey');
+    stack = (new StackTracey(error)).withSources();
+    // stack = stack.clean()
+    R = [];
+    for (idx = i = ref = stack.items.length - 1; i >= 0; idx = i += -1) {
+      d = stack.items[idx];
+      // debug '^2798^', ( k for k of d )
+      s = {
+        // target_path:    d.file
+        relpath: d.fileRelative, // fileShort
+        native: d.native,
+        // is_nodejs:      d.native
+        is_other: d.thirdParty,
+        line: d.line,
+        column: d.column,
+        source: d.sourceLine,
+        error: d.error
+      };
+      // for k in [ 'sourceLine', 'native', 'file', 'line', 'column', 'calleeShort', 'fileRelative', 'fileShort', 'fileName', 'thirdParty', 'name',]
+      //   debug k, rpr d[ k ]
+      R.push(s);
+    }
+    // info '\n' + stack.asTable()
+    return R;
+  };
+
+  show_stacktracey = function(error) {
+    var d, i, len, ref, ref1;
+    ref = get_stacktracey(error);
+    for (i = 0, len = ref.length; i < len; i++) {
+      d = ref[i];
+      echo(CND.steel('^44872^ ' + `${d.relpath} @ ${d.line}:${d.column}`));
+      /* NOTE errors:
+           ENOENT: no such file or directory
+           EISDIR: illegal operation on a directory, read
+           'Cannot read property 'originalPositionFor' of undefined'
+         */
+      if (d.error != null) {
+        echo(CND.red('^44873^ ' + ((ref1 = d.error.message) != null ? ref1 : "an error occurred")));
+      } else {
+        echo(CND.yellow('^44874^ ' + `${rpr(d.source.slice(0, 101))}`));
+      }
+    }
+    return null;
+  };
+
+  //###########################################################################################################
+  //###########################################################################################################
+  //###########################################################################################################
+
   //###########################################################################################################
   if (global[Symbol.for('cnd-exception-handler')] == null) {
+    null;
     global[Symbol.for('cnd-exception-handler')] = true;
-    process.on('uncaughtException', exit_handler);
-    process.on('unhandledRejection', exit_handler);
+    process.once('uncaughtException', exit_handler);
+    process.once('unhandledRejection', exit_handler);
   }
 
-  /*
+  // do =>
+// process.stderr.on 'data', ( data ) => debug "^6863-1^ (stderr.on 'data'):", rpr data
+// process.stdout.on 'data', ( data ) => debug "^6863-2^ (stdout.on 'data'):", rpr data
+// process.stderr.on 'end', => debug "^6863-1^ (stderr.on 'end')"
+// process.stdout.on 'end', => debug "^6863-2^ (stdout.on 'end')"
+// debug '^6456^'
+// echo "^4564^ echo to stdout"
+// warn "^4564^ warn to stderr"
+// process.stderr.write "this goes to stderr\n"
+// process.stdout.write "this goes to stdout\n"
+// process.on 'message', ( message ) -> debug "^6863-3^' (process.on 'message'):", rpr message
+// process.on 'warning', ( warning ) -> debug "^6863-3^' (process.on 'warning'):", rpr warning
+/*
 callsite.getThis() - returns the value of this
 callsite.getTypeName() - returns the type of this as a string. This is the name of the function stored in the constructor field of this, if available, otherwise the object's [[Class]] internal property.
 callsite.getFunction() - returns the current function

package/lib/main.js.map

@@ -6,8 +6,8 @@
     "../src/main.coffee"
   ],
   "names": [],
-  "mappings": "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",
+  "mappings": "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",
   "sourcesContent": [
-    "\n\n'use strict'\n\n\n############################################################################################################\nCND                       = require 'cnd'\nrpr                       = CND.rpr\nbadge                     = 'nodexh'\nlog                       = CND.get_logger 'plain',     badge\ndebug                     = CND.get_logger 'debug',     badge\ninfo                      = CND.get_logger 'info',      badge\nwarn                      = CND.get_logger 'warn',      badge\nalert                     = CND.get_logger 'alert',      badge\nhelp                      = CND.get_logger 'help',      badge\nurge                      = CND.get_logger 'urge',      badge\nwhisper                   = CND.get_logger 'whisper',   badge\necho                      = CND.echo.bind CND\n# stackman                  = ( require 'stackman' )()\nget_error_callsites       = require 'error-callsites'\nload_source_map           = ( require 'util' ).promisify ( require 'load-source-map' )\nFS                        = require 'fs'\nPATH                      = require 'path'\n{ red\n  green\n  steel\n  grey\n  cyan\n  bold\n  gold\n  white\n  yellow\n  reverse\n  underline\n  bold }                  = CND\n# types                     = new ( require '../../intertype' ).Intertype()\n# { isa }                   = types.export()\n\n#-----------------------------------------------------------------------------------------------------------\nwrite_to_stderr = ( P... ) -> process.stderr.write ' ' + CND.pen P...\n\n#-----------------------------------------------------------------------------------------------------------\nfetch_mapped_location = ( path, linenr, colnr ) ->\n  try\n    sourcemap = await load_source_map path\n    smp       = sourcemap.originalPositionFor { line: linenr, column: colnr, }\n  catch error\n    warn '^7763-3^', \"!!!!!!!!!!!!!!!!!\", error.message\n    return { path, linenr, colnr, }\n  #.........................................................................................................\n  if ( smp? ) and ( smp.source? ) and ( smp.source isnt '' ) and ( smp.line? ) and ( smp.column? )\n    mapped_path = PATH.join ( PATH.dirname path ), smp.source\n    return { path: mapped_path, linenr: smp.line, colnr: smp.column, }\n  #.........................................................................................................\n  return { path, linenr, colnr, }\n\n#-----------------------------------------------------------------------------------------------------------\nget_context = ( path, linenr, colnr, width ) ->\n  #.........................................................................................................\n  try\n    lines     = ( FS.readFileSync path, { encoding: 'utf-8' } ).split '\\n'\n    delta     = 1\n    coldelta  = 5\n    ### TAINT use more meaningful limit like n times the terminal width, assuming default of 100 ###\n    # effect    = underline\n    # effect    = bold\n    effect    = reverse\n    first_idx = Math.max 0, linenr - 1 - delta\n    last_idx  = Math.min lines.length - 1, linenr - 1 + delta\n    R         = []\n    for line, idx in lines[ first_idx .. last_idx ]\n      this_linenr     = first_idx + idx + 1\n      this_linenr_txt = ( this_linenr.toString().padStart 4 ) + '│ '\n      if this_linenr is linenr\n        c0      = colnr - 1\n        c1      = colnr + coldelta\n        hilite  = effect line[ c0 ... c1 ]\n        line    = line[ ... c0 ] + hilite + line[ c1 .. ]\n        if c1 > width\n          width2  = Math.floor width / 2\n          line    = '... ' + line[ c1 - width2 .. c1 + hilite.length - ( c1 - c0 ) + width2 ] + ' ...'\n        else\n          line  = line[ .. width ]\n        R.push  \"#{grey this_linenr_txt}#{cyan line}\"\n      else\n        R.push  \"#{grey this_linenr_txt}#{grey line}\"\n    # R = R.join '\\n'\n  catch error\n    throw error unless error.code is 'ENOENT'\n    # return [ ( red \"!!! #{rpr error.message} !!!\" ), ]\n    return []\n  return R\n\n#-----------------------------------------------------------------------------------------------------------\nshow_error_with_source_context = ( error, headline ) ->\n  ### From https://github.com/watson/stackman#gotchas: \"This module works because V8 (the JavaScript engine\n      behind Node.js) allows us to hook into the stack trace generator function before that stack trace is\n      generated. It's triggered by accessing the .stack property on the Error object, so please don't do\n      that before parsing the error to stackman, else this will not work!\" ###\n  alert '^77765-1^', reverse bold headline\n  arrowhead   = white '▲'\n  arrowshaft  = white '│'\n  width       = process.stdout.columns\n  callsites   = get_error_callsites error\n  #.........................................................................................................\n  if ( not callsites? ) or ( callsites.length is 0 )\n    write_to_stderr CND.red CND.reverse \"error has no associated callsites:\"\n    write_to_stderr CND.red CND.reverse rpr error\n    return null\n  #.........................................................................................................\n  callsites.reverse()\n  #.........................................................................................................\n  for callsite in callsites\n    path = callsite.getFileName()\n    #.......................................................................................................\n    unless path?\n      write_to_stderr grey '—'.repeat 108\n      continue\n    #.......................................................................................................\n    linenr      = callsite.getLineNumber()\n    colnr       = callsite.getColumnNumber()\n    #.......................................................................................................\n    if path.startsWith 'internal/'\n      write_to_stderr arrowhead, grey \"#{path} ##{linenr}\"\n      continue\n    #.......................................................................................................\n    # debug '^344463^', { relpath, linenr, colnr, }\n    # write_to_stderr()\n    # write_to_stderr steel bold reverse ( \"#{relpath} ##{linenr}:\" ).padEnd 108\n    { path\n      linenr\n      colnr   } = await fetch_mapped_location path, linenr, colnr\n    relpath     = PATH.relative process.cwd(), path\n    write_to_stderr arrowhead, gold ( \"#{relpath} @ #{linenr},#{colnr}: \\x1b[38;05;234m\".padEnd width, '—' )\n    for context_line in await get_context path, linenr, colnr, width\n      write_to_stderr arrowshaft, context_line\n  alert '^77765-2^', reverse bold headline\n  # if error?.message?\n  return null\n\n#-----------------------------------------------------------------------------------------------------------\nexit_handler = ( error ) ->\n  message = ' EXCEPTION: ' + ( error?.message ? \"an unrecoverable condition occurred\" )\n  await show_error_with_source_context error, message\n  setImmediate ( -> process.exit 111 )\n  # process.exit 111\n  return null\n\n\n\n############################################################################################################\nunless global[ Symbol.for 'cnd-exception-handler' ]?\n  global[ Symbol.for 'cnd-exception-handler' ] = true\n  process.on 'uncaughtException',  exit_handler\n  process.on 'unhandledRejection', exit_handler\n\n###\ncallsite.getThis() - returns the value of this\ncallsite.getTypeName() - returns the type of this as a string. This is the name of the function stored in the constructor field of this, if available, otherwise the object's [[Class]] internal property.\ncallsite.getFunction() - returns the current function\ncallsite.getFunctionName() - returns the name of the current function, typically its name property. If a name property is not available an attempt will be made to try to infer a name from the function's context.\ncallsite.getMethodName() - returns the name of the property of this or one of its prototypes that holds the current function\ncallsite.getFileName() - if this function was defined in a script returns the name of the script\ncallsite.getLineNumber() - if this function was defined in a script returns the current line number\ncallsite.getColumnNumber() - if this function was defined in a script returns the current column number\ncallsite.getEvalOrigin() - if this function was created using a call to eval returns a CallSite object representing the location where eval was called\ncallsite.isToplevel() - is this a toplevel invocation, that is, is this the global object?\ncallsite.isEval() - does this call take place in code defined by a call to eval?\ncallsite.isNative() - is this call in native V8 code?\ncallsite.isConstructor() - is this a constructor c\n###\n\n"
+    "\n\n'use strict'\n\n\n############################################################################################################\nCND                       = require 'cnd'\nrpr                       = CND.rpr\nbadge                     = 'nodexh'\nlog                       = CND.get_logger 'plain',     badge\ndebug                     = CND.get_logger 'debug',     badge\ninfo                      = CND.get_logger 'info',      badge\nwarn                      = CND.get_logger 'warn',      badge\nalert                     = CND.get_logger 'alert',      badge\nhelp                      = CND.get_logger 'help',      badge\nurge                      = CND.get_logger 'urge',      badge\nwhisper                   = CND.get_logger 'whisper',   badge\necho                      = CND.echo.bind CND\n# stackman                  = ( require 'stackman' )()\nget_error_callsites       = require 'error-callsites'\nload_source_map           = ( require 'util' ).promisify ( require 'load-source-map' )\nFS                        = require 'fs'\nPATH                      = require 'path'\n{ red\n  green\n  steel\n  grey\n  cyan\n  bold\n  gold\n  white\n  yellow\n  reverse\n  underline\n  bold }                  = CND\n# types                     = new ( require '../../intertype' ).Intertype()\n# { isa }                   = types.export()\n\n#-----------------------------------------------------------------------------------------------------------\nwrite_to_stderr = ( P... ) -> process.stderr.write ' ' + CND.pen P...\n\n#-----------------------------------------------------------------------------------------------------------\nfetch_mapped_location = ( path, linenr, colnr ) ->\n  try\n    sourcemap = await load_source_map path\n    smp       = sourcemap.originalPositionFor { line: linenr, column: colnr, }\n  catch error\n    # warn '^7763-3^', \"!!!!!!!!!!!!!!!!!\", { path, }\n    # warn '^7763-3^', \"!!!!!!!!!!!!!!!!!\", error.message\n    return { path, linenr, colnr, }\n  #.........................................................................................................\n  if ( smp? ) and ( smp.source? ) and ( smp.source isnt '' ) and ( smp.line? ) and ( smp.column? )\n    mapped_path = PATH.join ( PATH.dirname path ), smp.source\n    return { path: mapped_path, linenr: smp.line, colnr: smp.column, }\n  #.........................................................................................................\n  return { path, linenr, colnr, }\n\n#-----------------------------------------------------------------------------------------------------------\nget_context = ( path, linenr, colnr, width ) ->\n  try return ( _get_context path, linenr, colnr, width ) catch error\n    throw error unless error.code is 'ENOENT'\n    # return [ ( red \"!!! #{rpr error.message} !!!\" ), ]\n  return []\n\n#-----------------------------------------------------------------------------------------------------------\n_get_context = ( path, linenr, colnr, width ) ->\n  lines     = ( FS.readFileSync path, { encoding: 'utf-8' } ).split '\\n'\n  delta     = 1\n  coldelta  = 5\n  effect    = reverse\n  first_idx = Math.max 0, linenr - 1 - delta\n  last_idx  = Math.min lines.length - 1, linenr - 1 + delta\n  R         = []\n  for line, idx in lines[ first_idx .. last_idx ]\n    this_linenr     = first_idx + idx + 1\n    this_linenr_txt = ( this_linenr.toString().padStart 4 ) + '│ '\n    if this_linenr isnt linenr\n      ### TAINT should adjust overlong context lines as well ###\n      R.push  \"#{grey this_linenr_txt}#{grey line}\"\n      continue\n    ### TAINT perform line length adjustment, hiliting in dedicated method ###\n    c0      = colnr - 1\n    c1      = colnr + coldelta\n    hilite  = effect line[ c0 ... c1 ]\n    line    = line[ ... c0 ] + hilite + line[ c1 .. ]\n    if c1 > width\n      width2  = Math.floor width / 2\n      line    = '... ' + line[ c1 - width2 .. c1 + hilite.length - ( c1 - c0 ) + width2 ] + ' ...'\n    else\n      line  = line[ .. width ]\n    R.push  \"#{grey this_linenr_txt}#{cyan line}\"\n  # R = R.join '\\n'\n  return R\n\n#-----------------------------------------------------------------------------------------------------------\nshow_error_with_source_context = ( error, headline ) ->\n  ### From https://github.com/watson/stackman#gotchas: \"This module works because V8 (the JavaScript engine\n      behind Node.js) allows us to hook into the stack trace generator function before that stack trace is\n      generated. It's triggered by accessing the .stack property on the Error object, so please don't do\n      that before parsing the error to stackman, else this will not work!\" ###\n  alert '^77765-1^', reverse bold headline\n  arrowhead   = white '▲'\n  arrowshaft  = white '│'\n  width       = process.stdout.columns\n  callsites   = get_error_callsites error\n  #.........................................................................................................\n  if ( not callsites? ) or ( callsites.length is 0 )\n    write_to_stderr CND.red CND.reverse \"^455756^ error has no associated callsites:\"\n    write_to_stderr CND.red CND.reverse rpr error\n    return null\n  #.........................................................................................................\n  callsites.reverse()\n  #.........................................................................................................\n  for callsite in callsites\n    path = callsite.getFileName()\n    #.......................................................................................................\n    unless path?\n      write_to_stderr grey '—'.repeat 108\n      continue\n    #.......................................................................................................\n    linenr      = callsite.getLineNumber()\n    colnr       = callsite.getColumnNumber()\n    #.......................................................................................................\n    if ( path.startsWith 'node:internal/' ) or ( path.startsWith 'internal/' )\n      write_to_stderr arrowhead, grey \"#{path} @ #{linenr},#{colnr}\"\n      continue\n    #.......................................................................................................\n    # write_to_stderr()\n    # write_to_stderr steel bold reverse ( \"#{relpath} ##{linenr}:\" ).padEnd 108\n    fname = callsite.getFunctionName() ? callsite.getMethodName() ? null\n    { path\n      linenr\n      colnr   } = await fetch_mapped_location path, linenr, colnr\n    relpath     = PATH.relative process.cwd(), path\n    if fname?\n      ### TAINT use proper methods to format with multiple colors ###\n      fname_txt = steel fname\n      width1    = width + ( fname_txt.length - fname.length )\n      write_to_stderr arrowhead, gold ( \"#{relpath} @ #{linenr},#{colnr}: #{fname_txt}() \\x1b[38;05;234m\".padEnd width1, '—' )\n    else\n      write_to_stderr arrowhead, gold ( \"#{relpath} @ #{linenr},#{colnr}: \\x1b[38;05;234m\".padEnd width, '—' )\n    for context_line in await get_context path, linenr, colnr, width\n      write_to_stderr arrowshaft, context_line\n  alert '^77765-2^', reverse bold headline\n  # urge \"^94843^ error.stack:\", rpr error.stack\n  # urge \"^94843^ error.message:\", rpr error.message\n  # urge \"^94843^ error.code:\", rpr error.code\n  # urge \"^94843^ error.name:\", rpr error.name\n  # urge \"^94843^ error.type:\", rpr error.type\n  # urge \"^94843^ error.toString():\", rpr error.toString()\n  # urge \"^94843^ error:\", rpr error\n  # CATALOGUING = require '../../multimix/lib/cataloguing'\n  # urge \"^94843^\", ( CATALOGUING.all_keys_of error )\n  return null\n\n#-----------------------------------------------------------------------------------------------------------\nexit_handler = ( error, origin ) ->\n  ### TAINT origin never used ###\n  # show_stacktracey error\n  # debug '^4488^', error\n  # debug '^4488^', await origin\n  # return null\n  type    = error.code ? error.name ? 'EXCEPTION'\n  message = \" #{type}: \" + ( error?.message ? \"an unrecoverable condition occurred\" )\n  await show_error_with_source_context error, message\n  setImmediate ( -> process.exit 111 )\n  return null\n\n############################################################################################################\n############################################################################################################\n############################################################################################################\n\nget_stacktracey = ( error ) ->\n  StackTracey               = require 'stacktracey'\n  stack = ( new StackTracey error ).withSources()\n  # stack = stack.clean()\n  R     = []\n  for idx in [ stack.items.length - 1 .. 0 ] by -1\n    d = stack.items[ idx ]\n    # debug '^2798^', ( k for k of d )\n    s =\n      # target_path:    d.file\n      relpath:        d.fileRelative # fileShort\n      native:         d.native\n      # is_nodejs:      d.native\n      is_other:       d.thirdParty\n      line:           d.line\n      column:         d.column\n      source:         d.sourceLine\n      error:          d.error\n    # for k in [ 'sourceLine', 'native', 'file', 'line', 'column', 'calleeShort', 'fileRelative', 'fileShort', 'fileName', 'thirdParty', 'name',]\n    #   debug k, rpr d[ k ]\n    R.push s\n  # info '\\n' + stack.asTable()\n  return R\n\nshow_stacktracey = ( error ) ->\n  for d in get_stacktracey error\n    echo CND.steel '^44872^ ' + \"#{d.relpath} @ #{d.line}:#{d.column}\"\n    ### NOTE errors:\n      ENOENT: no such file or directory\n      EISDIR: illegal operation on a directory, read\n      'Cannot read property 'originalPositionFor' of undefined'\n    ###\n    if d.error? then  echo CND.red    '^44873^ ' + ( d.error.message ? \"an error occurred\" )\n    else              echo CND.yellow '^44874^ ' + \"#{rpr d.source[ .. 100 ]}\"\n  return null\n\n############################################################################################################\n############################################################################################################\n############################################################################################################\n\n\n############################################################################################################\nunless global[ Symbol.for 'cnd-exception-handler' ]?\n  null\n  global[ Symbol.for 'cnd-exception-handler' ] = true\n  process.once 'uncaughtException',  exit_handler\n  process.once 'unhandledRejection', exit_handler\n\n  # do =>\n  # process.stderr.on 'data', ( data ) => debug \"^6863-1^ (stderr.on 'data'):\", rpr data\n  # process.stdout.on 'data', ( data ) => debug \"^6863-2^ (stdout.on 'data'):\", rpr data\n  # process.stderr.on 'end', => debug \"^6863-1^ (stderr.on 'end')\"\n  # process.stdout.on 'end', => debug \"^6863-2^ (stdout.on 'end')\"\n  # debug '^6456^'\n  # echo \"^4564^ echo to stdout\"\n  # warn \"^4564^ warn to stderr\"\n  # process.stderr.write \"this goes to stderr\\n\"\n  # process.stdout.write \"this goes to stdout\\n\"\n  # process.on 'message', ( message ) -> debug \"^6863-3^' (process.on 'message'):\", rpr message\n  # process.on 'warning', ( warning ) -> debug \"^6863-3^' (process.on 'warning'):\", rpr warning\n###\ncallsite.getThis() - returns the value of this\ncallsite.getTypeName() - returns the type of this as a string. This is the name of the function stored in the constructor field of this, if available, otherwise the object's [[Class]] internal property.\ncallsite.getFunction() - returns the current function\ncallsite.getFunctionName() - returns the name of the current function, typically its name property. If a name property is not available an attempt will be made to try to infer a name from the function's context.\ncallsite.getMethodName() - returns the name of the property of this or one of its prototypes that holds the current function\ncallsite.getFileName() - if this function was defined in a script returns the name of the script\ncallsite.getLineNumber() - if this function was defined in a script returns the current line number\ncallsite.getColumnNumber() - if this function was defined in a script returns the current column number\ncallsite.getEvalOrigin() - if this function was created using a call to eval returns a CallSite object representing the location where eval was called\ncallsite.isToplevel() - is this a toplevel invocation, that is, is this the global object?\ncallsite.isEval() - does this call take place in code defined by a call to eval?\ncallsite.isNative() - is this call in native V8 code?\ncallsite.isConstructor() - is this a constructor c\n###\n\n"
   ]
 }

package/package.json

@@ -1,14 +1,11 @@
 {
   "name": "nodexh",
-  "version": "1.1.0",
+  "version": "2.1.0",
   "description": "a wrapper around the `node` executable for better stacktraces with sourcemaps, sourcecode excerpts",
   "main": "lib/main.js",
   "bin": {
     "nodexh": "bin/nodexh"
   },
-  "scripts": {
-    "build": "coffee --map -o lib -c src"
-  },
   "repository": {
     "type": "git",
     "url": "https://github.com/loveencounterflow/nodexh.git"
@@ -28,6 +25,11 @@
   "dependencies": {
     "cnd": "^9.1.0",
     "error-callsites": "^2.0.3",
-    "load-source-map": "^2.0.0"
-  }
-}
+    "load-source-map": "^2.0.0",
+    "stacktracey": "^2.0.14"
+  },
+  "scripts": {
+    "build": "coffee --map -o lib -c src"
+  },
+  "readme": "\n\n# NodeXH: NodeJS With a Better Exception Handler\n\n<!-- START doctoc generated TOC please keep comment here to allow auto update -->\n<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->\n**Table of Contents**  *generated with [DocToc](https://github.com/thlorenz/doctoc)*\n\n- [What It Is](#what-it-is)\n- [How to Install](#how-to-install)\n- [How to Use](#how-to-use)\n- [What to Expect](#what-to-expect)\n- [Related](#related)\n- [To Do](#to-do)\n\n<!-- END doctoc generated TOC please keep comment here to allow auto update -->\n\n## What It Is\n\nNodeXH is a drop-in wrapper for the NodeJS executable hat provides better stacktraces.\n\n## How to Install\n\n`npm install -g nodexh`\n\n## How to Use\n\nUse `nodexh path/to/file.js` instead of `node path/to/file.js`, and you're good to go.\n\n## What to Expect\n\n* Stack trace items will be reversed, so most recent calls will be shown *last*, i.e. also closest to where\n  the cursor of your terminal is.\n* Stack traces will show source contexts (3 lines by default) except where files can not be opened or are\n  NodeJS internals.\n* Source code shown will honor sourcemaps, which is great when you're using the likes of CoffeeScript or\n  TypeScript.\n* The error message will be repeated to avoid having to scroll up when stack traces get longer.\n* Colors!\n\n## Related\n\n* https://github.com/mozilla/source-map/\n* https://sokra.github.io/source-map-visualization/\n* https://medium.com/@nodejs/source-maps-in-node-js-482872b56116:\n  * \"In v13.7.0 a public API was introduced for interacting with source\n    maps.\"—[link](https://nodejs.org/dist/latest-v14.x/docs/api/all.html#modules_source_map_v3_support)\n  * \"You can start using Node.js’ source map functionality today: make sure you have an up-to-date version\n    of Node.js installed, and run your programs with the flag --enable-source-maps.\"\n\n## To Do\n\n* [ ] Add `error.name`, `error.code`; where `node` reports `TypeError: TEMPLATES.main_2 is not a function`,\n  `nodexh` only reports `EXCEPTION: TEMPLATES.main_2 is not a function`\n* [ ] visually indicate spot of error (e.g. by reversing)\n* [ ] fix async stacktraces (probably not yet handled correctly; might be issue with `stackman`?)\n* [ ] consider [utf8ize-sourcemaps](https://github.com/twada/utf8ize-sourcemaps) in case there should be\n  problems w/ 32bit characters\n* [ ] truncate long lines in context\n* [ ] offer capabilities of NodeXH as API so applications (such as test libraries) can easily retrieve\n  source code, display source lines with contexts\n\n\n\n"
+}

package/pnpm-lock.yaml

@@ -0,0 +1,76 @@
+lockfileVersion: 5.3
+
+specifiers:
+  cnd: ^9.1.0
+  error-callsites: ^2.0.3
+  load-source-map: ^2.0.0
+  stacktracey: ^2.0.14
+
+dependencies:
+  cnd: 9.2.2
+  error-callsites: 2.0.4
+  load-source-map: 2.0.0
+  stacktracey: 2.1.8
+
+packages:
+
+  /as-table/1.0.55:
+    resolution: {integrity: sha512-xvsWESUJn0JN421Xb9MQw6AsMHRCUknCe0Wjlxvjud80mU4E6hQf1A6NzQKcYNmYw62MfzEtXc+badstZP3JpQ==}
+    dependencies:
+      printable-characters: 1.0.42
+    dev: false
+
+  /cnd/9.2.2:
+    resolution: {integrity: sha512-F+/H+7luk4fZkvN0+MT0I2nwn80YM/EtfMttNUFxENR50XJH4g0KgQevzeyEJ8B6t6l8Tb4Xti6QAksa8DmePA==}
+    hasBin: true
+    dependencies:
+      jsx-number-format: 0.1.4
+    dev: false
+
+  /data-uri-to-buffer/2.0.2:
+    resolution: {integrity: sha512-ND9qDTLc6diwj+Xe5cdAgVTbLVdXbtxTJRXRhli8Mowuaan+0EJOtdqJ0QCHNSSPyoXGx9HX2/VMnKeC34AChA==}
+    dev: false
+
+  /error-callsites/2.0.4:
+    resolution: {integrity: sha512-V877Ch4FC4FN178fDK1fsrHN4I1YQIBdtjKrHh3BUHMnh3SMvwUVrqkaOgDpUuevgSNna0RBq6Ox9SGlxYrigA==}
+    engines: {node: '>=6.x'}
+    dev: false
+
+  /get-source/2.0.12:
+    resolution: {integrity: sha512-X5+4+iD+HoSeEED+uwrQ07BOQr0kEDFMVqqpBuI+RaZBpBpHCuXxo70bjar6f0b0u/DQJsJ7ssurpP0V60Az+w==}
+    dependencies:
+      data-uri-to-buffer: 2.0.2
+      source-map: 0.6.1
+    dev: false
+
+  /jsx-number-format/0.1.4:
+    resolution: {integrity: sha512-uPc/Q90XqZoRE7Cu1OLFQB2cSrA2Dy8+okzPOtML8vbagNFDSipbndIPme+q0odBjEhL+wf3WH3Wo52was4Tsg==}
+    dev: false
+
+  /load-source-map/2.0.0:
+    resolution: {integrity: sha512-QNZzJ2wMrTmCdeobMuMNEXHN1QGk8HG6louEkzD/zwQ7EU2RarrzlhQ4GnUYEFzLhK+Jq7IGyF/qy+XYBSO7AQ==}
+    engines: {node: '>= 8'}
+    dependencies:
+      source-map: 0.7.3
+    dev: false
+
+  /printable-characters/1.0.42:
+    resolution: {integrity: sha1-Pxjpd6m9jrN/zE/1ZZ176Qhos9g=}
+    dev: false
+
+  /source-map/0.6.1:
+    resolution: {integrity: sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==}
+    engines: {node: '>=0.10.0'}
+    dev: false
+
+  /source-map/0.7.3:
+    resolution: {integrity: sha512-CkCj6giN3S+n9qrYiBTX5gystlENnRW5jZeNLHpe6aue+SrHcG5VYwujhW9s4dY31mEGsxBDrHR6oI69fTXsaQ==}
+    engines: {node: '>= 8'}
+    dev: false
+
+  /stacktracey/2.1.8:
+    resolution: {integrity: sha512-Kpij9riA+UNg7TnphqjH7/CzctQ/owJGNbFkfEeve4Z4uxT5+JapVLFXcsurIfN34gnTWZNJ/f7NMG0E8JDzTw==}
+    dependencies:
+      as-table: 1.0.55
+      get-source: 2.0.12
+    dev: false

package/src/main.coffee

@@ -45,7 +45,8 @@ fetch_mapped_location = ( path, linenr, colnr ) ->
     sourcemap = await load_source_map path
     smp       = sourcemap.originalPositionFor { line: linenr, column: colnr, }
   catch error
-    warn '^7763-3^', "!!!!!!!!!!!!!!!!!", error.message
+    # warn '^7763-3^', "!!!!!!!!!!!!!!!!!", { path, }
+    # warn '^7763-3^', "!!!!!!!!!!!!!!!!!", error.message
     return { path, linenr, colnr, }
   #.........................................................................................................
   if ( smp? ) and ( smp.source? ) and ( smp.source isnt '' ) and ( smp.line? ) and ( smp.column? )
@@ -56,39 +57,39 @@ fetch_mapped_location = ( path, linenr, colnr ) ->
 
 #-----------------------------------------------------------------------------------------------------------
 get_context = ( path, linenr, colnr, width ) ->
-  #.........................................................................................................
-  try
-    lines     = ( FS.readFileSync path, { encoding: 'utf-8' } ).split '\n'
-    delta     = 1
-    coldelta  = 5
-    ### TAINT use more meaningful limit like n times the terminal width, assuming default of 100 ###
-    # effect    = underline
-    # effect    = bold
-    effect    = reverse
-    first_idx = Math.max 0, linenr - 1 - delta
-    last_idx  = Math.min lines.length - 1, linenr - 1 + delta
-    R         = []
-    for line, idx in lines[ first_idx .. last_idx ]
-      this_linenr     = first_idx + idx + 1
-      this_linenr_txt = ( this_linenr.toString().padStart 4 ) + '│ '
-      if this_linenr is linenr
-        c0      = colnr - 1
-        c1      = colnr + coldelta
-        hilite  = effect line[ c0 ... c1 ]
-        line    = line[ ... c0 ] + hilite + line[ c1 .. ]
-        if c1 > width
-          width2  = Math.floor width / 2
-          line    = '... ' + line[ c1 - width2 .. c1 + hilite.length - ( c1 - c0 ) + width2 ] + ' ...'
-        else
-          line  = line[ .. width ]
-        R.push  "#{grey this_linenr_txt}#{cyan line}"
-      else
-        R.push  "#{grey this_linenr_txt}#{grey line}"
-    # R = R.join '\n'
-  catch error
+  try return ( _get_context path, linenr, colnr, width ) catch error
     throw error unless error.code is 'ENOENT'
     # return [ ( red "!!! #{rpr error.message} !!!" ), ]
-    return []
+  return []
+
+#-----------------------------------------------------------------------------------------------------------
+_get_context = ( path, linenr, colnr, width ) ->
+  lines     = ( FS.readFileSync path, { encoding: 'utf-8' } ).split '\n'
+  delta     = 1
+  coldelta  = 5
+  effect    = reverse
+  first_idx = Math.max 0, linenr - 1 - delta
+  last_idx  = Math.min lines.length - 1, linenr - 1 + delta
+  R         = []
+  for line, idx in lines[ first_idx .. last_idx ]
+    this_linenr     = first_idx + idx + 1
+    this_linenr_txt = ( this_linenr.toString().padStart 4 ) + '│ '
+    if this_linenr isnt linenr
+      ### TAINT should adjust overlong context lines as well ###
+      R.push  "#{grey this_linenr_txt}#{grey line}"
+      continue
+    ### TAINT perform line length adjustment, hiliting in dedicated method ###
+    c0      = colnr - 1
+    c1      = colnr + coldelta
+    hilite  = effect line[ c0 ... c1 ]
+    line    = line[ ... c0 ] + hilite + line[ c1 .. ]
+    if c1 > width
+      width2  = Math.floor width / 2
+      line    = '... ' + line[ c1 - width2 .. c1 + hilite.length - ( c1 - c0 ) + width2 ] + ' ...'
+    else
+      line  = line[ .. width ]
+    R.push  "#{grey this_linenr_txt}#{cyan line}"
+  # R = R.join '\n'
   return R
 
 #-----------------------------------------------------------------------------------------------------------
@@ -104,7 +105,7 @@ show_error_with_source_context = ( error, headline ) ->
   callsites   = get_error_callsites error
   #.........................................................................................................
   if ( not callsites? ) or ( callsites.length is 0 )
-    write_to_stderr CND.red CND.reverse "error has no associated callsites:"
+    write_to_stderr CND.red CND.reverse "^455756^ error has no associated callsites:"
     write_to_stderr CND.red CND.reverse rpr error
     return null
   #.........................................................................................................
@@ -120,40 +121,115 @@ show_error_with_source_context = ( error, headline ) ->
     linenr      = callsite.getLineNumber()
     colnr       = callsite.getColumnNumber()
     #.......................................................................................................
-    if path.startsWith 'internal/'
-      write_to_stderr arrowhead, grey "#{path} ##{linenr}"
+    if ( path.startsWith 'node:internal/' ) or ( path.startsWith 'internal/' )
+      write_to_stderr arrowhead, grey "#{path} @ #{linenr},#{colnr}"
       continue
     #.......................................................................................................
-    # debug '^344463^', { relpath, linenr, colnr, }
     # write_to_stderr()
     # write_to_stderr steel bold reverse ( "#{relpath} ##{linenr}:" ).padEnd 108
+    fname = callsite.getFunctionName() ? callsite.getMethodName() ? null
     { path
       linenr
       colnr   } = await fetch_mapped_location path, linenr, colnr
     relpath     = PATH.relative process.cwd(), path
-    write_to_stderr arrowhead, gold ( "#{relpath} @ #{linenr},#{colnr}: \x1b[38;05;234m".padEnd width, '—' )
+    if fname?
+      ### TAINT use proper methods to format with multiple colors ###
+      fname_txt = steel fname
+      width1    = width + ( fname_txt.length - fname.length )
+      write_to_stderr arrowhead, gold ( "#{relpath} @ #{linenr},#{colnr}: #{fname_txt}() \x1b[38;05;234m".padEnd width1, '—' )
+    else
+      write_to_stderr arrowhead, gold ( "#{relpath} @ #{linenr},#{colnr}: \x1b[38;05;234m".padEnd width, '—' )
     for context_line in await get_context path, linenr, colnr, width
       write_to_stderr arrowshaft, context_line
   alert '^77765-2^', reverse bold headline
-  # if error?.message?
+  # urge "^94843^ error.stack:", rpr error.stack
+  # urge "^94843^ error.message:", rpr error.message
+  # urge "^94843^ error.code:", rpr error.code
+  # urge "^94843^ error.name:", rpr error.name
+  # urge "^94843^ error.type:", rpr error.type
+  # urge "^94843^ error.toString():", rpr error.toString()
+  # urge "^94843^ error:", rpr error
+  # CATALOGUING = require '../../multimix/lib/cataloguing'
+  # urge "^94843^", ( CATALOGUING.all_keys_of error )
   return null
 
 #-----------------------------------------------------------------------------------------------------------
-exit_handler = ( error ) ->
-  message = ' EXCEPTION: ' + ( error?.message ? "an unrecoverable condition occurred" )
+exit_handler = ( error, origin ) ->
+  ### TAINT origin never used ###
+  # show_stacktracey error
+  # debug '^4488^', error
+  # debug '^4488^', await origin
+  # return null
+  type    = error.code ? error.name ? 'EXCEPTION'
+  message = " #{type}: " + ( error?.message ? "an unrecoverable condition occurred" )
   await show_error_with_source_context error, message
   setImmediate ( -> process.exit 111 )
-  # process.exit 111
   return null
 
+############################################################################################################
+############################################################################################################
+############################################################################################################
+
+get_stacktracey = ( error ) ->
+  StackTracey               = require 'stacktracey'
+  stack = ( new StackTracey error ).withSources()
+  # stack = stack.clean()
+  R     = []
+  for idx in [ stack.items.length - 1 .. 0 ] by -1
+    d = stack.items[ idx ]
+    # debug '^2798^', ( k for k of d )
+    s =
+      # target_path:    d.file
+      relpath:        d.fileRelative # fileShort
+      native:         d.native
+      # is_nodejs:      d.native
+      is_other:       d.thirdParty
+      line:           d.line
+      column:         d.column
+      source:         d.sourceLine
+      error:          d.error
+    # for k in [ 'sourceLine', 'native', 'file', 'line', 'column', 'calleeShort', 'fileRelative', 'fileShort', 'fileName', 'thirdParty', 'name',]
+    #   debug k, rpr d[ k ]
+    R.push s
+  # info '\n' + stack.asTable()
+  return R
+
+show_stacktracey = ( error ) ->
+  for d in get_stacktracey error
+    echo CND.steel '^44872^ ' + "#{d.relpath} @ #{d.line}:#{d.column}"
+    ### NOTE errors:
+      ENOENT: no such file or directory
+      EISDIR: illegal operation on a directory, read
+      'Cannot read property 'originalPositionFor' of undefined'
+    ###
+    if d.error? then  echo CND.red    '^44873^ ' + ( d.error.message ? "an error occurred" )
+    else              echo CND.yellow '^44874^ ' + "#{rpr d.source[ .. 100 ]}"
+  return null
+
+############################################################################################################
+############################################################################################################
+############################################################################################################
 
 
 ############################################################################################################
 unless global[ Symbol.for 'cnd-exception-handler' ]?
+  null
   global[ Symbol.for 'cnd-exception-handler' ] = true
-  process.on 'uncaughtException',  exit_handler
-  process.on 'unhandledRejection', exit_handler
+  process.once 'uncaughtException',  exit_handler
+  process.once 'unhandledRejection', exit_handler
 
+  # do =>
+  # process.stderr.on 'data', ( data ) => debug "^6863-1^ (stderr.on 'data'):", rpr data
+  # process.stdout.on 'data', ( data ) => debug "^6863-2^ (stdout.on 'data'):", rpr data
+  # process.stderr.on 'end', => debug "^6863-1^ (stderr.on 'end')"
+  # process.stdout.on 'end', => debug "^6863-2^ (stdout.on 'end')"
+  # debug '^6456^'
+  # echo "^4564^ echo to stdout"
+  # warn "^4564^ warn to stderr"
+  # process.stderr.write "this goes to stderr\n"
+  # process.stdout.write "this goes to stdout\n"
+  # process.on 'message', ( message ) -> debug "^6863-3^' (process.on 'message'):", rpr message
+  # process.on 'warning', ( warning ) -> debug "^6863-3^' (process.on 'warning'):", rpr warning
 ###
 callsite.getThis() - returns the value of this
 callsite.getTypeName() - returns the type of this as a string. This is the name of the function stored in the constructor field of this, if available, otherwise the object's [[Class]] internal property.