@schukai/monster 3.5.0 → 3.8.0

package/source/data/datasource/storage.mjs

@@ -5,21 +5,21 @@
  * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
  */
 
-import {internalSymbol,instanceSymbol} from "../../constants.mjs";
-import {validateString} from "../../types/validate.mjs";
-import {Datasource} from "../datasource.mjs";
+import { internalSymbol, instanceSymbol } from "../../constants.mjs";
+import { validateString } from "../../types/validate.mjs";
+import { Datasource } from "../datasource.mjs";
 
-export {Storage, storageObjectSymbol}
+export { Storage, storageObjectSymbol };
 
 /**
  * @private
  * @type {symbol}
  */
-const storageObjectSymbol = Symbol.for  ('@schukai/monster/data/datasource/storage/@@storageObject')
+const storageObjectSymbol = Symbol.for("@schukai/monster/data/datasource/storage/@@storageObject");
 
 /**
  * The class represents a record.
- * 
+ *
  * @license AGPLv3
  * @since 1.22.0
  * @copyright schukai GmbH
@@ -27,7 +27,6 @@ const storageObjectSymbol = Symbol.for  ('@schukai/monster/data/datasource/stora
  * @summary The Storage class encapsulates the access to data objects over WebStorageAPI.
  */
 class Storage extends Datasource {
-
     /**
      *
      * @param {string} key LocalStorage Key
@@ -35,7 +34,7 @@ class Storage extends Datasource {
      */
     constructor(key) {
         super();
-        this.setOption('key', validateString(key));
+        this.setOption("key", validateString(key));
     }
 
     /**
@@ -45,7 +44,7 @@ class Storage extends Datasource {
      */
     static get [instanceSymbol]() {
         return Symbol.for("@schukai/monster/data/datasource/storage");
-    }    
+    }
 
     /**
      * @property {string} key=undefined LocalStorage Key
@@ -62,7 +61,7 @@ class Storage extends Datasource {
      * @private
      */
     [storageObjectSymbol]() {
-        throw new Error("this method must be implemented by derived classes")
+        throw new Error("this method must be implemented by derived classes");
     }
 
     /**
@@ -77,11 +76,10 @@ class Storage extends Datasource {
         const storage = self[storageObjectSymbol]();
 
         return new Promise(function (resolve) {
-            const data = JSON.parse(storage.getItem(self.getOption('key')));
-            self.set(data??{});
+            const data = JSON.parse(storage.getItem(self.getOption("key")));
+            self.set(data ?? {});
             resolve();
-        })
-
+        });
     }
 
     /**
@@ -94,24 +92,22 @@ class Storage extends Datasource {
         const storage = self[storageObjectSymbol]();
 
         return new Promise(function (resolve) {
-
             const data = self.get();
             if (data === undefined) {
-                storage.removeItem(self.getOption('key'));
+                storage.removeItem(self.getOption("key"));
             } else {
-                storage.setItem(self.getOption('key'), JSON.stringify(data));
+                storage.setItem(self.getOption("key"), JSON.stringify(data));
             }
 
             resolve();
-        })
+        });
     }
 
     /**
      * @return {Storage}
      */
     getClone() {
-        const self=this;
-        return new Storage(self[internalSymbol].getRealSubject()['options'].key);
-    } 
-    
+        const self = this;
+        return new Storage(self[internalSymbol].getRealSubject()["options"].key);
+    }
 }

package/source/data/datasource.mjs

@@ -5,18 +5,17 @@
  * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
  */
 
