@qrvey/utils 1.1.0-9 → 1.1.2-1

package/dist/cjs/general/array/delete.d.ts

@@ -1,7 +1,7 @@
 /**
  * Inmutable Array Item deletion
- * @param {Array} array List to loo for item to delte
- * @param {Number} index position of item to delete
- * @return new Array
+ * @param {Array} array a collection of items to delete
+ * @param {Number} index the position of the item to delete
+ * @returns a new Array or the given parameter when is empty or not an array
  */
-export declare function ArrayDelete(array: Array<any>, index: number): any[];
+export declare function ArrayDelete<T = Array<any>>(arr: T[], index: number): T[];

package/dist/cjs/general/array/delete.js

@@ -1,14 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ArrayDelete = void 0;
+const mix_1 = require("../mix");
 /**
  * Inmutable Array Item deletion
- * @param {Array} array List to loo for item to delte
- * @param {Number} index position of item to delete
- * @return new Array
+ * @param {Array} array a collection of items to delete
+ * @param {Number} index the position of the item to delete
+ * @returns a new Array or the given parameter when is empty or not an array
  */
-function ArrayDelete(array, index) {
-    return array.slice(0, index).concat(array.slice(index + 1));
+function ArrayDelete(arr, index) {
+    if (mix_1.isEmpty(index) || mix_1.isEmpty(arr) || !Array.isArray(arr))
+        return arr;
+    return arr.slice(0, index).concat(arr.slice(index + 1));
 }
 exports.ArrayDelete = ArrayDelete;
-;

package/dist/cjs/general/array/filterNestedTree.js

@@ -10,7 +10,7 @@ const cloneDeep_1 = require("../object/cloneDeep");
  * @param condition function callback that determines if the filter is applied on the last child node of the nested tree
  * @returns array filtered
  */
-function filterNestedTree(arr = [], childArrKey, condition) {
+function filterNestedTree(arr, childArrKey, condition) {
     if (mix_1.isEmpty(arr))
         return [];
     return cloneDeep_1.cloneDeep(arr).filter(obj => {

package/dist/cjs/general/array/flattenDeep.d.ts

@@ -3,4 +3,4 @@
  * @param arr Array to flat deeply
  * @returns flatten array
  */
-export declare function flattenDeep(arr: any): any;
+export declare function flattenDeep(arr?: any[]): any[];

package/dist/cjs/general/array/flattenDeep.js

@@ -6,7 +6,9 @@ exports.flattenDeep = void 0;
  * @param arr Array to flat deeply
  * @returns flatten array
  */
-function flattenDeep(arr) {
-    return arr.reduce((acc, val) => Array.isArray(val) ? acc.concat(flattenDeep(val)) : acc.concat(val), []);
+function flattenDeep(arr = []) {
+    if (Array.isArray(arr))
+        return arr.reduce((acc, val) => Array.isArray(val) ? acc.concat(flattenDeep(val)) : acc.concat(val), []);
+    return undefined;
 }
 exports.flattenDeep = flattenDeep;

package/dist/cjs/general/array/getFirstIndexFromArray.d.ts

@@ -4,4 +4,4 @@
  * @param callback function callback
  * @returns the first index of the array. -1 when the condition is not satisfied
  */
-export declare function getFirstIndexFromArray(array: any[], callback: any): number;
+export declare function getFirstIndexFromArray(array?: any[], callback?: (item: any) => boolean): number;

package/dist/cjs/general/array/getFirstIndexFromArray.js

@@ -9,11 +9,13 @@ exports.getFirstIndexFromArray = void 0;
  */
 function getFirstIndexFromArray(array = [], callback) {
     let firstArrayIndex = -1;
-    for (let i = 0; i < array.length; i++) {
-        const condition = callback(array[i]);
-        if (condition) {
-            firstArrayIndex = i;
-            break;
+    if (Array.isArray(array) && callback instanceof Function) {
+        for (let i = 0; i < array.length; i++) {
+            const condition = callback(array[i]);
+            if (condition) {
+                firstArrayIndex = i;
+                break;
+            }
         }
     }
     return firstArrayIndex;

package/dist/cjs/general/array/getLastIndexFromArray.d.ts

@@ -4,4 +4,4 @@
  * @param callback function callback
  * @returns the last index of the array. -1 when the condition is not satisfied
  */
-export declare function getLastIndexFromArray(array: any[], callback: any): number;
+export declare function getLastIndexFromArray(array?: any[], callback?: (item: any) => boolean): number;

package/dist/cjs/general/array/getLastIndexFromArray.js

@@ -9,10 +9,12 @@ exports.getLastIndexFromArray = void 0;
  */
 function getLastIndexFromArray(array = [], callback) {
     let lastArrayIndex = -1;
-    for (let i = 0; i < array.length; i++) {
-        const condition = callback(array[i]);
-        if (condition) {
-            lastArrayIndex = i;
+    if (Array.isArray(array) && callback instanceof Function) {
+        for (let i = 0; i < array.length; i++) {
+            const condition = callback(array[i]);
+            if (condition) {
+                lastArrayIndex = i;
+            }
         }
     }
     return lastArrayIndex;

package/dist/cjs/general/function/debounce.d.ts

@@ -4,4 +4,4 @@
  * @param {Number} time default 500ms
  * @returns {Function} debounced functions
  */
-export declare function debounce(fn: Function, time?: number): (...args: any) => void;
+export declare function debounce(fn: any, time?: number): (...args: any) => void;

package/dist/cjs/general/function/throttled.d.ts

@@ -4,4 +4,4 @@
  * @param {Number} time default 500ms
  * @returns {Function} throttled function
  */
-export declare function throttled(fn: Function, delay?: number): (...args: any) => any;
+export declare function throttled(fn: any, delay?: number): (...args: any) => any;

package/dist/cjs/general/function/throttled.js

@@ -10,7 +10,7 @@ exports.throttled = void 0;
 function throttled(fn, delay = 500) {
     let lastCall = 0;
     return (...args) => {
-        const now = (new Date()).getTime();
+        const now = new Date().getTime();
         if (now - lastCall < delay) {
             return;
         }

package/dist/cjs/general/mix/importScripts.d.ts

@@ -44,7 +44,7 @@ export declare function importScripts(scripts: TScriptItem[]): any;
 export declare function loadScript(url: string, type?: TScriptType, noModule?: boolean): Promise<void>;
 export interface IScriptItem {
     url: string;
-    namespace?: string | Function;
+    namespace?: string | any;
     dependencies?: IScriptItem[];
     noModule?: boolean;
     type?: string;

package/dist/cjs/general/mix/isEmpty.d.ts

@@ -1,6 +1,7 @@
 /**
- * return if an String, object or string is empty or not
- * @param {Any} obj
- * @returns {boolean}
+ * Validates if the given argument is empty
+ * @param variable the given variable
+ * @param includeFalsy flag to determine include the falsy variables into the validation
+ * @returns true: the given argument is empty; false: is not.
  */
-export declare function isEmpty(obj: object | any[] | string): boolean;
+export declare function isEmpty<T = any>(variable: T, includeFalsy?: boolean): boolean;

package/dist/cjs/general/mix/isEmpty.js

@@ -1,13 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isEmpty = void 0;
-const size_1 = require("./size");
 /**
- * return if an String, object or string is empty or not
- * @param {Any} obj
- * @returns {boolean}
+ * Validates if the given argument is empty
+ * @param variable the given variable
+ * @param includeFalsy flag to determine include the falsy variables into the validation
+ * @returns true: the given argument is empty; false: is not.
  */
-function isEmpty(obj) {
-    return size_1.size(obj) === 0;
+function isEmpty(variable, includeFalsy = false) {
+    return typeof variable == 'undefined'
+        || variable == null
+        || (typeof variable == 'number' && includeFalsy && (Number(variable) === 0 || Object.is(variable, -0) || isNaN(variable)))
+        || (typeof variable == 'string' && variable === "")
+        || (typeof variable == 'boolean' && includeFalsy && variable === false)
+        || (Array.isArray(variable) && variable.length === 0)
+        || (variable.constructor === Object && Object.entries(variable).length === 0);
 }
 exports.isEmpty = isEmpty;

package/dist/cjs/general/mix/randomId.d.ts

@@ -3,4 +3,4 @@
  * @param {Number} length size of the generated string. Default 8
  * @return {String}
  */
-export declare function randomId(length?: number): string;
+export declare function randomId(_length?: number): string;

package/dist/cjs/general/mix/randomId.js

@@ -6,7 +6,7 @@ exports.randomId = void 0;
  * @param {Number} length size of the generated string. Default 8
  * @return {String}
  */
-function randomId(length = 8) {
+function randomId(_length = 8) {
     const charSet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_';
     let id = '';
     for (let i = 0; i < 8; i++) {
@@ -16,4 +16,3 @@ function randomId(length = 8) {
     return id;
 }
 exports.randomId = randomId;
-;

package/dist/cjs/general/mix/size.d.ts

@@ -5,4 +5,4 @@
  * @param {Any} obj
  * @returns {Number}
  */
-export declare function size(obj: object | any[] | string): number;
+export declare function size(obj: any): number;

package/dist/cjs/general/object/cloneDeep.d.ts

@@ -1,7 +1,7 @@
 /**
- * A asimple deepclone function
- * Avoid to use this that including functions as properties
+ * A simple Deep Cloning function. Valid only for primivite values and object with primitive values.
+ * Not to use this function with inner objects and functions
  * @param obj The object
- * @returns The new reference object
+ * @returns The new reference object or the given object if the parsing is incorrect or empty
  */
-export declare const cloneDeep: <T = any>(obj: T) => T;
+export declare function cloneDeep<T = any>(obj: T): T;

package/dist/cjs/general/object/cloneDeep.js

@@ -1,13 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cloneDeep = void 0;
+const mix_1 = require("../mix");
 /**
- * A asimple deepclone function
- * Avoid to use this that including functions as properties
+ * A simple Deep Cloning function. Valid only for primivite values and object with primitive values.
+ * Not to use this function with inner objects and functions
  * @param obj The object
- * @returns The new reference object
+ * @returns The new reference object or the given object if the parsing is incorrect or empty
  */
-const cloneDeep = (obj) => {
-    return JSON.parse(JSON.stringify(obj));
-};
+function cloneDeep(obj) {
+    if (mix_1.isEmpty(obj))
+        return obj;
+    const stringObject = JSON.stringify(obj);
+    if (!mix_1.isEmpty(stringObject)) {
+        const parsedObject = JSON.parse(stringObject);
+        return !mix_1.isEmpty(parsedObject) ? parsedObject : obj;
+    }
+    return obj;
+}
 exports.cloneDeep = cloneDeep;

package/dist/cjs/general/object/get.d.ts

@@ -1,17 +1,49 @@
 /**
-  * Gets the value at `path` of `obj`. If the resolved value is _undefined_, the `def` is returned in its place.
-  * @param obj
-  * @param path
-  * @param def
-  *
-  * @example
-  *  const object = { 'a': [{ 'b': { 'c': 3 } }] };
-  *  get(object, 'a[0].b.c'); // => 3
-  *  get(object, 'a.b.c', 'default'); // => 'default'
-  * @deprecated
-  */
-export declare function get(obj: object, path: string, def?: any): any;
+ * Like lodash _.get.
+ * Gets the value at path of object. If the resolved value is undefined, the defaultValue is returned in its place.
+ *
+ * Empty arrays and empty objects are returned but the defaultValue is not
+ * Undefined and null values will return the defaultValue.
+ *
+ * @param baseObject The object to query
+ * @param path The string path or collection of string paths of the property to get.
+ * @param defaultValue The value returned for undefined resolved values.
+ *
+ * @example
+ * // returns 'Hello'
+ * _get({ item1: 'Hello', item2: 'World' }, 'item1')
+ * @example
+ * // returns 'A simple Hello'
+ * _get({ item1: 'Hello', item2: 'World' }, 'item3', 'A simple Hello')
+ * @example
+ * // returns 'Hello Again'
+ * _get({ item1: { item11: 'Hello Again' }, item2: {} }, 'item1.item11')
+ * @example
+ * // returns 'Hello 2'
+ * _get({ item1: ['Hello 1', 'Hello 2' }, item2: [] }, 'item1[1]')
+ * @example
+ * // returns 'Hello Again'
+ * _get({ item1: { item11: 'Hello Again' }, item2: {} }, ['item1', 'item11'])
+ * @returns the resolved value.
+ */
+export declare function _get(baseObject: any, path: string | string[], defaultValue?: any): any;
 /**
-* Like lodash _.get
-*/
-export declare const _get: (baseObject: any, key: string, fallback?: any) => any;
+ *
+ * /**
+ * Like lodash _.get.
+ * Gets the value at path of object. If the resolved value is undefined, the defaultValue is returned in its place.
+ * @param baseObject The object to query
+ * @param path The path of the property to get.
+ * @param defaultValue The value returned for undefined resolved values.
+ * @returns the resolved value.
+ export function get(baseObject: any, path: string, defaultValue?: any): any {
+  function fn() {
+    try {
+      const value = eval(`this.${path}`.replace('.[', '['));
+      return typeof value !== 'undefined' ? value : defaultValue;
+    } catch (e) { return defaultValue; }
+  }
+  return fn.apply(baseObject, null);
+}
+
+ */ 

package/dist/cjs/general/object/get.js

@@ -1,43 +1,67 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._get = exports.get = void 0;
+exports._get = void 0;
 /**
-  * Gets the value at `path` of `obj`. If the resolved value is _undefined_, the `def` is returned in its place.
-  * @param obj
-  * @param path
-  * @param def
-  *
-  * @example
-  *  const object = { 'a': [{ 'b': { 'c': 3 } }] };
-  *  get(object, 'a[0].b.c'); // => 3
-  *  get(object, 'a.b.c', 'default'); // => 'default'
-  * @deprecated
-  */
-function get(obj, path, def) {
-    let out;
-    const pathList = path.replace(/\[/g, '.').replace(/]/g, '').split('.');
-    for (const p of pathList) {
-        out = (out || obj)[p];
-        if (out === undefined)
-            return def;
+ * Like lodash _.get.
+ * Gets the value at path of object. If the resolved value is undefined, the defaultValue is returned in its place.
+ *
+ * Empty arrays and empty objects are returned but the defaultValue is not
+ * Undefined and null values will return the defaultValue.
+ *
+ * @param baseObject The object to query
+ * @param path The string path or collection of string paths of the property to get.
+ * @param defaultValue The value returned for undefined resolved values.
+ *
+ * @example
+ * // returns 'Hello'
+ * _get({ item1: 'Hello', item2: 'World' }, 'item1')
+ * @example
+ * // returns 'A simple Hello'
+ * _get({ item1: 'Hello', item2: 'World' }, 'item3', 'A simple Hello')
+ * @example
+ * // returns 'Hello Again'
+ * _get({ item1: { item11: 'Hello Again' }, item2: {} }, 'item1.item11')
+ * @example
+ * // returns 'Hello 2'
+ * _get({ item1: ['Hello 1', 'Hello 2' }, item2: [] }, 'item1[1]')
+ * @example
+ * // returns 'Hello Again'
+ * _get({ item1: { item11: 'Hello Again' }, item2: {} }, ['item1', 'item11'])
+ * @returns the resolved value.
+ */
+function _get(baseObject, path, defaultValue) {
+    if (validateToReturnDefaultValue(baseObject, path))
+        return defaultValue;
+    const keys = Array.isArray(path) ? path : path.replace(/(\[(\d)\])/g, '.$2').split('.').filter(k => k.length);
+    baseObject = baseObject[keys[0]];
+    if (baseObject !== undefined && keys.length > 1) {
+        return _get(baseObject, keys.slice(1), defaultValue);
     }
-    return out;
+    return baseObject === undefined ? defaultValue : baseObject;
 }
-exports.get = get;
-/**
-* Like lodash _.get
-*/
-const _get = (baseObject, key, fallback) => {
-    function fn() {
-        try {
-            // tslint:disable-next-line:no-eval
-            const value = eval(`this.${key}`.replace('.[', '['));
-            return typeof value !== 'undefined' ? value : fallback;
-        }
-        catch (e) {
-            return fallback;
-        }
-    }
-    return fn.apply(baseObject, null);
-};
 exports._get = _get;
+function validateToReturnDefaultValue(baseObject, path) {
+    return baseObject == null ||
+        path == null ||
+        (typeof path !== 'string' && !Array.isArray(path));
+}
+/**
+ *
+ * /**
+ * Like lodash _.get.
+ * Gets the value at path of object. If the resolved value is undefined, the defaultValue is returned in its place.
+ * @param baseObject The object to query
+ * @param path The path of the property to get.
+ * @param defaultValue The value returned for undefined resolved values.
+ * @returns the resolved value.
+ export function get(baseObject: any, path: string, defaultValue?: any): any {
+  function fn() {
+    try {
+      const value = eval(`this.${path}`.replace('.[', '['));
+      return typeof value !== 'undefined' ? value : defaultValue;
+    } catch (e) { return defaultValue; }
+  }
+  return fn.apply(baseObject, null);
+}
+
+ */ 

package/dist/cjs/general/object/getAttribute.d.ts

@@ -7,4 +7,4 @@
  * @example
  * getAttribute(obj, 'snake_case') //it search for: obj.snake_case || obj.snakeCase || obj.SnakeCase || obj.snakecase || obj.SNAKECASE
  */
-export declare function getAttribute(obj: object, key: string): any;
+export declare function getAttribute(obj: any, key: string): any;

package/dist/cjs/general/object/hasProperty.d.ts

@@ -14,4 +14,4 @@
  * const obj2 = { prop1: 'hello world' }
  * _hasProperty(ob1, prop2) // false
  */
-export declare function _hasProperty(obj: {}, property: string): boolean;
+export declare function _hasProperty(obj?: {}, property?: string): boolean;