mentie 0.3.7 → 0.3.9

package/modules/cache.js

@@ -42,6 +42,47 @@ export function cache( key, value, expires_in_ms=Infinity ) {
     return _cache[key]?.value
 }
 
+/**
+ * 
+ * @returns {Object} - A copy of the cache object.
+ */
+cache.dump = () => {
+
+    // Return a copy of the cache object
+    return { ..._cache }
+
+}
+
+/**
+ * 
+ * @returns {Object} stats - An object containing statistics about the cache.
+ * @returns {number} stats.keys - The number of keys in the cache.
+ * @returns {number} stats.size_bytes - The size of the cache in bytes.
+ * @returns {string} stats.size_mib - The size of the cache in MiB, rounded to 2 decimal places.
+ * @returns {string} stats.size_gib - The size of the cache in GiB, rounded to 2 decimal places.
+ */
+cache.stats = () => {
+
+    // Get the number of keys in the cache
+    const keys = Object.keys( _cache ).length
+
+    // Get the size in bytes of the cache
+    const size_bytes = keys.reduce( ( acc, key ) => acc + JSON.stringify( _cache[key] ).length, 0 )
+
+    // Calculate side to MiB and GiB, both rounded to 2 decimal places
+    const size_mib = ( size_bytes / ( 1024 * 1024 ) ).toFixed( 2 )
+    const size_gib = ( size_bytes / ( 1024 * 1024 * 1024 ) ).toFixed( 2 )
+
+    // Return the stats
+    return {
+        keys,
+        size_bytes,
+        size_mib,
+        size_gib
+    }
+
+}
+
 /**
  * Function to inspect concurrency.
  * 

package/modules/environment.js

@@ -81,13 +81,13 @@ env.loglevel = () => env.web_loglevel() || env.node_loglevel() || env.dev() ? 'i
  * Retrieves the log annotations set via URL parameters in a web environment.
  * @returns {Array<string>|boolean} An array of log annotations from URL parameters, or false if not set.
  */
-env.web_log_annotations = () => env.is_web() && new URLSearchParams( location?.search ).get( 'log_annotations' ).split( ',' ).filter( Boolean ).map( annotation => annotation.trim() )
+env.web_log_annotations = () => env.is_web() && new URLSearchParams( location?.search ).get( 'log_annotations' )?.split( ',' )?.filter( Boolean )?.map( annotation => annotation?.trim() )
 
 /**
  * Retrieves the log annotations set via environment variables in a Node.js environment.
  * @returns {Array<string>|boolean} An array of log annotations from environment variables, or false if not set.
  */
-env.node_log_annotations = () => env.is_node() && process.env?.LOG_ANNOTATIONS?.split( ',' ).filter( Boolean ).map( annotation => annotation.trim() )
+env.node_log_annotations = () => env.is_node() && process.env?.LOG_ANNOTATIONS?.split( ',' )?.filter( Boolean )?.map( annotation => annotation?.trim() )
 
 /**
  * Retrieves the effective log annotations based on the environment. Defaults to an empty array if not set.

package/package.json

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