mentie 0.3.18 → 0.3.20

package/index.js

@@ -7,4 +7,5 @@ export * from './modules/numbers.js'
 export * from './modules/promises.js'
 export * from './modules/cache.js'
 export * from './modules/crypto.js'
-export * from './modules/network.js'
+export * from './modules/network.js'
+export * from './modules/manipulations.js'

package/modules/cache.js

@@ -5,7 +5,7 @@ import { log } from "./logging.js"
  * @type {Object}
  * @private
  */
-const _cache = {}
+let _cache = {}
 
 /**
  * Caches the value with the specified key.
@@ -101,6 +101,17 @@ cache.dump = () => {
 
 }
 
+/**
+ * Clears the cache entirely
+ */
+cache.clear = ( { i_am_sure=false } ) => {
+    if( i_am_sure ) {
+        _cache = {}
+    } else {
+        log.warn( `cache.clear() called without i_am_sure=true, cache not cleared` )
+    }
+}
+
 /**
  * 
  * @returns {Object} stats - An object containing statistics about the cache.

package/modules/manipulations.js

@@ -0,0 +1,19 @@
+/**
+ * Shuffle an array using the Fisher-Yates algorithm.
+ * @param {Array} array 
+ * @returns {Array} The shuffled array.
+ */
+export const shuffle_array = array => {
+
+    // Validate input
+    if( Array.isArray( array ) === false ) throw new Error( 'Input must be an array' )
+
+    // Fisher-Yates shuffle 
+    for( let i = array.length - 1; i > 0; i-- ) {
+        const j = Math.floor( Math.random() * ( i + 1 ) );
+        [ array[i], array[j] ] = [ array[j], array[i] ]
+    }
+
+    return array
+
+}

package/package.json

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