mentie 0.1.7 → 0.1.9

package/README.md

@@ -2,6 +2,3 @@
 
 Mentor's favorite helpers.
 
-Notes:
-
-- If you're going to use promise utilities `make_retryable` and `throttle_and_retry`, make sure to install their dependencies: `npm i -S promise-retry promise-parallel-throttle`

package/modules/logging.js

@@ -13,6 +13,38 @@ const should_log = levels => {
 
 }
 
+const add_trace = messages => {
+
+    // Try to add stack to messages if needed
+    try {
+
+        // Do nothing if we are not in a browser
+        if( typeof window === 'undefined' ) return messages
+
+        // If there is no trace=true in the url, do nothing
+        if( !window.location?.search?.includes?.( 'trace=true' ) ) return messages
+
+
+        // Get the stack trace
+        let { stack } = new Error()
+
+        // Remove the first line of the stack trace
+        stack = stack.split( '\n' ).slice( 1 ).join( '\n' )
+
+        // Add the trace to the messages
+        messages.push( { stack } )
+
+        return messages
+
+    } catch ( error ) {
+
+        // This should never happen but we'll add it so we don't crash in unexpected situations
+        return messages
+
+    }
+
+}
+
 /**
  * Logs the provided messages to the console.
  * Only logs in development mode OR if ?loglevel= or LOG_LEVEL= is set to one of the following: 'error', 'warn', 'info'.
@@ -30,7 +62,15 @@ export function log( ...messages ) {
     const levels = [ 'info' ]
 
     // Log the messages if the loglevel matches
-    if( dev || should_log( levels ) ) console.log( ...messages )
+    if( dev || should_log( levels ) ) {
+
+        // Add the trace to the messages
+        add_trace( messages )
+
+        // Log the messages
+        console.log( ...messages )
+
+    }
 
 }
 
@@ -47,7 +87,15 @@ log.info = function( ...messages ) {
     const levels = [ 'info' ]
 
     // Log the messages if the loglevel matches
-    if( is_emulator || should_log( levels ) ) console.info( ...messages )
+    if( is_emulator || should_log( levels ) ) {
+
+        // Add the trace to the messages
+        add_trace( messages )
+
+        // Log the messages
+        console.info( ...messages )
+        
+    }
 
 }
 
@@ -64,7 +112,15 @@ log.warn = function( ...messages ) {
     const levels = [ 'warn', 'info' ]
 
     // Log the messages if the loglevel matches
-    if( dev || should_log( levels ) ) console.warn( ...messages )
+    if( dev || should_log( levels ) ) {
+
+        // Add the trace to the messages
+        add_trace( messages )
+
+        // Log the messages
+        console.warn( ...messages )
+        
+    }
 
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mentie",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Mentor's toolbelt",
   "type": "module",
   "main": "index.js",