neo.mjs 4.6.5 → 4.6.7

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "neo.mjs",
-    "version": "4.6.5",
+    "version": "4.6.7",
     "description": "The webworkers driven UI framework",
     "type": "module",
     "repository": {
@@ -47,7 +47,7 @@
         "autoprefixer": "^10.4.13",
         "chalk": "^5.2.0",
         "clean-webpack-plugin": "^4.0.0",
-        "commander": "^9.4.1",
+        "commander": "^9.5.0",
         "cssnano": "^5.1.14",
         "envinfo": "^7.8.1",
         "fs-extra": "^11.1.0",
@@ -55,7 +55,7 @@
         "inquirer": "^9.1.4",
         "neo-jsdoc": "^1.0.1",
         "neo-jsdoc-x": "^1.0.4",
-        "postcss": "^8.4.20",
+        "postcss": "^8.4.21",
         "sass": "^1.57.1",
         "webpack": "^5.75.0",
         "webpack-cli": "^5.0.1",

package/src/collection/Base.mjs

@@ -743,23 +743,26 @@ class Base extends CoreBase {
     }
 
     /**
-     * Returns all items which match the property and value
+     * Returns items which match the property and value
      * @param {Object|String} property
-     * @param {String|Number} [value] Optional, in case the first param is an object
-     * @returns {Array} Returns an empty Array in case no items are found
+     * @param {String|Number} [value] Only required in case the first param is a string
+     * @param {Boolean} returnFirstMatch=false
+     * @returns {Object|Object[]}
+     *     returnFirstMatch=false: Returns an empty Array in case no items are found
+     *     returnFirstMatch=true:  Returns the first found item or null
      */
-    find(property, value) {
+    find(property, value, returnFirstMatch=false) {
         let me               = this,
             items            = [],
             isObjectProperty = Neo.isObject(property),
-            matchArray, propertiesArray, propertiesLength;
+            item, matchArray, propertiesArray, propertiesLength;
 
         if (isObjectProperty) {
             propertiesArray  = Object.entries(property);
             propertiesLength = propertiesArray.length;
         }
 
-        me.items.forEach(item => {
+        for (item of me.items) {
             if (isObjectProperty) {
                 matchArray = [];
 
@@ -770,33 +773,35 @@ class Base extends CoreBase {
                 });
 
                 if (matchArray.length === propertiesLength) {
+                    if (returnFirstMatch) {
+                        return item;
+                    }
+
                     items.push(item);
                 }
-            }
-            else if (item[property] === value) {
+            } else if (item[property] === value) {
                 items.push(item);
             }
-        });
+        }
 
-        return items;
+        return returnFirstMatch ? null : items;
     }
 
     /**
      * Returns all items in the collection for which the passed function returns true
      * @param {function} fn The function to run for each item inside the start-end range. Return true for a match.
      * @param {Object} fn.item The current collection item
-     * @param {Object} [scope=this] The scope in which the passed function gets executed
-     * @param {Number} [start=0] The start index
-     * @param {Number} [end=this.getCount()] The end index (up to, last value excluded)
+     * @param {Object} scope=this The scope in which the passed function gets executed
+     * @param {Number} start=0 The start index
+     * @param {Number} end=this.getCount() The end index (up to, last value excluded)
      * @returns {Array} Returns an empty Array in case no items are found
      */
-    findBy(fn, scope=this, start, end) {
+    findBy(fn, scope=this, start=0, end=this.getCount()) {
         let me    = this,
             items = [],
-            i     = start || 0,
-            len   = end   || me.getCount();
+            i     = start;
 
-        for (; i < len; i++) {
+        for (; i < end; i++) {
             if (fn.call(scope, me.items[i])) {
                 items.push(me.items[i]);
             }
@@ -805,6 +810,16 @@ class Base extends CoreBase {
         return items;
     }
 
+    /**
+     * Returns the first item which matches the property and value
+     * @param {Object|String} property
+     * @param {String|Number} [value] Only required in case the first param is a string
+     * @returns {Object} Returns the first found item or null
+     */
+    findFirst(property, value) {
+        return this.find(property, value, true);
+    }
+
     /**
      * Returns the first item inside the collection
      * @returns {Object}

package/src/data/Store.mjs

@@ -311,9 +311,20 @@ class Store extends Base {
         RecordFactory.createRecord(config);
     }
 
-    load() {
-        let me = this,
-            params = {page: me.currentPage, pageSize: me.pageSize};
+    /**
+     * @param {Object} opts={}
+     * @param {Object} opts.data
+     * @param {Object} opts.headers
+     * @param {String} opts.method DELETE, GET, POST, PUT
+     * @param {Object} opts.params
+     * @param {String} opts.responseType
+     * @param {Object} opts.scope
+     * @param {String} opts.url
+     * @protected
+     */
+    load(opts={}) {
+        let me     = this,
+            params = {page: me.currentPage, pageSize: me.pageSize, ...opts.params};
 
         if (me.remoteFilter) {
             params.filters = me.exportFilters();
@@ -332,18 +343,18 @@ class Store extends Base {
                 console.log('Api is not defined', this);
             } else {
                 service[fn](params).then(response => {
+                    response = Neo.ns(me.responseRoot, false, response);
+
                     if (response.success) {
                         me.totalCount = response.totalCount;
-                        me.data       = response.data; // fires the load event
+                        me.data       = Neo.ns(me.responseRoot, false, response); // fires the load event
                     }
                 });
             }
         } else {
-            params.url = me.url;
+            opts.url ??= me.url;
 
-            Neo.Xhr.promiseJson({
-                url: params.url
-            }).catch(err => {
+            Neo.Xhr.promiseJson(opts).catch(err => {
                 console.log('Error for Neo.Xhr.request', err, me.id);
             }).then(data => {
                 me.data = Neo.ns(me.responseRoot, false, data.json) || data.json;

package/src/manager/Instance.mjs

@@ -32,7 +32,9 @@ class Instance extends Base {
 
         me.consumeNeoIdMap();
 
-        Neo.get = me.get.bind(me); // alias
+        Neo.find      = me.find     .bind(me); // alias
+        Neo.findFirst = me.findFirst.bind(me); // alias
+        Neo.get       = me.get      .bind(me); // alias
     }
 
     /**