@vbarbarosh/node-helpers 3.44.0 → 3.46.0

package/README.md

@@ -1,5 +1,7 @@
 A set of helpers for JavaScript/Node.js
 
+![](img/node-helpers-by-chat-gpt.webp)
+
 ## Installation
 
     npm install @vbarbarosh/node-helpers

package/package.json

@@ -2,7 +2,7 @@
     "author": "Vladimir Barbarosh <vladimir.barbarosh@gmail.com>",
     "license": "MIT",
     "name": "@vbarbarosh/node-helpers",
-    "version": "3.44.0",
+    "version": "3.46.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/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;

package/src/stream_progress.js

@@ -1,4 +1,5 @@
 const format_progress_bytes = require('./format_progress_bytes');
+const format_progress_kilo = require('./format_progress_kilo');
 const make_progress = require('./make_progress');
 const stream = require('stream');
 
@@ -12,6 +13,7 @@ function stream_progress({objectMode = false, total, user_friendly_status = s =>
     let done = 0;
     const timer = setInterval(tick, 1000);
     const progress = make_progress(total);
+    const format_progress = objectMode ? format_progress_kilo : format_progress_bytes;
     return new stream.Transform({
         objectMode,
         destroy: function (error, callback) {
@@ -33,7 +35,7 @@ function stream_progress({objectMode = false, total, user_friendly_status = s =>
     });
     function tick() {
         progress.update(done);
-        user_friendly_status(format_progress_bytes(progress));
+        user_friendly_status(format_progress(progress));
     }
 }