mentie 0.3.20 → 0.3.22

package/modules/manipulations.js

@@ -3,17 +3,21 @@
  * @param {Array} array 
  * @returns {Array} The shuffled array.
  */
-export const shuffle_array = array => {
+export const shuffle_array = ( array, in_place=true ) => {
+
 
     // Validate input
     if( Array.isArray( array ) === false ) throw new Error( 'Input must be an array' )
 
+    // Handle in-place shuffling
+    const to_shuffle = in_place ? array : [ ...array ]
+
     // Fisher-Yates shuffle 
-    for( let i = array.length - 1; i > 0; i-- ) {
+    for( let i = to_shuffle.length - 1; i > 0; i-- ) {
         const j = Math.floor( Math.random() * ( i + 1 ) );
-        [ array[i], array[j] ] = [ array[j], array[i] ]
+        [ to_shuffle[i], to_shuffle[j] ] = [ to_shuffle[j], to_shuffle[i] ]
     }
 
-    return array
+    return to_shuffle
 
 }

package/modules/validations.js

@@ -7,13 +7,26 @@ import stringify from "safe-stable-stringify"
  */
 export const email_regex = /(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])/i
 
+/**
+ * Trims whitespace from each line of a multiline string.
+ * @param {string} string - The multiline string to trim.
+ * @returns {string} - The trimmed multiline string.
+ */
+export const multiline_trim = string => `${ string }`.split( '\n' ).map( s => s?.trim() ).join( '\n' ).trim()
+
 /**
  * Sanitizes a string by removing leading and trailing whitespace and converting it to lowercase.
  *
  * @param {string} string - The string to be sanitized.
+ * @param {boolean} [multiline=true] - Whether to trim each line of a multiline string.
  * @returns {string} - The sanitized string.
  */
-export const sanetise_string = string => `${ string }`.trim().toLowerCase()
+export const sanetise_string = ( string, multiline=true ) => {
+    string = `${ string }`.toLowerCase()
+    if( multiline ) string = multiline_trim( string )
+    else string = string.trim()
+    return string
+}
 
 /**
  * Validates whether a given string is a valid IPv4 address.
@@ -23,7 +36,7 @@ export const sanetise_string = string => `${ string }`.trim().toLowerCase()
 export const is_ipv4 = ip => {
 
     // Split the IP address into its components and make then numbers
-    const octets = ip.split( '.' ).map( octet => parseInt( octet, 10 ) )
+    const octets = `${ ip }`.split( '.' ).map( octet => parseInt( octet, 10 ) )
 
     // Check if the IP address has 4 octets and each octet is between 0 and 255
     return octets.length === 4 && octets.every( octet => !isNaN( octet ) && octet >= 0 && octet <= 255 )

package/package.json

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