-import {internalSymbol} from "../constants.mjs";
-import {instanceSymbol} from '../constants.mjs';
-import {Base} from "../types/base.mjs";
-import {parseDataURL} from "../types/dataurl.mjs";
-import {isString} from "../types/is.mjs";
-import {ProxyObserver} from "../types/proxyobserver.mjs";
-import {validateObject} from "../types/validate.mjs";
-import {extend} from "./extend.mjs";
-import {Pathfinder} from "./pathfinder.mjs";
-
-export {Datasource}
-
+import { internalSymbol } from "../constants.mjs";
+import { instanceSymbol } from "../constants.mjs";
+import { Base } from "../types/base.mjs";
+import { parseDataURL } from "../types/dataurl.mjs";
+import { isString } from "../types/is.mjs";
+import { ProxyObserver } from "../types/proxyobserver.mjs";
+import { validateObject } from "../types/validate.mjs";
+import { extend } from "./extend.mjs";
+import { Pathfinder } from "./pathfinder.mjs";
+
+export { Datasource };
 
 /**
  * This callback can be passed to a datasource and is used to adapt data structures.
@@ -28,7 +27,6 @@ export {Datasource}
  * @see Monster.Data.Datasource
  */
 
-
 /**
  * @private
  * @type {symbol}
@@ -36,7 +34,7 @@ export {Datasource}
  * @license AGPLv3
  * @since 1.24.0
  */
