@blackbyte/sugar 1.0.0-beta.1

package/dist/shared/array/proxyArray.js

@@ -0,0 +1,144 @@
+// @ts-nocheck
+/**
+ * @name                proxyArray
+ * @namespace           shared.array
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              beta
+ * @private
+ *
+ * This function override the passed array prototype to intercept changes made through
+ *
+ * @param         {Array}           array           The array to proxy
+ * @return        {Array}                           The same array with his prototype proxied
+ *
+ * @todo        tests
+ *
+ * @example       js
+ * import { proxyArray } from '@blackbyte/sugar/array';
+ * const myArray = proxyArray([1,2,3]);
+ * myArray.watch(['push','pop'], (watchObj) => {
+ *    // check the watchObj action
+ *    switch (watchObj.action) {
+ *      case 'push':
+ *        // do something...
+ *      break;
+ *    }
+ * });
+ *
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function proxyArray(array) {
+    if (array.__$proxied)
+        return array;
+    const watchStack = {};
+    // mark that this array has already been proxied
+    Object.defineProperty(array, '__$proxied', {
+        value: true,
+        enumerable: false,
+        writable: false,
+    });
+    function _proxyMethod(name, ...args) {
+        const handlersStack = [];
+        Object.keys(watchStack).forEach((watchId) => {
+            const watch = watchStack[watchId];
+            if (watch.methods.indexOf(name) === -1)
+                return;
+            handlersStack.push({
+                handlerFn: watch.handlerFn,
+                watchObj: {
+                    oldValue: [...array],
+                    action: `${name}`,
+                    fullAction: `Array.${name}`,
+                    args,
+                },
+            });
+        });
+        const returnValue = Array.prototype[name].call(array, ...args);
+        handlersStack.forEach((handlerObj) => {
+            handlerObj.watchObj = Object.assign(Object.assign({}, handlerObj.watchObj), { value: array, returnedValue: returnValue });
+            handlerObj.handlerFn(handlerObj.watchObj);
+        });
+        return returnValue;
+    }
+    Object.getOwnPropertyNames(Array.prototype).forEach((methodName) => {
+        const unProxyMethods = ['length', 'constructor'];
+        if (unProxyMethods.indexOf(methodName) !== -1)
+            return;
+        Object.defineProperty(array, methodName, {
+            writable: false,
+            configurable: false,
+            enumerable: false,
+            value: (...args) => {
+                return _proxyMethod(methodName, ...args);
+            },
+        });
+    });
+    /**
+     * @name                    watch
+     * @type                    Function
+     *
+     * This method allows you to specify which Array methods you want to watch by passing an array of methods names like ['push','pop'].
+     * You can also specify the handler function that will be called on each array updates, etc...
+     *
+     * @param         {Array|String}          methods               The methods you want to watch
+     * @param         {Function}              handler               The function that will be called on each updates. This function will be called with an object as parameters. Here's the list of properties available:
+     * - method (null) {String}: The method name that causes the watch emit
+     * - args ([]) {Array}: An array of all the arguments passed to the method call
+     * - oldValue (null) {Array}: The array just before the method call
+     * - value (null) {Array}: The array after the method call
+     * - returnedValue (null) {Mixed}: This is the value that the method call has returned
+     * @return        {String}                                    Return a uniq watchid that you can use to unwatch this process
+     *
+     * @example         js
+     * const watchId = myProxiedArray.watch(['push', 'pop'], (watchObj) => {
+     *    // do something...
+     * });
+     *
+     * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+     */
+    Object.defineProperty(array, 'watch', {
+        writable: false,
+        configurable: false,
+        enumerable: false,
+        value: (methods, handlerFn) => {
+            // create a watch id that we send back to the caller
+            const watchId = `s-${Date.now()}-${Math.round(Math.random() * 9999999999999)}`;
+            // append this watch process
+            watchStack[watchId] = {
+                methods,
+                handlerFn,
+            };
+            // return the watchId to be able to unwatcn this watch process
+            return watchId;
+        },
+    });
+    /**
+     * @name                  unwatch
+     * @type                  Function
+     *
+     * This methods allows you to unwatch a process started with the "watch" method.
+     * You have to pass as parameter the watchId that the "watch" method has returned you.
+     *
+     * @param       {String}          watchId         The watchId returned by the "watch" method
+     *
+     * @example       js
+     * const watchId = myArray.watch('push', (obj) => //...);
+     * myArray.unwatch(watchId);
+     *
+     * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+     */
+    Object.defineProperty(array, 'unwatch', {
+        writable: false,
+        configurable: false,
+        enumerable: false,
+        value: (watchId) => {
+            // delete the watch process
+            delete watchStack[watchId];
+        },
+    });
+    // return the processed array
+    return array;
+}
+//# sourceMappingURL=proxyArray.js.map

