@blackbyte/sugar 1.0.0-beta.1

package/dist/shared/object/getGlob.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @name                        getGlob
+ * @namespace                   shared.object
+ * @type                        Function
+ * @platform                    js
+ * @platform                    node
+ * @status                      stable
+ *
+ * Retreive an object value using a dotted path like "myObject.myProperty.myValue".
+ * It support glob patterns like "something.*.id" and returns you a new object containing
+ * all values with the path that matches the passed glob pattern.
+ *
+ * @param               {Object}                 obj                The object in which to set the value
+ * @param               {String}                glob                A glob to describe what you want into the object
+ * @param               {Object}            [settings={}]           A settings object to configure your glob get process
+ * @return              {Mixed}                                     The getted value or "undefined" if nothing found...
+ *
+ * @setting         {Boolean}               [unflatten=true]          Specify if you want the result object to be unflattend using the ```unflatten``` sugar function
+ *
+ * @todo      tests
+ *
+ * @snippet         getGlob($1, $2)
+ *
+ * @example             js
+ * import { getGlob } from '@blackbyte/sugar/object';
+ * getGlob({
+ *  hello: {
+ *     world: true,
+ *     plop: false
+ * }, 'hello.*');
+ *
+ * @since     1.0.0
+ * @author  Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TGetGlobSettings = {
+    unflatten?: boolean;
+};
+export default function getGlob(obj: any, glob: string, settings?: TGetGlobSettings): any;

package/dist/shared/object/getGlob.js

@@ -0,0 +1,17 @@
+import { minimatch as __minimatch } from 'minimatch';
+import unflatten from './unflatten.js';
+import flatten from './flatten.js';
+export default function getGlob(obj, glob, settings = {}) {
+    settings = Object.assign({ unflatten: true }, settings);
+    const flat = flatten(obj);
+    const resultObj = {};
+    Object.keys(flat).forEach((path) => {
+        if (__minimatch(path, glob)) {
+            resultObj[path] = flat[path];
+        }
+    });
+    if (settings.unflatten === true)
+        return unflatten(resultObj);
+    return resultObj;
+}
+//# sourceMappingURL=getGlob.js.map

package/dist/shared/object/getGlob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getGlob.js","sourceRoot":"","sources":["../../../src/shared/object/getGlob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,OAAO,MAAM,cAAc,CAAC;AAwCnC,MAAM,CAAC,OAAO,UAAU,OAAO,CAC7B,GAAQ,EACR,IAAY,EACZ,WAA6B,EAAE;IAE/B,QAAQ,mBACN,SAAS,EAAE,IAAI,IACZ,QAAQ,CACZ,CAAC;IAEF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE1B,MAAM,SAAS,GAAG,EAAE,CAAC;IAErB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACjC,IAAI,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YAC5B,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7D,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/shared/object/getKeyByValue.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @name                getKeyByValue
+ * @namespace           shared.object
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Return the key that correspond to the passed value in the passed object
+ *
+ * @param         {Object}        object        The object in which to search for the value
+ * @param         {Mixed}         value         The value to find in the object
+ * @return        {String}                      The key of the wanted value or false if not found
+ *
+ * @todo      tests
+ *
+ * @snippet         getKeyByValue($1, $2)
+ *
+ * @example       js
+ * import { getKeyByValue } from '@blackbyte/sugar/object';
+ * getKeyByValue({ hello: 'world' }, 'world'); // => hello
+ *
+ * @since     1.0.0
+ * @author  Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function getKeyByValue(object: any, value: any): any;

package/dist/shared/object/getKeyByValue.js

@@ -0,0 +1,29 @@
+/**
+ * @name                getKeyByValue
+ * @namespace           shared.object
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Return the key that correspond to the passed value in the passed object
+ *
+ * @param         {Object}        object        The object in which to search for the value
+ * @param         {Mixed}         value         The value to find in the object
+ * @return        {String}                      The key of the wanted value or false if not found
+ *
+ * @todo      tests
+ *
+ * @snippet         getKeyByValue($1, $2)
+ *
+ * @example       js
+ * import { getKeyByValue } from '@blackbyte/sugar/object';
+ * getKeyByValue({ hello: 'world' }, 'world'); // => hello
+ *
+ * @since     1.0.0
+ * @author  Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function getKeyByValue(object, value) {
+    return Object.keys(object).find((key) => object[key] === value);
+}
+//# sourceMappingURL=getKeyByValue.js.map

package/dist/shared/object/getKeyByValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getKeyByValue.js","sourceRoot":"","sources":["../../../src/shared/object/getKeyByValue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,MAAW,EAAE,KAAU;IAC3D,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC;AAClE,CAAC"}

package/dist/shared/object/map.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @name                    map
+ * @namespace               shared.object
+ * @type                    Function
+ * @platform                js
+ * @platform                node
+ * @status                  stable
+ *
+ * This is the same function as the "Array.map" but for objects. It will iterate over all the properties
+ * of the passed object and pass the value to your process function. It will then save the property
+ * with your processed value
+ *
+ * @param           {Object}            object          The object to process
+ * @param           {Function}          processor       The processor function that will take as parameters the current property value and the property name
+ * @return          {Object}                            The processed object
+ *
+ * @todo      tests
+ *
+ * @snippet         map($1, $2)
+ * map($1, ({value, prop}) => {
+ *      $2
+ * })
+ *
+ * @example         js
+ * import { map } from '@blackbyte/sugar/object';
+ * const myObject = {
+ *    hello: 'world',
+ *    cat: 'Nelson'
+ * };
+ * map(myObject, ({value, prop}) => {
+ *    return prop === 'hello' ? 'universe' : value;
+ * });
+ * {
+ *    hello: 'universe',
+ *    cat: 'Nelson'
+ * }
+ *
+ * @since       1.0.0
+ * @author  Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TMapObjProcessorArg = {
+    value: any;
+    key: string;
+    prop: string;
+    i: number;
+    idx: number;
+};
+export default function map(object: any, processor: (item: TMapObjProcessorArg) => any): any;

package/dist/shared/object/map.js

@@ -0,0 +1,58 @@
+/**
+ * @name                    map
+ * @namespace               shared.object
+ * @type                    Function
+ * @platform                js
+ * @platform                node
+ * @status                  stable
+ *
+ * This is the same function as the "Array.map" but for objects. It will iterate over all the properties
+ * of the passed object and pass the value to your process function. It will then save the property
+ * with your processed value
+ *
+ * @param           {Object}            object          The object to process
+ * @param           {Function}          processor       The processor function that will take as parameters the current property value and the property name
+ * @return          {Object}                            The processed object
+ *
+ * @todo      tests
+ *
+ * @snippet         map($1, $2)
+ * map($1, ({value, prop}) => {
+ *      $2
+ * })
+ *
+ * @example         js
+ * import { map } from '@blackbyte/sugar/object';
+ * const myObject = {
+ *    hello: 'world',
+ *    cat: 'Nelson'
+ * };
+ * map(myObject, ({value, prop}) => {
+ *    return prop === 'hello' ? 'universe' : value;
+ * });
+ * {
+ *    hello: 'universe',
+ *    cat: 'Nelson'
+ * }
+ *
+ * @since       1.0.0
+ * @author  Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function map(object, processor) {
+    for (let i = 0; i < Object.keys(object).length; i++) {
+        const prop = Object.keys(object)[i];
+        const res = processor({
+            value: object[prop],
+            key: prop,
+            prop,
+            i,
+            idx: i,
+        });
+        if (res === -1)
+            delete object[prop];
+        else
+            object[prop] = res;
+    }
+    return object;
+}
+//# sourceMappingURL=map.js.map

package/dist/shared/object/map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../../src/shared/object/map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAUH,MAAM,CAAC,OAAO,UAAU,GAAG,CACzB,MAAW,EACX,SAA6C;IAE7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,SAAS,CAAC;YACpB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC;YACnB,GAAG,EAAE,IAAI;YACT,IAAI;YACJ,CAAC;YACD,GAAG,EAAE,CAAC;SACP,CAAC,CAAC;QACH,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;;YAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;IAC1B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/shared/object/mapDeep.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @name                mapDeep
+ * @namespace           shared.object
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * This function is the same as the "map" one. The only difference is that this one goes deep into the object
+ *
+ * @param         {Object}        object          The object you want to map through
+ * @param         {Function}      processor       The processor function that take as parameter the actual property value, the current property name and the full dotted path to the current property
+ * @param         {Object}        [settings={}]     An object of settings to configure your mapDeep process:
+ *
+ * @setting    {Boolean}              [classInstances=false]            Specify if you want the objects to be processed the same as other values
+ * @setting         {Boolean}       [array=true]                    Specify if we want to process also arrays or not
+ * @setting         {Boolean}       [clone=false]          Specify if you want to clone the object passed before cleaning it
+ * @setting         {Boolean}      [privateProps=true]     Specify if you want to clean also the private properties that starts with "_"
+ *
+ * @todo      tests
+ *
+ * @snippet         mapDeep($1, $2)
+ * mapDeep($1, ({object, prop, value, path}) => {
+ *      $2
+ * })
+ *
+ * @example       js
+ * import { mapDeep } from '@blackbyte/sugar/object';
+ * mapDeep({
+ *    hello: 'world'
+ * }, ({object, prop, value, path}) => {
+ *    return '~ ' + value;
+ * });
+ *
+ * @since       1.0.0
+ * @author  Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TMapDeepSettings = {
+    classInstances?: boolean;
+    array?: boolean;
+    clone?: boolean;
+    privateProps?: boolean;
+};
+export default function mapDeep(objectOrArray: any, processor?: Function, settings?: TMapDeepSettings, _path?: never[]): any;

package/dist/shared/object/mapDeep.js

@@ -0,0 +1,59 @@
+import isClassInstance from '../is/isClassInstance.js';
+import isPlainObject from '../is/isPlainObject.js';
+import clone from './clone.js';
+export default function mapDeep(objectOrArray, processor, settings, _path = []) {
+    settings = Object.assign({ classInstances: false, array: true, clone: false, privateProps: true }, settings);
+    const isArray = Array.isArray(objectOrArray);
+    let newObject = isArray
+        ? []
+        : (settings === null || settings === void 0 ? void 0 : settings.clone)
+            ? clone(objectOrArray, { deep: true })
+            : objectOrArray;
+    Object.keys(objectOrArray).forEach((prop) => {
+        if (!(settings === null || settings === void 0 ? void 0 : settings.privateProps) && prop.match(/^_/))
+            return;
+        if (isPlainObject(objectOrArray[prop]) ||
+            (isClassInstance(objectOrArray[prop]) && (settings === null || settings === void 0 ? void 0 : settings.classInstances)) ||
+            (Array.isArray(objectOrArray[prop]) && (settings === null || settings === void 0 ? void 0 : settings.array))) {
+            const res = mapDeep(objectOrArray[prop], processor, Object.assign(Object.assign({}, settings), { clone: false }), 
+            // @ts-ignore
+            [..._path, prop]);
+            if (isArray) {
+                newObject.push(res);
+            }
+            else {
+                if (prop === '...' && isPlainObject(res)) {
+                    newObject = Object.assign(Object.assign({}, newObject), res);
+                }
+                else {
+                    newObject[prop] = res;
+                }
+            }
+            return;
+        }
+        const res = processor === null || processor === void 0 ? void 0 : processor({
+            object: objectOrArray,
+            prop,
+            value: objectOrArray[prop],
+            path: [..._path, prop].join('.'),
+        });
+        if (res === -1) {
+            delete newObject[prop];
+            return;
+        }
+        if (isArray) {
+            newObject.push(res);
+        }
+        else {
+            if (prop === '...' && isPlainObject(res)) {
+                // console.log('DEFEF', res);
+                newObject = Object.assign(Object.assign({}, newObject), res);
+            }
+            else {
+                newObject[prop] = res;
+            }
+        }
+    });
+    return newObject;
+}
+//# sourceMappingURL=mapDeep.js.map

package/dist/shared/object/mapDeep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapDeep.js","sourceRoot":"","sources":["../../../src/shared/object/mapDeep.ts"],"names":[],"mappings":"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"}

package/dist/shared/object/merge.d.ts

@@ -0,0 +1 @@
+export default function (...args: any[]): any;

package/dist/shared/object/merge.js

@@ -0,0 +1,65 @@
+/**
+ * @name                merge
+ * @namespace           shared.object
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Merge one object with another and return the merged object result. This merging implementation support:
+ * - Merging object with getters/setters
+ * - n numbers of objects as arguments
+ *
+ * @param           {Object}            args...        Pass all the objects you want to merge
+ * @return          {Object}                              The merged object result
+ *
+ * @todo      tests
+ *
+ * @snippet         merge($1, $2)
+ *
+ * @example           js
+ * import { merge } from '@blackbyte/sugar/object';
+ * merge({a: 'hello'}, {a: 'plop', hello: 'world');
+ *
+ * @since       1.0.0
+ * @author  Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+function _merge(firstObj, secondObj) {
+    const newObj = {};
+    if (!firstObj && secondObj)
+        return secondObj;
+    if (!secondObj && firstObj)
+        return firstObj;
+    if (!firstObj && !secondObj)
+        return {};
+    const firstProps = Object.getOwnPropertyNames(firstObj);
+    firstProps.forEach((key) => {
+        const desc = Object.getOwnPropertyDescriptor(firstObj, key);
+        if ((desc === null || desc === void 0 ? void 0 : desc.set) || (desc === null || desc === void 0 ? void 0 : desc.get)) {
+            Object.defineProperty(newObj, key, desc);
+        }
+        else {
+            newObj[key] = firstObj[key];
+        }
+    });
+    const secondProps = Object.getOwnPropertyNames(secondObj);
+    secondProps.forEach((key) => {
+        const desc = Object.getOwnPropertyDescriptor(secondObj, key);
+        if ((desc === null || desc === void 0 ? void 0 : desc.set) || (desc === null || desc === void 0 ? void 0 : desc.get)) {
+            Object.defineProperty(newObj, key, desc);
+        }
+        else {
+            newObj[key] = secondObj[key];
+        }
+    });
+    return newObj;
+}
+export default function (...args) {
+    let currentObj = {};
+    for (let i = 0; i < args.length; i++) {
+        const toMergeObj = args[i];
+        currentObj = _merge(currentObj, toMergeObj);
+    }
+    return currentObj;
+}
+//# sourceMappingURL=merge.js.map

package/dist/shared/object/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../../src/shared/object/merge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAS,MAAM,CAAC,QAAQ,EAAE,SAAS;IACjC,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC,QAAQ,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,CAAC,SAAS,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC5C,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAEvC,MAAM,UAAU,GAAG,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACxD,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,wBAAwB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC5D,IAAI,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,GAAG,MAAI,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,GAAG,CAAA,EAAE,CAAC;YAC3B,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC1D,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,wBAAwB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,GAAG,MAAI,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,GAAG,CAAA,EAAE,CAAC;YAC3B,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,OAAO,WAAW,GAAG,IAAI;IAC9B,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,UAAU,GAAG,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/shared/object/mergeDeep.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @name                    mergeDeep
+ * @namespace               shared.object
+ * @type                    Function
+ * @platform                js
+ * @platform                node
+ * @status                  stable
+ *
+ * Deep merge one object with another and return the merged object result. This merging implementation support:
+ * - Merging object with getters/setters
+ * - n numbers of objects as arguments
+ * - Choose beetween cloning first (default) the object or keeping the first passed object as result
+ * Note that by default the resulting object is a clone and do not have the same reference that the first passed object.
+ *
+ * @param           {any[]}                             objects             Pass all the objects you want to merge
+ * @param           {TMergeDeepSettings}                [settings={}]       Some settings to configure your merging process
+ * @return          {Object}                                                The merged object result
+ *
+ * @setting         {Boolean}           [array=false]           Merge or not arrays
+ * @setting         {Boolean}           [clone=true]            Specify if you want the result object to be a clone or the same first passed object
+ *
+ * @feature         Support array merging by passing the last parameter as the { array: true } object
+ * @feature         Support merging object with getters. Can access the source object from the second object property getter using the `this.$source` property
+ *
+ * @todo      tests
+ *
+ * @snippet         mergeDeep($1, $2)
+ *
+ * @example           js
+ * import { mergeDeep } from '@blackbyte/sugar/object';
+ * mergeDeep([{a: {b: {c: 'c', d: 'd'}}}, {a: {b: {e: 'e', f: 'f'}}}]);
+ * // => { a: { b: { c: 'c', d: 'd', e: 'e', f: 'f' } } }
+ *
+ * @since       1.0.0
+ * @author  Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TMergeDeepSettings = {
+    array?: boolean;
+    clone?: boolean;
+};
+export default function mergeDeep(objects: any[], settings?: TMergeDeepSettings): any;

package/dist/shared/object/mergeDeep.js

@@ -0,0 +1,45 @@
+import isPlainObject from '../is/isPlainObject.js';
+export default function mergeDeep(objects, settings) {
+    const finalSettings = Object.assign({ array: false, clone: true }, (settings !== null && settings !== void 0 ? settings : {}));
+    function merge(firstObj, secondObj) {
+        const newObj = finalSettings.clone ? {} : firstObj;
+        if (!secondObj)
+            return firstObj;
+        const firstProps = Object.getOwnPropertyNames(firstObj);
+        firstProps.forEach((key) => {
+            const desc = Object.getOwnPropertyDescriptor(firstObj, key);
+            if ((desc === null || desc === void 0 ? void 0 : desc.set) || (desc === null || desc === void 0 ? void 0 : desc.get)) {
+                Object.defineProperty(newObj, key, desc);
+            }
+            else {
+                newObj[key] = firstObj[key];
+            }
+        });
+        const secondProps = Object.getOwnPropertyNames(secondObj);
+        secondProps.forEach((key) => {
+            const secondObjDesc = Object.getOwnPropertyDescriptor(secondObj, key);
+            if ((secondObjDesc === null || secondObjDesc === void 0 ? void 0 : secondObjDesc.set) || (secondObjDesc === null || secondObjDesc === void 0 ? void 0 : secondObjDesc.get)) {
+                Object.defineProperty(newObj, key, secondObjDesc);
+            }
+            else if (finalSettings.array &&
+                Array.isArray(firstObj[key]) &&
+                Array.isArray(secondObj[key])) {
+                newObj[key] = [...firstObj[key], ...secondObj[key]];
+            }
+            else if (isPlainObject(newObj[key]) && isPlainObject(secondObj[key])) {
+                newObj[key] = merge(newObj[key], secondObj[key]);
+            }
+            else {
+                newObj[key] = secondObj[key];
+            }
+        });
+        return newObj;
+    }
+    let currentObj = finalSettings.clone ? {} : objects[0];
+    for (let i = 0; i < objects.length; i++) {
+        const toMergeObj = objects[i];
+        currentObj = merge(currentObj, toMergeObj);
+    }
+    return currentObj;
+}
+//# sourceMappingURL=mergeDeep.js.map

package/dist/shared/object/mergeDeep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeDeep.js","sourceRoot":"","sources":["../../../src/shared/object/mergeDeep.ts"],"names":[],"mappings":"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"}

package/dist/shared/object/objectHash.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @name            objectHash
+ * @namespace       shared.object
+ * @type            Function
+ * @platform        js
+ * @platform        node
+ * @status          stable
+ *
+ * This function allows you to get back an integrity hash of the passed object.
+ *
+ * @param           {any}            obj                The object to hash
+ * @return          {String}                            The calculated folder hash
+ *
+ * @snippet             objectHash($1)
+ *
+ * @todo    tests
+ *
+ * @example         js
+ * import { objectHash } from '@blackbyte/sugar/object';
+ * objectHash({
+ *   hello: 'world'
+ * }); // => YZOrKDx9LCLd8X39PoFTflXGpRU=,
+ *
+ * @see             https://www.npmjs.com/package/hash-sum
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function objectHash(obj: any): string;

package/dist/shared/object/objectHash.js

@@ -0,0 +1,32 @@
+import hashSum from 'hash-sum';
+/**
+ * @name            objectHash
+ * @namespace       shared.object
+ * @type            Function
+ * @platform        js
+ * @platform        node
+ * @status          stable
+ *
+ * This function allows you to get back an integrity hash of the passed object.
+ *
+ * @param           {any}            obj                The object to hash
+ * @return          {String}                            The calculated folder hash
+ *
+ * @snippet             objectHash($1)
+ *
+ * @todo    tests
+ *
+ * @example         js
+ * import { objectHash } from '@blackbyte/sugar/object';
+ * objectHash({
+ *   hello: 'world'
+ * }); // => YZOrKDx9LCLd8X39PoFTflXGpRU=,
+ *
+ * @see             https://www.npmjs.com/package/hash-sum
+ * @since           1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function objectHash(obj) {
+    return hashSum(obj);
+}
+//# sourceMappingURL=objectHash.js.map

package/dist/shared/object/objectHash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectHash.js","sourceRoot":"","sources":["../../../src/shared/object/objectHash.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,UAAU,CAAC;AAC/B;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,GAAQ;IACzC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC"}

package/dist/shared/object/propertyProxy.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @name                propertyProxy
+ * @namespace           shared.object
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              beta
+ * @private
+ *
+ * Create a proxy for and object property.
+ * This gives you the possibility to process the data of the property
+ * when it is getted or setted.
+ *
+ * @param 		{Object} 		  obj 			        The object on which to create the proxy
+ * @param 		{String} 	  	property 		      The property name that will be proxied
+ * @param 		{Object} 		  descriptor 		    A descriptor object that contains at least a get or a set method, or both
+ * @param 		{Boolean} 		[applySetterAtStart=false] 	If need to apply the descriptor setter directly on the current value or not
+ *
+ * @todo      tests
+ *
+ * @example 	js
+ * import { propertyProxy } from '@blackbyte/sugar/object';
+ * const myObject = {
+ * 		title : 'World'
+ * };
+ * // create the proxy
+ * propertyProxy(myObject, 'title', {
+ * 		get : (value) => {
+ * 			return `Hello ${value}`;
+ * 		},
+ * 		set : (value) => {
+ * 			return `Youhou ${value}`;
+ * 		}
+ * });
+ * console.log(myObject.title) => 'Hello World';
+ * myObject.title = 'Universe';
+ * console.log(myObject.title) => 'Hello Youhou Universe';
+ *
+ * @since         1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TPropertyProxyDescriptor = {
+    get: (value: any) => any;
+    set: (value: any) => any;
+    configurable: boolean;
+    enumarable: boolean;
+};
+export default function propertyProxy(obj: any, property: string, descriptor: TPropertyProxyDescriptor, applySetterAtStart?: boolean): void;