-const internalDataSymbol = Symbol.for('@schukai/monster/data/datasource/@@data');
+const internalDataSymbol = Symbol.for("@schukai/monster/data/datasource/@@data");
 
 /**
  * The datasource class is the basis for dealing with different data sources.
@@ -49,22 +47,17 @@ const internalDataSymbol = Symbol.for('@schukai/monster/data/datasource/@@data')
  * @summary The datasource class encapsulates the access to data objects.
  */
 class Datasource extends Base {
-
     /**
      * creates a new datasource
-     * 
+     *
      */
     constructor() {
         super();
         this[internalSymbol] = new ProxyObserver({
-            'options': extend({}, this.defaults)
+            options: extend({}, this.defaults),
         });
-        
-        this[internalDataSymbol] = new ProxyObserver({
 
-        });
-        
-    
+        this[internalDataSymbol] = new ProxyObserver({});
     }
 
     /**
@@ -74,7 +67,7 @@ class Datasource extends Base {
      * @returns {Datasource}
      */
     attachObserver(observer) {
-        this[internalDataSymbol].attachObserver(observer)
+        this[internalDataSymbol].attachObserver(observer);
         return this;
     }
 
@@ -85,7 +78,7 @@ class Datasource extends Base {
      * @returns {Datasource}
      */
     detachObserver(observer) {
-        this[internalDataSymbol].detachObserver(observer)
+        this[internalDataSymbol].detachObserver(observer);
         return this;
     }
 
@@ -120,7 +113,7 @@ class Datasource extends Base {
      * @return {Datasource}
      */
     setOption(path, value) {
-        new Pathfinder(this[internalSymbol].getSubject()['options']).setVia(path, value);
+        new Pathfinder(this[internalSymbol].getSubject()["options"]).setVia(path, value);
         return this;
     }
 
@@ -130,13 +123,12 @@ class Datasource extends Base {
      * @throws {Error} the options does not contain a valid json definition
      */
     setOptions(options) {
-
         if (isString(options)) {
-            options = parseOptionsJSON(options)
+            options = parseOptionsJSON(options);
         }
 
         const self = this;
-        extend(self[internalSymbol].getSubject()['options'], self.defaults, options);
+        extend(self[internalSymbol].getSubject()["options"], self.defaults, options);
 
         return self;
     }
@@ -152,10 +144,8 @@ class Datasource extends Base {
         let value;
 
         try {
-            value = new Pathfinder(this[internalSymbol].getRealSubject()['options']).getVia(path);
-        } catch (e) {
-
-        }
+            value = new Pathfinder(this[internalSymbol].getRealSubject()["options"]).getVia(path);
+        } catch (e) {}
 
         if (value === undefined) return defaultValue;
         return value;
@@ -166,7 +156,7 @@ class Datasource extends Base {
      * @return {Promise}
      */
     read() {
-        throw new Error("this method must be implemented by derived classes")
+        throw new Error("this method must be implemented by derived classes");
     }
 
     /**
@@ -174,13 +164,12 @@ class Datasource extends Base {
      * @return {Promise}
      */
     write() {
-        throw new Error("this method must be implemented by derived classes")
+        throw new Error("this method must be implemented by derived classes");
     }
 
-
     /**
      * Returns real object
-     * 
+     *
      * @return {Object|Array}
      */
     get() {
@@ -206,7 +195,6 @@ class Datasource extends Base {
     static get [instanceSymbol]() {
         return Symbol.for("@schukai/monster/data/datasource");
     }
-
 }
 
 /**
@@ -217,22 +205,18 @@ class Datasource extends Base {
  */
 function parseOptionsJSON(data) {
     if (isString(data)) {
-
         // the configuration can be specified as a data url.
         try {
             let dataUrl = parseDataURL(data);
             data = dataUrl.content;
-        } catch (e) {
-
-        }
-
+        } catch (e) {}
 
         try {
             let obj = JSON.parse(data);
             validateObject(obj);
             return obj;
         } catch (e) {
-            throw new Error('the options does not contain a valid json definition (actual: ' + data + ').');
+            throw new Error(`the options does not contain a valid json definition (actual: ${data}).`);
         }
     }
 

package/source/data/diff.mjs

@@ -5,10 +5,10 @@
  * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
  */
 
-import {isArray, isObject} from "../types/is.mjs";
-import {typeOf} from "../types/typeof.mjs";
+import { isArray, isObject } from "../types/is.mjs";
+import { typeOf } from "../types/typeof.mjs";
 
-export {diff}
+export { diff };
 
 /**
  * With the diff function you can perform the change of one object to another. The result shows the changes of the second object to the first object.
@@ -25,7 +25,7 @@ export {diff}
  * @memberOf Monster.Data
  */
 function diff(first, second) {
-    return doDiff(first, second)
+    return doDiff(first, second);
 }
 
 /**
@@ -54,37 +54,30 @@ function getKeys(a, b, type) {
  * @return {array}
  */
 function doDiff(a, b, path, diff) {
-
-    let typeA = typeOf(a)
-    let typeB = typeOf(b)
+    let typeA = typeOf(a);
+    let typeB = typeOf(b);
 
     const currPath = path || [];
     const currDiff = diff || [];
 
-    if (typeA === typeB && (typeA === 'object' || typeA ==='array')) { 
-
+    if (typeA === typeB && (typeA === "object" || typeA === "array")) {
         getKeys(a, b, typeA).forEach((v) => {
-
-            if (!(Object.prototype.hasOwnProperty.call(a, v))) {
-                currDiff.push(buildResult(a[v], b[v], 'add', currPath.concat(v)));
-            } else if (!(Object.prototype.hasOwnProperty.call(b, v))) {
-                currDiff.push(buildResult(a[v], b[v], 'delete', currPath.concat(v)));
+            if (!Object.prototype.hasOwnProperty.call(a, v)) {
+                currDiff.push(buildResult(a[v], b[v], "add", currPath.concat(v)));
+            } else if (!Object.prototype.hasOwnProperty.call(b, v)) {
+                currDiff.push(buildResult(a[v], b[v], "delete", currPath.concat(v)));
             } else {
                 doDiff(a[v], b[v], currPath.concat(v), currDiff);
             }
         });
-
     } else {
-
         const o = getOperator(a, b, typeA, typeB);
         if (o !== undefined) {
             currDiff.push(buildResult(a, b, o, path));
         }
-
     }
 
     return currDiff;
-
 }
 
 /**
@@ -97,16 +90,15 @@ function doDiff(a, b, path, diff) {
  * @private
  */
 function buildResult(a, b, operator, path) {
-
     const result = {
         operator,
         path,
     };
 
-    if (operator !== 'add') {
+    if (operator !== "add") {
         result.first = {
             value: a,
-            type: typeof a
+            type: typeof a,
         };
 
         if (isObject(a)) {
@@ -117,10 +109,10 @@ function buildResult(a, b, operator, path) {
         }
     }
 
-    if (operator === 'add' || operator === 'update') {
+    if (operator === "add" || operator === "update") {
         result.second = {
             value: b,
-            type: typeof b
+            type: typeof b,
         };
 
         if (isObject(b)) {
@@ -129,7 +121,6 @@ function buildResult(a, b, operator, path) {
                 result.second.instance = name;
             }
         }
-
     }
 
     return result;
@@ -142,7 +133,6 @@ function buildResult(a, b, operator, path) {
  * @return {boolean}
  */
 function isNotEqual(a, b) {
-
     if (typeof a !== typeof b) {
         return true;
     }
@@ -161,7 +151,6 @@ function isNotEqual(a, b) {
  * @return {string|undefined}
  */
 function getOperator(a, b) {
-
     /**
      * @type {string|undefined}
      */
@@ -177,14 +166,13 @@ function getOperator(a, b) {
      */
     let typeB = typeof b;
 
-    if (typeA === 'undefined' && typeB !== 'undefined') {
-        operator = 'add';
-    } else if (typeA !== 'undefined' && typeB === 'undefined') {
-        operator = 'delete';
+    if (typeA === "undefined" && typeB !== "undefined") {
+        operator = "add";
+    } else if (typeA !== "undefined" && typeB === "undefined") {
+        operator = "delete";
     } else if (isNotEqual(a, b)) {
-        operator = 'update';
+        operator = "update";
     }
 
     return operator;
-
 }

package/source/data/extend.mjs

@@ -5,10 +5,10 @@
  * License text available at https://www.gnu.org/licenses/agpl-3.0.en.html
  */
 
-import {isArray, isObject} from "../types/is.mjs";
-import {typeOf} from "../types/typeof.mjs";
+import { isArray, isObject } from "../types/is.mjs";
+import { typeOf } from "../types/typeof.mjs";
 
-export {extend}
+export { extend };
 
 /**
  * Extend copies all enumerable own properties from one or
@@ -23,15 +23,21 @@ export {extend}
  * @memberOf Monster.Data
  * @throws {Error} unsupported argument
  * @throws {Error} type mismatch
+ * @throws {Error} unsupported argument
  */
-function extend() {
-    let o, i;
+function extend(...args) {
+    let o;
+    let i;
+
+    if (typeof args !== "object" || args[0] === null) {
+        throw new Error(`unsupported argument ${JSON.stringify(args[0])}`);
+    }
 
-    for (i = 0; i < arguments.length; i++) {
-        let a = arguments[i];
+    for (i = 0; i < args.length; i++) {
+        let a = args[i];
 
         if (!(isObject(a) || isArray(a))) {
-            throw new Error('unsupported argument ' + JSON.stringify(a));
+            throw new Error(`unsupported argument ${JSON.stringify(a)}`);
         }
 
         if (o === undefined) {
@@ -40,15 +46,13 @@ function extend() {
         }
 
         for (let k in a) {
-
             let v = a?.[k];
 
             if (v === o?.[k]) {
                 continue;
             }
 
-            if ((isObject(v)&&typeOf(v)==='object') || isArray(v)) {
-
+            if ((isObject(v) && typeOf(v) === "object") || isArray(v)) {
                 if (o[k] === undefined) {
                     if (isArray(v)) {
                         o[k] = [];
@@ -57,16 +61,18 @@ function extend() {
                     }
                 } else {
                     if (typeOf(o[k]) !== typeOf(v)) {
-                        throw new Error("type mismatch: " + JSON.stringify(o[k]) + "(" + typeOf(o[k]) + ") != " + JSON.stringify(v) + "(" + typeOf(v) + ")");
+                        throw new Error(
+                            `type mismatch: ${JSON.stringify(o[k])}(${typeOf(o[k])}) != ${JSON.stringify(v)}(${typeOf(
+                                v,
+                            )})`,
+                        );
                     }
                 }
 
                 o[k] = extend(o[k], v);
-
             } else {
                 o[k] = v;
             }
-
         }
     }
 

package/source/data/namespace.mjs

@@ -3,8 +3,6 @@
  * SPDX-License-Identifier: AGPL-3.0
  */
 
-
-
 /**
  * In this namespace you will find classes and methods for handling data.
  *
@@ -12,4 +10,4 @@
  * @memberOf Monster
  * @author schukai GmbH
  */
-const ns = {};
+const ns = {};