hola-server 1.0.11 → 2.0.1

package/core/validate.js

@@ -1,32 +1,35 @@
-const is_undefined = function (value) {
-    return typeof value === 'undefined';
-}
+/**
+ * @fileoverview Validation utility functions for checking values and required fields.
+ * @module core/validate
+ */
 
-const has_value = function (value) {
-    //In short, JavaScript NaN values are the only ones that are not equal to themselves
-    //value!==value is to check is NaN
-    if (value === undefined || value === null || value !== value) {
-        return false
-    }
-    if (typeof value == 'undefined') {
-        return false;
-    }
-    if (typeof value === 'string' && value.trim().length === 0) {
-        return false;
-    }
+/**
+ * Check if a value is undefined.
+ * @param {*} value - The value to check.
+ * @returns {boolean} True if value is undefined, false otherwise.
+ */
+const is_undefined = (value) => typeof value === 'undefined';
+
+/**
+ * Check if a value exists and is meaningful (not null, undefined, NaN, or empty string).
+ * @param {*} value - The value to check.
+ * @returns {boolean} True if value has meaningful content, false otherwise.
+ */
+const has_value = (value) => {
+    // null == undefined, value !== value checks for NaN
+    if (value == null || value !== value) return false;
+    if (typeof value === 'string' && value.trim().length === 0) return false;
     return true;
 };
 
-const validate_required_fields = function (obj, field_names) {
-    const error_field_names = [];
-    field_names.forEach(function (field_name) {
-        const value = obj[field_name];
-        if (!has_value(value)) {
-            error_field_names.push(field_name);
-        }
-    });
-
-    return error_field_names;
+/**
+ * Validate that required fields have values in an object.
+ * @param {Object} obj - The object to validate.
+ * @param {string[]} field_names - Array of required field names.
+ * @returns {string[]} Array of field names that are missing values.
+ */
+const validate_required_fields = (obj, field_names) => {
+    return field_names.filter((field_name) => !has_value(obj[field_name]));
 };
 
-module.exports = { is_undefined, has_value, validate_required_fields }
+module.exports = { is_undefined, has_value, validate_required_fields };