mentie 0.1.22 → 0.2.23

package/index.js

@@ -5,4 +5,5 @@ export * from './modules/validations.js'
 export * from './modules/text.js'
 export * from './modules/numbers.js'
 export * from './modules/promises.js'
-export * from './modules/cache.js'
+export * from './modules/cache.js'
+export * from './modules/crypto.js'

package/modules/crypto.js

@@ -0,0 +1,27 @@
+/**
+ * Calculates the hash of the given data using the specified algorithm.
+ * 
+ * @param {string} data - The data to be hashed.
+ * @param {string} [algo='sha256'] - The algorithm to be used for hashing. Defaults to 'sha256'.
+ * @param {string} [_digest='hex'] - The encoding of the output hash. Defaults to '
+ * @returns {Promise<string>} The hashed value of the data.
+ */
+export async function hash( data, algo='sha256', _digest='hex' ) {
+
+    try {
+
+        // Native node way
+        const { createHash } = await import( 'crypto' )
+        const _hash = createHash( algo ).update( data ).digest( _digest )
+        return _hash
+
+    } catch {
+
+        // Dependency-based way
+        const { default: hash } = await import( 'hash.js' )
+        const _hash = hash[ algo ]().update( data ).digest( _digest )
+        return _hash
+
+    }
+
+}

package/modules/environment.js

@@ -17,6 +17,12 @@ export const env = {}
  */
 env.is_web = () => typeof window !== 'undefined'
 
+/**
+ * 
+ * @returns {boolean} True if running in a web browser and the URL includes 'localhost', otherwise false.
+ */
+env.is_localhost = () => env.is_web() && `${ location.href }`.includes( 'localhost' )
+
 /**
  * Checks if the code is running in the Cypress testing environment within a web browser.
  * @returns {boolean} True if running in Cypress, otherwise false.
@@ -78,6 +84,12 @@ env.loglevel = () => env.web_loglevel() || env.node_loglevel() || env.dev() ? 'i
  */
 export const is_web = env.is_web()
 
+/**
+ * Checks if the code is running in a web environment and the URL includes 'localhost'.
+ * @returns {boolean} Returns true if the code is running in a web environment and the URL includes 'localhost', otherwise returns false.
+ */
+export const is_localhost = env.is_localhost()
+
 /**
  * Checks if the code is running within a Cypress environment.
  * @returns {boolean} Returns true if the code is running in a Cypress environment, otherwise returns false.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mentie",
-  "version": "0.1.22",
+  "version": "0.2.23",
   "description": "Mentor's toolbelt",
   "type": "module",
   "main": "index.js",
@@ -29,7 +29,8 @@
   },
   "peerDependencies": {
     "promise-parallel-throttle": "^3.5.0",
-    "promise-retry": "^2.0.1"
+    "promise-retry": "^2.0.1",
+    "hash.js": "^1.1.7"
   },
   "dependencies": {
     "safe-stable-stringify": "^2.4.3"