xcraft-core-utils 4.3.4 → 4.3.7

package/.eslintrc.js

@@ -1,28 +1,28 @@
-'use strict';
-
-module.exports = {
-  root: true,
-  parserOptions: {
-    ecmaVersion: 7,
-    sourceType: 'module',
-    ecmaFeatures: {
-      jsx: true,
-    },
-  },
-  env: {
-    browser: true,
-    mocha: true,
-    node: true,
-    es6: true,
-  },
-  parser: 'babel-eslint',
-  plugins: ['react', 'babel'],
-  extends: ['prettier', 'eslint:recommended', 'plugin:react/recommended'],
-  rules: {
-    // Other rules
-    'no-console': 'off',
-    'valid-jsdoc': ['error', {requireReturn: false}],
-    'eqeqeq': 'error',
-    'react/display-name': 'off',
-  },
-};
+'use strict';
+
+module.exports = {
+  root: true,
+  parserOptions: {
+    ecmaVersion: 7,
+    sourceType: 'module',
+    ecmaFeatures: {
+      jsx: true,
+    },
+  },
+  env: {
+    browser: true,
+    mocha: true,
+    node: true,
+    es6: true,
+  },
+  parser: 'babel-eslint',
+  plugins: ['react', 'babel'],
+  extends: ['prettier', 'eslint:recommended', 'plugin:react/recommended'],
+  rules: {
+    // Other rules
+    'no-console': 'off',
+    'valid-jsdoc': ['error', {requireReturn: false}],
+    'eqeqeq': 'error',
+    'react/display-name': 'off',
+  },
+};

package/README.md

@@ -1,3 +1,3 @@
-# xcraft-core-utils
-
-Xcraft utils
+# xcraft-core-utils
+
+Xcraft utils

package/index.js

@@ -1,24 +1,24 @@
-'use strict';
-
-exports.ArrayCollector = require('./lib/arrayCollector.js');
-exports.batch = require('./lib/batch.js');
-exports.crypto = require('./lib/crypto.js');
-exports.EventDebouncer = require('./lib/eventDebouncer.js');
-exports.files = require('./lib/files.js');
-exports.fileCrypto = require('./lib/file-crypto.js');
-exports.js = require('./lib/js.js');
-exports.json = require('./lib/json.js');
-exports.locks = require('./lib/locks.js');
-exports.log = require('./lib/log.js');
-exports.modules = require('./lib/modules.js');
-exports.os = require('./lib/os.js');
-exports.propTypes = require('./lib/prop-types.js');
-exports.reflect = require('./lib/reflect.js');
-exports.regex = require('./lib/regex.js');
-exports.string = require('./lib/string.js');
-exports.whereIs = require('./lib/whereIs.js');
-exports.yaml = require('./lib/yaml.js');
-
-exports.RankedCache = require('./lib/ranked-cache.js');
-exports.JobQueue = require('./lib/job-queue.js');
-exports.CursorPump = require('./lib/cursorPump.js');
+'use strict';
+
+exports.ArrayCollector = require('./lib/arrayCollector.js');
+exports.batch = require('./lib/batch.js');
+exports.crypto = require('./lib/crypto.js');
+exports.EventDebouncer = require('./lib/eventDebouncer.js');
+exports.files = require('./lib/files.js');
+exports.fileCrypto = require('./lib/file-crypto.js');
+exports.js = require('./lib/js.js');
+exports.json = require('./lib/json.js');
+exports.locks = require('./lib/locks.js');
+exports.log = require('./lib/log.js');
+exports.modules = require('./lib/modules.js');
+exports.os = require('./lib/os.js');
+exports.propTypes = require('./lib/prop-types.js');
+exports.reflect = require('./lib/reflect.js');
+exports.regex = require('./lib/regex.js');
+exports.string = require('./lib/string.js');
+exports.whereIs = require('./lib/whereIs.js');
+exports.yaml = require('./lib/yaml.js');
+
+exports.RankedCache = require('./lib/ranked-cache.js');
+exports.JobQueue = require('./lib/job-queue.js');
+exports.CursorPump = require('./lib/cursorPump.js');

package/lib/.babelrc

