hola-server 0.4.4 → 0.4.6

package/core/array.js

@@ -97,17 +97,6 @@ const avg = function (arr) {
     }
 };
 
-/**
- * Remove duplicate element and keep it unique
- * @param {array of elements} arr 
- * @returns 
- */
-const unique = function (arr) {
-    return arr.filter(function (elem, pos) {
-        return arr.indexOf(elem) == pos;
-    });
-}
-
 /**
  * 
  * @param {array of object} arr 
@@ -163,4 +152,36 @@ const sort_by_key_seq = function (arr, attr, keys) {
     return arr;
 };
 
-module.exports = { shuffle, remove_element, pop_n, shift_n, sum, avg, sort_desc, sort_asc, sort_by_key_seq, unique, map_array_to_obj }
+/**
+ * Create combination of two object, the size will be arr1.length * arr2.length
+ * @param {array of object} arr1 
+ * @param {array of object} arr2 
+ * @returns 
+ */
+const combine = (arr1, arr2) => {
+    const result = [];
+    for (let i = 0; i < arr1.length; i++) {
+        const obj1 = arr1[i];
+        for (let j = 0; j < arr2.length; j++) {
+            const obj2 = arr2[j];
+            result.push({ ...obj1, ...obj2 });
+        }
+    }
+    return result;
+}
+
+/**
+ * Remove duplicate element and keep it unique
+ * @param {array of elements} arr 
+ * @returns 
+ */
+const unique = (array) => {
+    return array.filter((value, index) => {
+        const _value = JSON.stringify(value);
+        return index === array.findIndex(obj => {
+            return JSON.stringify(obj) === _value;
+        });
+    });
+}
+
+module.exports = { shuffle, remove_element, pop_n, shift_n, sum, avg, combine, sort_desc, sort_asc, sort_by_key_seq, unique, map_array_to_obj }

package/core/file.js

@@ -1,3 +1,4 @@
+const fs = require('fs');
 const unzipper = require('unzipper');
 
 const file_extension = file_name => file_name ? file_name.split('.').pop() : "";
@@ -13,4 +14,18 @@ const read_from_zip_by_prefix = async (path, prefix) => {
     return directory.files.filter(file => file_prefix(file.path) == prefix);
 }
 
-module.exports = { file_extension, file_prefix, read_from_zip_by_extension, read_from_zip_by_prefix }
+/**
+ * Check the file exist or not
+ * @param {the file path} path 
+ * @returns 
+ */
+const is_file_exist = (path) => {
+    try {
+        fs.accessSync(path, fs.F_OK);
+    } catch (e) {
+        return false;
+    }
+    return true;
+}
+
+module.exports = { file_extension, file_prefix, read_from_zip_by_extension, read_from_zip_by_prefix, is_file_exist }

package/core/number.js

