@schukai/monster 1.28.1 → 1.29.3

package/source/types/uniquequeue.js

@@ -13,7 +13,7 @@ import {validateObject} from "./validate.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.Types.UniqueQueue()
  * </script>
  * ```
@@ -22,7 +22,7 @@ import {validateObject} from "./validate.js";
  *
  * ```
  * <script type="module">
- * import {UniqueQueue} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/uniquequeue.js';
+ * import {UniqueQueue} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/uniquequeue.js';
  * new UniqueQueue()
  * </script>
  * ```

package/source/types/uuid.js

@@ -18,7 +18,7 @@ import {getGlobalObject} from "./global.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.Types.UUID()
  * </script>
  * ```
@@ -27,7 +27,7 @@ import {getGlobalObject} from "./global.js";
  *
  * ```
  * <script type="module">
- * import {Base} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/uuid.js';
+ * import {Base} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/uuid.js';
  * new UUID()
  * </script>
  * ```

package/source/types/validate.js

@@ -25,7 +25,7 @@ import {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(Monster.Types.validateIterable('2')) // ↦ TypeError
  * console.log(Monster.Types.validateIterable([])) // ↦ value
  * </script>
@@ -35,7 +35,7 @@ import {
  *
  * ```
  * <script type="module">
- * import {validateIterable} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/validate.js';
+ * import {validateIterable} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/validate.js';
  * console.log(validateIterable('2'))  // ↦ TypeError
  * console.log(validateIterable([]))  // ↦ value
  * </script>
@@ -65,7 +65,7 @@ function validateIterable(value) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(Monster.Types.validatePrimitive('2')) // ↦ value
  * console.log(Monster.Types.validatePrimitive([])) // ↦ TypeError
  * </script>
@@ -75,7 +75,7 @@ function validateIterable(value) {
  *
  * ```
  * <script type="module">
- * import {validatePrimitive} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/validate.js';
+ * import {validatePrimitive} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/validate.js';
  * console.log(validatePrimitive('2'))  // ↦ value
  * console.log(validatePrimitive([]))  // ↦ TypeError
  * </script>
@@ -105,7 +105,7 @@ function validatePrimitive(value) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(Monster.Types.validateBoolean(true)) // ↦ value
  * console.log(Monster.Types.validateBoolean('2')) // ↦ TypeError
  * console.log(Monster.Types.validateBoolean([])) // ↦ TypeError
@@ -116,7 +116,7 @@ function validatePrimitive(value) {
  *
  * ```
  * <script type="module">
- * import {validateBoolean} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/validate.js';
+ * import {validateBoolean} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/validate.js';
  * console.log(validateBoolean(false))  // ↦ value
  * console.log(validateBoolean('2'))  // ↦ TypeError
  * console.log(validateBoolean([]))  // ↦ TypeError
@@ -145,7 +145,7 @@ function validateBoolean(value) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(Monster.Types.validateString('2')) // ↦ value
  * console.log(Monster.Types.validateString([])) // ↦ TypeError
  * </script>
@@ -155,7 +155,7 @@ function validateBoolean(value) {
  *
  * ```
  * <script type="module">
- * import {validateString} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/validate.js';
+ * import {validateString} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/validate.js';
  * console.log(validateString('2'))  // ↦ value
  * console.log(validateString([]))  // ↦ TypeError
  * </script>
@@ -183,7 +183,7 @@ function validateString(value) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(Monster.Types.validateObject({})) // ↦ value
  * console.log(Monster.Types.validateObject('2')) // ↦ TypeError
  * console.log(Monster.Types.validateObject([])) // ↦ TypeError
@@ -194,7 +194,7 @@ function validateString(value) {
  *
  * ```
  * <script type="module">
- * import {validateObject} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/validate.js';
+ * import {validateObject} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/validate.js';
  * console.log(validateObject({}))  // ↦ value
  * console.log(validateObject('2'))  // ↦ TypeError
  * console.log(validateObject([]))  // ↦ TypeError
@@ -222,7 +222,7 @@ function validateObject(value) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(Monster.Types.validateInstance({}, Object)) // ↦ value
  * console.log(Monster.Types.validateInstance('2', Object)) // ↦ TypeError
  * console.log(Monster.Types.validateInstance([], Object)) // ↦ TypeError
@@ -233,7 +233,7 @@ function validateObject(value) {
  *
  * ```
  * <script type="module">
- * import {validateInstance} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/validate.js';
+ * import {validateInstance} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/validate.js';
  * console.log(validateInstance({}, Object)) // ↦ value
  * console.log(validateInstance('2', Object)) // ↦ TypeError
  * console.log(validateInstance([], Object)) // ↦ TypeError
@@ -270,7 +270,7 @@ function validateInstance(value, instance) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(Monster.Types.validateArray('2')) // ↦ TypeError
  * console.log(Monster.Types.validateArray([])) // ↦ value
  * </script>
@@ -280,7 +280,7 @@ function validateInstance(value, instance) {
  *
  * ```
  * <script type="module">
- * import {validateArray} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/validate.js';
+ * import {validateArray} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/validate.js';
  * console.log(validateArray('2'))  // ↦ TypeError
  * console.log(validateArray([]))  // ↦ value
  * </script>
@@ -307,7 +307,7 @@ function validateArray(value) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(Monster.Types.validateSymbol('2')) // ↦ TypeError
  * console.log(Monster.Types.validateSymbol([])) // ↦ value
  * </script>
@@ -317,7 +317,7 @@ function validateArray(value) {
  *
  * ```
  * <script type="module">
- * import {validateSymbol} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/validate.js';
+ * import {validateSymbol} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/validate.js';
  * console.log(validateSymbol('2'))  // ↦ TypeError
  * console.log(validateSymbol())  // ↦ value
  * </script>
@@ -344,7 +344,7 @@ function validateSymbol(value) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(Monster.Types.validateFunction(()=>{})) // ↦ value
  * console.log(Monster.Types.validateFunction('2')) // ↦ TypeError
  * console.log(Monster.Types.validateFunction([])) // ↦ TypeError
@@ -355,7 +355,7 @@ function validateSymbol(value) {
  *
  * ```
  * <script type="module">
- * import {validateFunction} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/validate.js';
+ * import {validateFunction} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/validate.js';
  * console.log(validateFunction(()=>{})) // ↦ value
  * console.log(validateFunction('2'))  // ↦ TypeError
  * console.log(validateFunction([]))  // ↦ TypeError
@@ -383,7 +383,7 @@ function validateFunction(value) {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(Monster.Types.validateInteger(true)) // ↦ TypeError
  * console.log(Monster.Types.validateInteger('2')) // ↦ TypeError
  * console.log(Monster.Types.validateInteger(2)) // ↦ value
@@ -394,7 +394,7 @@ function validateFunction(value) {
  *
  * ```
  * <script type="module">
- * import {validateFunction} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/validate.js';
+ * import {validateFunction} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/validate.js';
  * console.log(validateInteger(true)) // ↦ TypeError
  * console.log(validateInteger('2'))  // ↦ TypeError
  * console.log(validateInteger(2))  // ↦ value

package/source/types/version.js

@@ -10,7 +10,7 @@ import {Base} from './base.js';
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(new Monster.Types.Version('1.2.3')) // ↦ 1.2.3
  * console.log(new Monster.Types.Version('1')) // ↦ 1.0.0
  * </script>
@@ -20,7 +20,7 @@ import {Base} from './base.js';
  *
  * ```
  * <script type="module">
- * import {Version} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/version.js';
+ * import {Version} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/version.js';
  * console.log(new Version('1.2.3')) // ↦ 1.2.3
  * console.log(new Version('1')) // ↦ 1.0.0
  * </script>
@@ -28,7 +28,7 @@ import {Base} from './base.js';
  *
  * @example
  *
- * import {Version} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/version.js';
+ * import {Version} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/version.js';
  *
  * new Version('1.0.0') // ↦ 1.0.0
  * new Version(1)  // ↦ 1.0.0
@@ -151,7 +151,7 @@ let monsterVersion;
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * console.log(Monster.getVersion())
  * </script>
  * ```
@@ -160,7 +160,7 @@ let monsterVersion;
  *
  * ```
  * <script type="module">
- * import {getVersion} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/types/version.js';
+ * import {getVersion} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/types/version.js';
  * console.log(getVersion())
  * </script>
  * ```
@@ -176,7 +176,7 @@ function getVersion() {
         return monsterVersion;
     }
     /**#@+ dont touch, replaced by make with package.json version */
-    monsterVersion = new Version('1.28.1')
+    monsterVersion = new Version('1.29.3')
     /**#@-*/
 
     return monsterVersion;

package/source/util/clone.js

@@ -24,7 +24,7 @@ import {validateObject} from "../types/validate.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * Monster.Util.clone({})
  * </script>
  * ```
@@ -33,7 +33,7 @@ import {validateObject} from "../types/validate.js";
  *
  * ```
  * <script type="module">
- * import {clone} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/util/clone.js';
+ * import {clone} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/util/clone.js';
  * clone({})
  * </script>
  * ```

package/source/util/comparator.js

@@ -12,7 +12,7 @@ import {isFunction} from '../types/is.js';
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.Util.Comparator()
  * </script>
  * ```
@@ -21,7 +21,7 @@ import {isFunction} from '../types/is.js';
  *
  * ```
  * <script type="module">
- * import {Comparator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/util/comparator.js';
+ * import {Comparator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/util/comparator.js';
  * console.log(new Comparator())
  * </script>
  * ```
@@ -46,7 +46,7 @@ import {isFunction} from '../types/is.js';
  *
  * @example
  *
- * import {Comparator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/util/comparator.js';
+ * import {Comparator} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/util/comparator.js';
  *
  * console.log(new Comparator().lessThanOrEqual(2, 5))
  * // ↦ true

package/source/util/deadmansswitch.js

@@ -0,0 +1,124 @@
+'use strict';
+
+/**
+ * @author schukai GmbH
+ */
+
+
+import {internalSymbol} from "../constants.js";
+import {assignToNamespace, Monster} from '../namespace.js';
+import {Base} from "../types/base.js";
+import {isInteger} from "../types/is.js";
+import {validateFunction, validateInteger} from "../types/validate.js";
+
+/**
+ * The dead man's switch allows to set a timer which can be reset again and again within a defined period of time.
+ *
+ * You can create an instance via the monster namespace `Monster.Util.DeadMansSwitch()`.
+ *
+ * ```
+ * <script type="module">
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
+ * new Monster.Util.DeadMansSwitch()
+ * </script>
+ * ```
+ *
+ * Alternatively, you can also integrate this class individually.
+ *
+ * ```
+ * <script type="module">
+ * import {DeadMansSwitch} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/util/deadmansswitch.js';
+ * new DeadMansSwitch();
+ * </script>
+ * ```
+ *
+ * @example
+ * import {DeadMansSwitch} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/util/deadmansswitch.js';
+ *
+ * const deadmansswitch = new DeadMansSwitch(100, ()=>{
+ *   console.log('yeah!')
+ *   // ↦ "yeah!"
+ * })
+ *
+ * deadmansswitch.touch(); // from here wait again 100 ms
+ * deadmansswitch.touch(200); // from here wait 200 ms
+ *
+ * @copyright schukai GmbH
+ * @since 1.29.0
+ * @memberOf Monster.Util
+ * @summary Class to be able to execute function chains
+ */
+class DeadMansSwitch extends Base {
+
+    /**
+     * Create new dead man's switch
+     *
+     * @param {Integer} delay
+     * @param {function} callback
+     * @throw {TypeError} the arguments must be either integer or functions
+     * @throws {TypeError} value is not an integer
+     */
+    constructor(delay, callback) {
+        super();
+
+        init.call(this, validateInteger(delay), validateFunction(callback));
+    }
+
+    /**
+     *
+     * @param {Integer|undefined} [delay]
+     */
+    touch(delay) {
+
+        if (this[internalSymbol]['isAlreadyRun'] === true) {
+            throw new Error('has already run')
+        }
+
+        if (isInteger(delay)) {
+            this[internalSymbol]['delay'] = delay
+        } else if (delay !== undefined) {
+            throw new Error('unsupported argument')
+        }
+
+        clearTimeout(this[internalSymbol]['timer']);
+
+        initCallback.call(this);
+
+        return this;
+    }
+}
+
+/**
+ * @private
+ */
+function initCallback() {
+
+    const self = this;
+
+    self[internalSymbol]['timer'] = setTimeout(() => {
+        self[internalSymbol]['isAlreadyRun'] = true;
+        self[internalSymbol]['callback']();
+    }, self[internalSymbol]['delay'])
+}
+
+/**
+ * @private
+ * @param {integer} delay
+ * @param {function} callback
+ */
+function init(delay, callback) {
+    const self = this;
+
+    self[internalSymbol] = {
+        callback,
+        delay,
+        isAlreadyRun: false,
+        timer: undefined
+    };
+
+    initCallback.call(self);
+
+}
+
+assignToNamespace('Monster.Util', DeadMansSwitch);
+export {Monster, DeadMansSwitch}

package/source/util/freeze.js

@@ -14,7 +14,7 @@ import {validateObject} from '../types/validate.js';
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * Monster.Util.deepFreeze({})
  * </script>
  * ```
@@ -23,7 +23,7 @@ import {validateObject} from '../types/validate.js';
  *
  * ```
  * <script type="module">
- * import {deepFreeze} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/util/freeze.js';
+ * import {deepFreeze} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/util/freeze.js';
  * deepFreeze({})
  * </script>
  * ```

package/source/util/processing.js

@@ -77,7 +77,7 @@ class Callback {
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * new Monster.Util.Processing()
  * </script>
  * ```
@@ -86,13 +86,13 @@ class Callback {
  *
  * ```
  * <script type="module">
- * import {Processing} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/util/processing.js';
+ * import {Processing} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/util/processing.js';
  * new Processing();
  * </script>
  * ```
  *
  * @example
- * import {Processing} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/util/processing.js';
+ * import {Processing} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/util/processing.js';
  *
  * let startTime = +new Date();
  *

package/source/util/trimspaces.js

@@ -16,7 +16,7 @@ import {validateString} from "../types/validate.js";
  *
  * ```
  * <script type="module">
- * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/monster.js';
+ * import {Monster} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/monster.js';
  * Monster.Util.trimSpaces(" hello ")
  * </script>
  * ```
@@ -25,7 +25,7 @@ import {validateString} from "../types/validate.js";
  *
  * ```
  * <script type="module">
- * import {trimSpaces} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.28.1/dist/modules/util/trimspaces.js';
+ * import {trimSpaces} from 'https://cdn.jsdelivr.net/npm/@schukai/monster@1.29.3/dist/modules/util/trimspaces.js';
  * trimSpaces(' hello \\ ')
  * </script>
  * ```