@@ -1,8 +1,8 @@
-{
-  "plugins": [
-    "@babel/proposal-class-properties",
-    "@babel/proposal-object-rest-spread",
-    "@babel/proposal-function-bind",
-    "@babel/transform-modules-commonjs"
-  ]
-}
+{
+  "plugins": [
+    "@babel/proposal-class-properties",
+    "@babel/proposal-object-rest-spread",
+    "@babel/proposal-function-bind",
+    "@babel/transform-modules-commonjs"
+  ]
+}

package/lib/arrayCollector.js

@@ -1,33 +1,33 @@
-'use strict';
-
-const {throttle} = require('lodash');
-const watt = require('gigawatts');
-
-class ArrayCollector {
-  constructor(resp, wait = 20, onCollect, leading = true) {
-    this.onCollect = watt(onCollect);
-    this.entries = {};
-    this.resp = resp;
-    this.release = throttle(this._release, wait, {leading});
-  }
-
-  _release() {
-    const copy = this.entries;
-    this.entries = {};
-    this.onCollect(copy, this.resp);
-  }
-
-  _addByKey(key, data) {
-    if (!this.entries[key]) {
-      this.entries[key] = [];
-    }
-    this.entries[key] = this.entries[key].concat(data);
-  }
-
-  grab(key, data) {
-    this._addByKey(key, data);
-    this.release();
-  }
-}
-
-module.exports = ArrayCollector;
+'use strict';
+
+const {throttle} = require('lodash');
+const watt = require('gigawatts');
+
+class ArrayCollector {
+  constructor(resp, wait = 20, onCollect, leading = true) {
+    this.onCollect = watt(onCollect);
+    this.entries = {};
+    this.resp = resp;
+    this.release = throttle(this._release, wait, {leading});
+  }
+
+  _release() {
+    const copy = this.entries;
+    this.entries = {};
+    this.onCollect(copy, this.resp);
+  }
+
+  _addByKey(key, data) {
+    if (!this.entries[key]) {
+      this.entries[key] = [];
+    }
+    this.entries[key] = this.entries[key].concat(data);
+  }
+
+  grab(key, data) {
+    this._addByKey(key, data);
+    this.release();
+  }
+}
+
+module.exports = ArrayCollector;

package/lib/async.js

@@ -1,34 +1,34 @@
-'use strict';
-
-const watt = require('gigawatts');
-
-class Async {
-  constructor() {
-    watt.wrapAll(this);
-  }
-
-  /**
-   * Reduce an array to a map with an async iteration.
-   *
-   * It's useful in the case where the main event loop must not
-   * be blocked and the array is very large. The purpose of this
-   * helper is only for task which be done with an usual sync
-   * map reduce.
-   *
-   * @param {*} keyFunc - Key for the item in the map.
-   * @param {*} valueFunc - Value for the item in the map.
-   * @param {*} list - The input array.
-   * @returns {Object} the map.
-   */
-  *mapReduce(keyFunc, valueFunc, list) {
-    const state = {};
-    for (const item of list) {
-      state[keyFunc(item)] = yield new Promise((resolve) =>
-        resolve(valueFunc(item))
-      );
-    }
-    return state;
-  }
-}
-
-module.exports = new Async();
+'use strict';
+
+const watt = require('gigawatts');
+
+class Async {
+  constructor() {
+    watt.wrapAll(this);
+  }
+
+  /**
+   * Reduce an array to a map with an async iteration.
+   *
+   * It's useful in the case where the main event loop must not
+   * be blocked and the array is very large. The purpose of this
+   * helper is only for task which be done with an usual sync
+   * map reduce.
+   *
+   * @param {*} keyFunc - Key for the item in the map.
+   * @param {*} valueFunc - Value for the item in the map.
+   * @param {*} list - The input array.
+   * @returns {Object} the map.
+   */
+  *mapReduce(keyFunc, valueFunc, list) {
+    const state = {};
+    for (const item of list) {
+      state[keyFunc(item)] = yield new Promise((resolve) =>
+        resolve(valueFunc(item))
+      );
+    }
+    return state;
+  }
+}
+
+module.exports = new Async();

package/lib/batch.js