package/dist/shared/array/proxyArray.js.map

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

package/dist/shared/array/sameItems.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @name            sameItems
+ * @namespace       shared.array
+ * @type            Function
+ * @platform        node
+ * @platform        js
+ * @status           beta
+ *
+ * This function take two arrays and return all the items that are the same.
+ * You can specify if you want only comparing by reference for object, etc... or if
+ * you want to transform items in hashes and compare that instead.
+ *
+ * @param       {Array}         ...arrays               The arrays you want to compare
+ * @param       {Object}        [settings={}]           Some settings to refine your comparaison process
+ * @return      {Array}                                 An array containing all the items that are present in all the passed arrays
+ *
+ * @setting         {Boolean}          [references=true]        Specify if you want to use the references comparaison or not
+ * @setting         {Boolean}           [hash=true]             Specify if you want to allows transforming object etc in to hashes and compare this instead
+ *
+ * @snippet         sameItems($1, $2)
+ *
+ * @example         js
+ * import { sameItems } from '@blackbyte/sugar/array';
+ * sameItems([1,2,3,4], [1,3,5]); // => [1,3]
+ *
+ * @since           1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function sameItems(...args: any[]): any[];

package/dist/shared/array/sameItems.js

@@ -0,0 +1,69 @@
+import base64 from '../crypto/base64.js';
+import isPlainObject from '../is/isPlainObject.js';
+import unique from './unique.js';
+/**
+ * @name            sameItems
+ * @namespace       shared.array
+ * @type            Function
+ * @platform        node
+ * @platform        js
+ * @status           beta
+ *
+ * This function take two arrays and return all the items that are the same.
+ * You can specify if you want only comparing by reference for object, etc... or if
+ * you want to transform items in hashes and compare that instead.
+ *
+ * @param       {Array}         ...arrays               The arrays you want to compare
+ * @param       {Object}        [settings={}]           Some settings to refine your comparaison process
+ * @return      {Array}                                 An array containing all the items that are present in all the passed arrays
+ *
+ * @setting         {Boolean}          [references=true]        Specify if you want to use the references comparaison or not
+ * @setting         {Boolean}           [hash=true]             Specify if you want to allows transforming object etc in to hashes and compare this instead
+ *
+ * @snippet         sameItems($1, $2)
+ *
+ * @example         js
+ * import { sameItems } from '@blackbyte/sugar/array';
+ * sameItems([1,2,3,4], [1,3,5]); // => [1,3]
+ *
+ * @since           1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function sameItems(...args) {
+    var _a, _b, _c;
+    const arrays = args.filter((arg) => Array.isArray(arg));
+    const settings = Object.assign({ references: true, hash: true }, ((_a = args.filter((arg) => isPlainObject(arg))[0]) !== null && _a !== void 0 ? _a : {}));
+    if (arrays.length > 2) {
+        let newArray = arrays[0];
+        arrays.forEach((currentArray) => {
+            newArray = sameItems(newArray, currentArray, settings);
+        });
+        return unique(newArray);
+    }
+    else {
+        const array1 = (_b = arrays[0]) !== null && _b !== void 0 ? _b : [], array2 = (_c = arrays[1]) !== null && _c !== void 0 ? _c : [];
+        const sameArray = [];
+        array1.forEach((array1Item) => {
+            let array1ItemHash = array1Item;
+            if (typeof array1Item !== 'string' && settings.hash) {
+                array1ItemHash = base64.encrypt(array1Item);
+            }
+            array2.forEach((array2Item) => {
+                let array2ItemHash = array2Item;
+                if (typeof array2Item !== 'string' && settings.hash) {
+                    array2ItemHash = base64.encrypt(array2Item);
+                    if (array1ItemHash === array2ItemHash) {
+                        sameArray.push(array1Item);
+                        return;
+                    }
+                }
+                else if (array1Item === array2Item) {
+                    sameArray.push(array1Item);
+                    return;
+                }
+            });
+        });
+        return unique(sameArray);
+    }
+}
+//# sourceMappingURL=sameItems.js.map

package/dist/shared/array/sameItems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sameItems.js","sourceRoot":"","sources":["../../../src/shared/array/sameItems.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,qBAAqB,CAAC;AACzC,OAAO,aAAa,MAAM,wBAAwB,CAAC;AACnD,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,GAAG,IAAI;;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,MAAM,QAAQ,mBACZ,UAAU,EAAE,IAAI,EAChB,IAAI,EAAE,IAAI,IACP,CAAC,MAAA,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,mCAAI,EAAE,CAAC,CACvD,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,IAAI,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAEzB,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE;YAC9B,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,MAAA,MAAM,CAAC,CAAC,CAAC,mCAAI,EAAE,EAC5B,MAAM,GAAG,MAAA,MAAM,CAAC,CAAC,CAAC,mCAAI,EAAE,CAAC;QAE3B,MAAM,SAAS,GAAU,EAAE,CAAC;QAE5B,MAAM,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;YAC5B,IAAI,cAAc,GAAG,UAAU,CAAC;YAChC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACpD,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC9C,CAAC;YAED,MAAM,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;gBAC5B,IAAI,cAAc,GAAG,UAAU,CAAC;gBAChC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;oBACpD,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBAC5C,IAAI,cAAc,KAAK,cAAc,EAAE,CAAC;wBACtC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;wBAC3B,OAAO;oBACT,CAAC;gBACH,CAAC;qBAAM,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;oBACrC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBAC3B,OAAO;gBACT,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/shared/array/splitEvery.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @name                splitEvery
+ * @namespace           shared.array
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Split an array every N items
+ *
+ * @param           {Array}           array               The array to split
+ * @param           {Number}          every               Every how many items to split the array
+ * @return          {Array}                               An array of arrays splited
+ *
+ * @snippet         splitEvery($1, $2)
+ *
+ * @example           js
+ * import { splitEvery } from '@blackbyte/sugar/array';
+ * splitEvery([1,2,3,4,5,6,7,8,9], 3);
+ * // [[1,2,3],[4,5,6],[7,8,9]]
+ *
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function splitEvery(array: any[], every: number): any[];

package/dist/shared/array/splitEvery.js

@@ -0,0 +1,32 @@
+/**
+ * @name                splitEvery
+ * @namespace           shared.array
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Split an array every N items
+ *
+ * @param           {Array}           array               The array to split
+ * @param           {Number}          every               Every how many items to split the array
+ * @return          {Array}                               An array of arrays splited
+ *
+ * @snippet         splitEvery($1, $2)
+ *
+ * @example           js
+ * import { splitEvery } from '@blackbyte/sugar/array';
+ * splitEvery([1,2,3,4,5,6,7,8,9], 3);
+ * // [[1,2,3],[4,5,6],[7,8,9]]
+ *
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function splitEvery(array, every) {
+    let i, j;
+    const finalArray = [];
+    for (i = 0, j = array.length; i < j; i += every) {
+        finalArray.push(array.slice(i, i + every));
+    }
+    return finalArray;
+}
+//# sourceMappingURL=splitEvery.js.map

package/dist/shared/array/splitEvery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"splitEvery.js","sourceRoot":"","sources":["../../../src/shared/array/splitEvery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,KAAY,EAAE,KAAa;IAC5D,IAAI,CAAS,EAAE,CAAS,CAAC;IACzB,MAAM,UAAU,GAAU,EAAE,CAAC;IAC7B,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QAChD,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/shared/array/unique.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @name                unique
+ * @namespace           shared.array
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * This function simply take an array as parameter and return a new one
+ * with all the duplicates values removed.
+ *
+ * @param         {Array}         array               The array to deduplicates
+ * @return        {Array}                             The deduplicated array
+ *
+ * @snippet         unique($1)
+ *
+ * @example         js
+ * import { unique } from '@blackbyte/sugar/array';
+ * unique(['hello','world','hello','world']); // => ['hello','world']
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function unique(array: any[]): any[];

package/dist/shared/array/unique.js

@@ -0,0 +1,34 @@
+/**
+ * @name                unique
+ * @namespace           shared.array
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * This function simply take an array as parameter and return a new one
+ * with all the duplicates values removed.
+ *
+ * @param         {Array}         array               The array to deduplicates
+ * @return        {Array}                             The deduplicated array
+ *
+ * @snippet         unique($1)
+ *
+ * @example         js
+ * import { unique } from '@blackbyte/sugar/array';
+ * unique(['hello','world','hello','world']); // => ['hello','world']
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function unique(array) {
+    const a = array.concat();
+    for (let i = 0; i < a.length; ++i) {
+        for (let j = i + 1; j < a.length; ++j) {
+            if (a[i] === a[j])
+                a.splice(j--, 1);
+        }
+    }
+    return a;
+}
+//# sourceMappingURL=unique.js.map

package/dist/shared/array/unique.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique.js","sourceRoot":"","sources":["../../../src/shared/array/unique.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,KAAY;IACzC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/shared/class/_exports.d.ts

@@ -0,0 +1,7 @@
+import cloneClass from './cloneClass.js';
+import getExtendsStack from './getExtendsStack.js';
+import getMethods from './getMethods.js';
+import methodExists from './methodExists.js';
+import multipleExtends from './multipleExtends.js';
+import toPlainObject from './toPlainObject.js';
+export { cloneClass as __cloneClass, getExtendsStack as __getExtendsStack, getMethods as __getMethods, methodExists as __methodExists, multipleExtends as __multipleExtends, toPlainObject as __toPlainObject, cloneClass, getExtendsStack, getMethods, methodExists, multipleExtends, toPlainObject, };

package/dist/shared/class/_exports.js

@@ -0,0 +1,8 @@
+import cloneClass from './cloneClass.js';
+import getExtendsStack from './getExtendsStack.js';
+import getMethods from './getMethods.js';
+import methodExists from './methodExists.js';
+import multipleExtends from './multipleExtends.js';
+import toPlainObject from './toPlainObject.js';
+export { cloneClass as __cloneClass, getExtendsStack as __getExtendsStack, getMethods as __getMethods, methodExists as __methodExists, multipleExtends as __multipleExtends, toPlainObject as __toPlainObject, cloneClass, getExtendsStack, getMethods, methodExists, multipleExtends, toPlainObject, };
+//# sourceMappingURL=_exports.js.map

package/dist/shared/class/_exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_exports.js","sourceRoot":"","sources":["../../../src/shared/class/_exports.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,eAAe,MAAM,sBAAsB,CAAC;AACnD,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,eAAe,MAAM,sBAAsB,CAAC;AACnD,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EACL,UAAU,IAAI,YAAY,EAC1B,eAAe,IAAI,iBAAiB,EACpC,UAAU,IAAI,YAAY,EAC1B,YAAY,IAAI,cAAc,EAC9B,eAAe,IAAI,iBAAiB,EACpC,aAAa,IAAI,eAAe,EAChC,UAAU,EACV,eAAe,EACf,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,GACd,CAAC"}

package/dist/shared/class/cloneClass.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @name                cloneClass
+ * @namespace           shared.class
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Clone ES6 Classes
+ *
+ * @param       {Class}          class        The class to clone
+ * @return      {Class}                             A new class
+ *
+ * @todo      tests
+ *
+ * @snippet         cloneClass($1)
+ *
+ * @example         js
+ * import { cloneClass } from '@blackbyte/sugar/class';
+ * const NewClass = cloneClass(class MyClass() {});
+ *
+ * @see             https://www.npmjs.com/package/clone-class
+ * @since           1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function (cls: any): any;

package/dist/shared/class/cloneClass.js

@@ -0,0 +1,30 @@
+import { cloneClass } from 'clone-class';
+/**
+ * @name                cloneClass
+ * @namespace           shared.class
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Clone ES6 Classes
+ *
+ * @param       {Class}          class        The class to clone
+ * @return      {Class}                             A new class
+ *
+ * @todo      tests
+ *
+ * @snippet         cloneClass($1)
+ *
+ * @example         js
+ * import { cloneClass } from '@blackbyte/sugar/class';
+ * const NewClass = cloneClass(class MyClass() {});
+ *
+ * @see             https://www.npmjs.com/package/clone-class
+ * @since           1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function (cls) {
+    return cloneClass(cls);
+}
+//# sourceMappingURL=cloneClass.js.map

package/dist/shared/class/cloneClass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloneClass.js","sourceRoot":"","sources":["../../../src/shared/class/cloneClass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,OAAO,WAAW,GAAQ;IAC/B,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/shared/class/getExtendsStack.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @name            getExtendsStack
+ * @namespace       shared.class
+ * @type            Function
+ * @platform        js
+ * @platform        node
+ * @status          beta
+ *
+ * This function take a class as parameter and return an array of all the class names used to extends this one...
+ *
+ * @param       {Class}         cls         The class to get the stack of
+ * @param       {TGetExtendsStackSettings}    [settings={}]       Some settings to configure your process
+ * @return      {Object}                     An object of all the parent classes
+ *
+ * @setting     {Boolean}     [includeBaseClass=false]      Specify if you want to include the base class in the stack or not
+ *
+ * @todo      tests
+ *
+ * @snippet         getExtendsStack($1)
+ *
+ * @example         js
+ * import { getExtendsStack } from '@blackbyte/sugar/class';
+ * class Coco extends Error {}
+ * class Plop extends Coco {}
+ * getExtendsStack(Plop); // => {Coco: [class ...], Error: [class ...]};
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type TGetExtendsStackSettings = {
+    includeBaseClass?: boolean;
+};
+export type TGetExtendsStackResult = {
+    [key: string]: any;
+};
+export type TGetExtendsStack = {
+    (cls: any, settings?: TGetExtendsStackSettings): TGetExtendsStackResult;
+};
+declare const fn: TGetExtendsStack;
+export default fn;

package/dist/shared/class/getExtendsStack.js

@@ -0,0 +1,24 @@
+import isClass from '../is/isClass.js';
+const fn = function (cls, settings = {}) {
+    const stack = {};
+    if (!isClass(cls)) {
+        cls = cls.constructor;
+    }
+    if (settings.includeBaseClass === true) {
+        stack[cls.name] = cls;
+    }
+    let baseClass = cls;
+    while (baseClass) {
+        const newBaseClass = Object.getPrototypeOf(baseClass);
+        if (newBaseClass && newBaseClass !== Object && newBaseClass.name) {
+            stack[newBaseClass.name] = newBaseClass;
+            baseClass = newBaseClass;
+        }
+        else {
+            break;
+        }
+    }
+    return stack;
+};
+export default fn;
+//# sourceMappingURL=getExtendsStack.js.map

package/dist/shared/class/getExtendsStack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getExtendsStack.js","sourceRoot":"","sources":["../../../src/shared/class/getExtendsStack.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AA0CvC,MAAM,EAAE,GAAqB,UAC3B,GAAQ,EACR,WAAqC,EAAE;IAEvC,MAAM,KAAK,GAAG,EAAE,CAAC;IAEjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC;IACxB,CAAC;IAED,IAAI,QAAQ,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;QACvC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;IACxB,CAAC;IAED,IAAI,SAAS,GAAG,GAAG,CAAC;IAEpB,OAAO,SAAS,EAAE,CAAC;QACjB,MAAM,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QACtD,IAAI,YAAY,IAAI,YAAY,KAAK,MAAM,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC;YACjE,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC;YACxC,SAAS,GAAG,YAAY,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AACF,eAAe,EAAE,CAAC"}

package/dist/shared/class/getMethods.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @name              getMethods
+ * @namespace         shared.class
+ * @type              Function
+ * @platform          js
+ * @platform          node
+ * @status            beta
+ *
+ * This function take an instance as parameter and return all the methods in array format
+ *
+ * @param         {Object}        instance        The instance of the object to get the methods names of
+ * @return        {Array}                         A simple array of all the methods names
+ *
+ * @todo      tests
+ *
+ * @snippet         getMethods($1)
+ *
+ * @example         js
+ * import { getMethods } from '@blackbyte/sugar/class';
+ * myClass {
+ *  constructor() {}
+ *  hello() {}
+ *  world() {}
+ * }
+ * const myInstance = new myClass();
+ * getMethods(myInstance); // => ['hello','world']
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function getMethods(toCheck: any): string[];

package/dist/shared/class/getMethods.js

@@ -0,0 +1,45 @@
+/**
+ * @name              getMethods
+ * @namespace         shared.class
+ * @type              Function
+ * @platform          js
+ * @platform          node
+ * @status            beta
+ *
+ * This function take an instance as parameter and return all the methods in array format
+ *
+ * @param         {Object}        instance        The instance of the object to get the methods names of
+ * @return        {Array}                         A simple array of all the methods names
+ *
+ * @todo      tests
+ *
+ * @snippet         getMethods($1)
+ *
+ * @example         js
+ * import { getMethods } from '@blackbyte/sugar/class';
+ * myClass {
+ *  constructor() {}
+ *  hello() {}
+ *  world() {}
+ * }
+ * const myInstance = new myClass();
+ * getMethods(myInstance); // => ['hello','world']
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function getMethods(toCheck) {
+    let props = [];
+    let obj = toCheck;
+    do {
+        const _props = Object.getOwnPropertyNames(obj);
+        if (_props.indexOf('__defineGetter__') !== -1)
+            continue;
+        props = props.concat(_props);
+    } while ((obj = Object.getPrototypeOf(obj)));
+    return props.sort().filter(function (e, i, arr) {
+        if (e != arr[i + 1] && typeof toCheck[e] == 'function')
+            return true;
+    });
+}
+//# sourceMappingURL=getMethods.js.map

package/dist/shared/class/getMethods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMethods.js","sourceRoot":"","sources":["../../../src/shared/class/getMethods.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,OAAY;IAC7C,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,IAAI,GAAG,GAAG,OAAO,CAAC;IAClB,GAAG,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAAE,SAAS;QACxD,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,QAAQ,CAAC,GAAG,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE;IAE7C,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,GAAG;QAC5C,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,UAAU;YAAE,OAAO,IAAI,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/shared/class/methodExists.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @name                methodExists
+ * @namespace           shared.class
+ * @type                Function
+ * @platform            js
+ * @platform            node
+ * @status              stable
+ *
+ * Check if one or more methods exists on a class instance
+ *
+ * @param           {Object}                instance              The instance to check the methods on
+ * @param           {String[]}              methods               The methods to check
+ * @return          {Boolean|Array}                               Return true if all is ok, and an array of missing methods if not
+ *
+ * @todo      tests
+ *
+ * @snippet         methodExists($1)
+ *
+ * @example           js
+ * class Coco {
+ *    hello() {}
+ * }
+ * import { methodExists } from '@blackbyte/sugar/class';
+ * const myInstance = new Coco();
+ * methodExists(myInstance, 'hello', 'world'); // => ['world'];
+ * methodExists(myInstance, 'hello'); // => true
+ *
+ * @since       1.0.0
+ * @author         Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function methodExists(instance: any, methods: string[]): boolean | string[];