@@ -1,3 +1,6 @@
+const { has_value } = require('./validate');
+const { is_object } = require('./obj');
+
 /**
  * Parse String value to number
  * @param {String value to parse to number} str 
@@ -27,4 +30,150 @@ const round_to_fixed2 = function (num) {
     return Math.round(num * 100) / 100;
 };
 
-module.exports = { parse_num, to_fixed2, round_to_fixed2 }
+/**
+ * Generate range array, for example: range(3) = [0,1,2]
+ * @param {start index} start 
+ * @param {end index} end 
+ * @param {stepping} step 
+ * @returns 
+ */
+const range = (start, end, step = 1) => end ? [...Array(Math.floor((end - start) / step) + 1)].map((_, i) => start + i * step) : Array.from({ length: start }, (_, key) => key);
+
+/**
+ * Generate scale array, for example: scale(2,10) = [2,4,8]
+ * @param {start index} start 
+ * @param {end index} end 
+ * @param {scale ratio} scale 
+ * @returns 
+ */
+const scale = (start, end, scale = 2) => [...Array(Math.floor(Math.log(end / start) / Math.log(scale)) + 1)].map((_, i) => start * Math.pow(scale, i));
+
+/**
+ * Create a space 
+ * @param {min value} min 
+ * @param {max value} max 
+ * @returns 
+ */
+const space = (min, max) => {
+    if (has_value(min) && has_value(max)) {
+        return { ["min"]: min, ["max"]: max };
+    }
+
+    throw new Error("min and max not provide for space");
+}
+
+/**
+ * Check this value is space object
+ * @param {value to be checked} value 
+ * @returns true if it is space otherwise return false
+ */
+const is_space = (value) => {
+    return is_object(value) && has_value(value.min) && has_value(value.max);
+}
+
+/**
+ * check the object is integer or not
+ * @param {string need to check} str 
+ * @returns 
+ */
+const is_integer = (value) => {
+    const regex_pattern = /^-?[0-9]+$/;
+    return regex_pattern.test(value);
+}
+
+/**
+ * Check the object attr contains space object or not
+ * @param {object need to check} obj 
+ * @returns true if contains space
+ */
+const contains_space = (obj) => {
+    for (const key in obj) {
+        const value = obj[key];
+        if (is_space(value)) {
+            return true;
+        }
+    }
+    return false;
+}
+
+/**
+ * Generate the random number
+ * @param {min value} min 
+ * @param {max value} max 
+ * @returns 
+ */
+const random_number = (min, max) => {
+    const random = Math.random() * (max - min) + min;
+    return is_integer(min) && is_integer(max) ? Math.floor(random) : to_fixed(random);
+}
+
+/**
+ * Use LHS method to generate sample ranges
+ * @param {min value} min 
+ * @param {max value} max 
+ * @param {sample number} n 
+ * @returns 
+ */
+const lhs_samples = (min, max, n) => {
+    const all_int = is_integer(min + "") && is_integer(max + "");
+    const interval = (max - min) / n;
+    const ranges = [];
+    for (let i = 0; i < n; i++) {
+        const start = i * interval + min;
+        let end = start + interval;
+        if (i == n - 1) {
+            end = max;
+        }
+
+        const min_value = start < end ? start : end;
+        const max_value = start > end ? start : end;
+
+        let obj = {};
+        if (all_int) {
+            obj = { min: Math.floor(min_value), max: Math.floor(max_value) };
+        } else {
+            obj = { min: to_fixed2(min_value), max: to_fixed2(max_value) };
+        }
+        ranges.push(obj);
+    }
+    return ranges;
+}
+
+/**
+ * Create an random sample object
+ * @param {object } sample configuration 
+ * @returns a sample object
+ */
+const random_sample = (obj) => {
+    const sample_obj = {};
+    for (const key in obj) {
+        const value = obj[key];
+        if (Array.isArray(value)) {
+            const random = Math.floor(random_number(0, value.length));
+            sample_obj[key] = value[random];
+        } else if (is_space(value)) {
+            const random = random_number(value.min, value.max);
+            sample_obj[key] = random;
+        } else {
+            sample_obj[key] = value;
+        }
+    }
+    return sample_obj;
+}
+
+/**
+ * Extract number from string
+ * @param {contain number value} value 
+ * @returns 
+ */
+const extract_number = (value) => {
+    const number = value.match(/[+\-0-9\\.]+/g);
+    if (!number) {
+        return 0;
+    }
+
+    const values = number.map(Number);
+    return values.length == 1 ? values[0] : 0;
+}
+
+module.exports = { parse_num, extract_number, to_fixed2, round_to_fixed2, range, scale, space, is_space, contains_space, is_integer, random_number, random_sample, lhs_samples }

package/core/obj.js

@@ -4,10 +4,19 @@
  * @param {attributes to be copied} attrs 
  * @returns 
  */
-const copy_obj = function (obj, attrs) {
+const copy_obj = (obj, attrs) => {
     const copied = {};
     attrs.forEach(attr => copied[attr] = obj[attr]);
     return copied;
 };
 
-module.exports = { copy_obj }
+/**
+ * Check this is object or not
+ * @param {Object to be checked} obj 
+ * @returns 
+ */
+const is_object = (obj) => {
+    return typeof obj === 'object' && obj !== null && !Array.isArray(obj);
+}
+
+module.exports = { copy_obj, is_object }

package/index.js

@@ -7,8 +7,11 @@ const { Entity } = require('./db/entity');
 
 const array = require('./core/array');
 const date = require('./core/date');
+const file = require('./core/file');
 const number = require('./core/number');
 const obj = require('./core/obj');
+const random = require('./core/random');
+const thread = require('./core/thread');
 const validate = require('./core/validate');
 const code = require('./http/code');
 const err = require('./http/error');
@@ -21,6 +24,6 @@ const { log_debug, log_info, log_warn, log_error, is_log_debug, is_log_info, is_
 
 module.exports = {
     init_settings, init_express_server, init_router, register_type, get_type,
-    Entity, EntityMeta, get_entity_meta, array, date, number, obj, validate, code, err, params, context, gridfs, gen_i18n,
+    Entity, EntityMeta, get_entity_meta, array, date, file, number, obj, random, thread, validate, code, err, params, context, gridfs, gen_i18n,
     log_debug, log_info, log_warn, log_error, is_log_debug, is_log_info, is_log_warn, is_log_error, get_session_userid, oid_queries, oid_query
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hola-server",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "a meta programming framework used to build nodejs restful api",
   "main": "index.js",
   "scripts": {