@@ -1,24 +1,24 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const xFs = require('xcraft-core-fs');
-
-exports.run = function (filter, location, callbackAction) {
-  var files = xFs.ls(location);
-
-  files.forEach(function (file) {
-    var fullPath = path.join(location, file);
-    var st = fs.lstatSync(fullPath);
-
-    if (st.isDirectory()) {
-      exports.run(filter, fullPath, callbackAction);
-      return;
-    }
-
-    if (!filter || filter.test(file)) {
-      callbackAction(fullPath);
-      return;
-    }
-  });
-};
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const xFs = require('xcraft-core-fs');
+
+exports.run = function (filter, location, callbackAction) {
+  var files = xFs.ls(location);
+
+  files.forEach(function (file) {
+    var fullPath = path.join(location, file);
+    var st = fs.lstatSync(fullPath);
+
+    if (st.isDirectory()) {
+      exports.run(filter, fullPath, callbackAction);
+      return;
+    }
+
+    if (!filter || filter.test(file)) {
+      callbackAction(fullPath);
+      return;
+    }
+  });
+};

package/lib/crypto.js

@@ -1,92 +1,92 @@
-'use strict';
-
-var crypto = require('crypto');
-const {v4: uuidV4} = require('uuid');
-
-exports.md5 = function (data) {
-  var md5 = crypto.createHash('md5');
-  md5.update(data);
-  return md5.digest('hex');
-};
-
-exports.sha256 = function (data) {
-  var sha = crypto.createHash('sha256');
-  sha.update(data);
-  return sha.digest('hex');
-};
-
-exports.genToken = function () {
-  return uuidV4().replace(/-/g, '');
-};
-
-// Get the number of random bytes needed and the mask
-// used to generate an integer in the specified range
-function getBytesSizeAndMask(range) {
-  let mask = 0;
-  let bitsCount = 0;
-  while (range > 0) {
-    mask = (mask << 1) | 1; // 0x00000011 -> 0x00000111
-    range = range >>> 1; // 0x00111100 -> 0x00011110
-    bitsCount++;
-  }
-  const bytesSize = (bitsCount + 7) >> 3; // ceil(bitsCount / 8)
-  return {bytesSize, mask};
-}
-
-/**
- * Generate a random integer between min and max.
- *
- * @param {number} min - Min value.
- * @param {number} max - Max value.
- * @returns {number} A random integer between min and max
- */
-function randomInt(min, max) {
-  const range = max - min;
-  if (range > 2147483647 || range < 0) {
-    // max safe integer for bitwise operations (2147483647 = 2^31 - 1)
-    throw new Error('Range must be between 0 and 2147483647');
-  }
-
-  const {bytesSize, mask} = getBytesSizeAndMask(range);
-  let randomInt;
-  do {
-    const randomBytes = crypto.randomBytes(bytesSize);
-
-    // Convert random bytes to an integer
-    randomInt = 0;
-    for (let i = 0; i < bytesSize; i++) {
-      randomInt = (randomInt << 8) | randomBytes[i];
-    }
-
-    // Apply mask to reduce the number of discarded numbers
-    randomInt = randomInt & mask;
-  } while (randomInt > range); // Discard random numbers outside the range
-
-  return min + randomInt;
-}
-exports.randomInt = randomInt;
-
-const defaultChars =
-  'abcdefghijkmnopqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ@+-=*&%?!_23456789';
-
-function randomChar(chars = defaultChars) {
-  const charId = randomInt(0, chars.length - 1);
-  return chars[charId];
-}
-exports.randomChar = randomChar;
-
-/**
- * Generate a random password.
- *
- * @param {number} [length] - The password length.
- * @param {string} [chars] - A string with the chars to use for password generation.
- * @returns {string} A random string
- */
-exports.randomPassword = function (length = 12, chars) {
-  let password = '';
-  for (let i = 0; i < length; i++) {
-    const char = randomChar(chars);
-    password += char;
-  }
-  return password;
-};
+'use strict';
+
+var crypto = require('crypto');
+const {v4: uuidV4} = require('uuid');
+
+exports.md5 = function (data) {
+  var md5 = crypto.createHash('md5');
+  md5.update(data);
+  return md5.digest('hex');
+};
+
+exports.sha256 = function (data) {
+  var sha = crypto.createHash('sha256');
+  sha.update(data);
+  return sha.digest('hex');
+};
+
+exports.genToken = function () {
+  return uuidV4().replace(/-/g, '');
+};
+
+// Get the number of random bytes needed and the mask
+// used to generate an integer in the specified range
+function getBytesSizeAndMask(range) {
+  let mask = 0;
+  let bitsCount = 0;
+  while (range > 0) {
+    mask = (mask << 1) | 1; // 0x00000011 -> 0x00000111
+    range = range >>> 1; // 0x00111100 -> 0x00011110
+    bitsCount++;
+  }
+  const bytesSize = (bitsCount + 7) >> 3; // ceil(bitsCount / 8)
+  return {bytesSize, mask};
+}
+
+/**
+ * Generate a random integer between min and max.
+ *
+ * @param {number} min - Min value.
+ * @param {number} max - Max value.
+ * @returns {number} A random integer between min and max
+ */
+function randomInt(min, max) {
+  const range = max - min;
+  if (range > 2147483647 || range < 0) {
+    // max safe integer for bitwise operations (2147483647 = 2^31 - 1)
+    throw new Error('Range must be between 0 and 2147483647');
+  }
+
+  const {bytesSize, mask} = getBytesSizeAndMask(range);
+  let randomInt;
+  do {
+    const randomBytes = crypto.randomBytes(bytesSize);
+
+    // Convert random bytes to an integer
+    randomInt = 0;
+    for (let i = 0; i < bytesSize; i++) {
+      randomInt = (randomInt << 8) | randomBytes[i];
+    }
+
+    // Apply mask to reduce the number of discarded numbers
+    randomInt = randomInt & mask;
+  } while (randomInt > range); // Discard random numbers outside the range
+
+  return min + randomInt;
+}
+exports.randomInt = randomInt;
+
+const defaultChars =
+  'abcdefghijkmnopqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ@+-=*&%?!_23456789';
+
+function randomChar(chars = defaultChars) {
+  const charId = randomInt(0, chars.length - 1);
+  return chars[charId];
+}
+exports.randomChar = randomChar;
+
+/**
+ * Generate a random password.
+ *
+ * @param {number} [length] - The password length.
+ * @param {string} [chars] - A string with the chars to use for password generation.
+ * @returns {string} A random string
+ */
+exports.randomPassword = function (length = 12, chars) {
+  let password = '';
+  for (let i = 0; i < length; i++) {
+    const char = randomChar(chars);
+    password += char;
+  }
+  return password;
+};

