@vbarbarosh/node-helpers 3.43.0 → 3.45.0

package/package.json

@@ -2,7 +2,7 @@
     "author": "Vladimir Barbarosh <vladimir.barbarosh@gmail.com>",
     "license": "MIT",
     "name": "@vbarbarosh/node-helpers",
-    "version": "3.43.0",
+    "version": "3.45.0",
     "description": "A set of helpers for JavaScript/Node.js",
     "files": [
         "src"

package/src/assert_valid_expires_at.js

@@ -0,0 +1,14 @@
+/**
+ * Ensures that the provided value is a date pointing to the future.
+ */
+function assert_valid_expires_at(expires_at)
+{
+    if (expires_at instanceof Date) {
+        if (expires_at.getTime() > Date.now()) {
+            return;
+        }
+    }
+    throw new Error('Invalid value for expires_at; it should be a Date object pointing to the future.');
+}
+
+module.exports = assert_valid_expires_at;

package/src/format_hrtime.js

@@ -0,0 +1,10 @@
+/**
+ * Return a human-readable representation of hrtime (the return value from `process.hrtime(hrtime0)`).
+ */
+function format_hrtime(hrtime, digits = 6)
+{
+    const [u, v] = hrtime; // process.hrtime(hrtime0)
+    return (u + v/1E9).toFixed(digits) + 's';
+}
+
+module.exports = format_hrtime;

package/src/perf_end_human.js

@@ -2,7 +2,7 @@ const format_hrtime = require('./format_hrtime');
 
 function perf_end_human(time0, digits = 4)
 {
-    return format_hrtime(time0, digits);
+    return format_hrtime(process.hrtime(time0), digits);
 }
 
 module.exports = perf_end_human;

package/src/random_hex.js

@@ -0,0 +1,11 @@
+const crypto = require('crypto');
+
+/**
+ * Returns random bytes in hexadecimal format.
+ */
+function random_hex(bytes = 32)
+{
+    return crypto.randomBytes(bytes).toString('hex');
+}
+
+module.exports = random_hex;