package/lib/cursorPump.js

@@ -1,29 +1,29 @@
-'use strict';
-
-const watt = require('gigawatts');
-
-class CursorPump {
-  constructor(cursor) {
-    this.cursor = cursor;
-    watt.wrapAll(this);
-  }
-
-  *toArray() {
-    let run = true;
-    let results = [];
-    do {
-      try {
-        const row = yield this.cursor.next();
-        results.push(row);
-      } catch {
-        run = false;
-      }
-    } while (run);
-    return results;
-  }
-
-  *pump() {
-    return yield this.cursor.next();
-  }
-}
-module.exports = CursorPump;
+'use strict';
+
+const watt = require('gigawatts');
+
+class CursorPump {
+  constructor(cursor) {
+    this.cursor = cursor;
+    watt.wrapAll(this);
+  }
+
+  *toArray() {
+    let run = true;
+    let results = [];
+    do {
+      try {
+        const row = yield this.cursor.next();
+        results.push(row);
+      } catch {
+        run = false;
+      }
+    } while (run);
+    return results;
+  }
+
+  *pump() {
+    return yield this.cursor.next();
+  }
+}
+module.exports = CursorPump;

package/lib/eventDebouncer.js

@@ -1,21 +1,21 @@
-'use strict';
-
-const {debounce} = require('lodash');
-
-class EventDebouncer {
-  constructor(resp, wait = 1000) {
-    this.debouncers = {};
-    this.wait = wait;
-    this.resp = resp;
-  }
-
-  publish(topic, data) {
-    if (!this.debouncers[topic]) {
-      const send = (topic, data) => this.resp.events.send(topic, data);
-      this.debouncers[topic] = debounce(send, this.wait);
-    }
-    this.debouncers[topic](topic, data);
-  }
-}
-
-module.exports = EventDebouncer;
+'use strict';
+
+const {debounce} = require('lodash');
+
+class EventDebouncer {
+  constructor(resp, wait = 1000) {
+    this.debouncers = {};
+    this.wait = wait;
+    this.resp = resp;
+  }
+
+  publish(topic, data) {
+    if (!this.debouncers[topic]) {
+      const send = (topic, data) => this.resp.events.send(topic, data);
+      this.debouncers[topic] = debounce(send, this.wait);
+    }
+    this.debouncers[topic](topic, data);
+  }
+}
+
+module.exports = EventDebouncer;