turbogui-angular 15.2.0 → 15.2.1

package/esm2022/main/model/classes/View.mjs

@@ -8,7 +8,7 @@
  */
 /**
  * Defines an application view.
- * Our View components must extend this class so they can be manipulated via ViewsService and be correctly linked to a view service.
+ * Our View components must extend this class so they can be manipulated via ViewsService and be correctly linked to a views-container.
  */
 export class View {
     /**
@@ -21,4 +21,4 @@ export class View {
         }
     }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVmlldy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3Byb2plY3RzL3R1cmJvZ3VpLWFuZ3VsYXIvc3JjL21haW4vbW9kZWwvY2xhc3Nlcy9WaWV3LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7O0dBT0c7QUFNSDs7O0dBR0c7QUFDSCxNQUFNLE9BQWdCLElBQUk7SUFHekI7OztPQUdHO0lBQ0gsWUFBWSxnQkFBa0MsRUFBRSxXQUE0QjtRQUUzRSxJQUFHLFdBQVcsS0FBSyxJQUFJLEVBQUM7WUFFdkIsV0FBVyxDQUFDLGdCQUFnQixHQUFHLGdCQUFnQixDQUFDO1NBQ2hEO0lBQ0YsQ0FBQztDQUNEIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXHJcbiAqIFR1cmJvR1VJIGlzIEEgbGlicmFyeSB0aGF0IGhlbHBzIHdpdGggdGhlIG1vc3QgY29tbW9uIGFuZCBnZW5lcmljIFVJIGVsZW1lbnRzIGFuZCBmdW5jdGlvbmFsaXRpZXNcclxuICpcclxuICogV2Vic2l0ZSA6IC0+IGh0dHA6Ly93d3cudHVyYm9ndWkub3JnXHJcbiAqIExpY2Vuc2UgOiAtPiBMaWNlbnNlZCB1bmRlciB0aGUgQXBhY2hlIExpY2Vuc2UsIFZlcnNpb24gMi4wLiBZb3UgbWF5IG5vdCB1c2UgdGhpcyBmaWxlIGV4Y2VwdCBpbiBjb21wbGlhbmNlIHdpdGggdGhlIExpY2Vuc2UuXHJcbiAqIExpY2Vuc2UgVXJsIDogLT4gaHR0cDovL3d3dy5hcGFjaGUub3JnL2xpY2Vuc2VzL0xJQ0VOU0UtMi4wXHJcbiAqIENvcHlSaWdodCA6IC0+IENvcHlyaWdodCAyMDE4IEVkZXJ0b25lIEFkdmFuZGVkIFNvbHV0aW9ucy4gaHR0cHM6Ly93d3cuZWRlcnRvbmUuY29tXHJcbiAqL1xyXG5cbmltcG9ydCB7IFZpZXdDb250YWluZXJSZWYgfSBmcm9tIFwiQGFuZ3VsYXIvY29yZVwiO1xuaW1wb3J0IHsgVmlld1NlcnZpY2UgfSBmcm9tIFwiLi9WaWV3U2VydmljZVwiO1xuXHJcblxyXG4vKipcclxuICogRGVmaW5lcyBhbiBhcHBsaWNhdGlvbiB2aWV3LlxyXG4gKiBPdXIgVmlldyBjb21wb25lbnRzIG11c3QgZXh0ZW5kIHRoaXMgY2xhc3Mgc28gdGhleSBjYW4gYmUgbWFuaXB1bGF0ZWQgdmlhIFZpZXdzU2VydmljZSBhbmQgYmUgY29ycmVjdGx5IGxpbmtlZCB0byBhIHZpZXcgc2VydmljZS5cclxuICovXHJcbmV4cG9ydCBhYnN0cmFjdCBjbGFzcyBWaWV3IHtcclxuXHJcblxyXG5cdC8qKlxyXG5cdCAqIFRoaXMgY29uc3RydWN0b3IgaXMgc3BlY2lmaWNhbGx5IGRlc2lnbmVkIHRvIGZvcmNlIHRoZSB2aWV3IHRvIHNldCB0aGUgdmlld0NvbnRhaW5lclJlZiB3aGljaCB3aWxsIGJlIGF1dG9tYXRpY2FsbHkgYXNzaWduZWRcclxuXHQgKiB0byB0aGUgcmVzcGVjdGl2ZSB2aWV3IHNlcnZpY2UuIElmIHRoZSB2aWV3IGhhcyBubyBzZXJ2aWNlLCB3ZSBjYW4gc2V0IGl0IHRvIG51bGwuXHJcblx0ICovXHJcblx0Y29uc3RydWN0b3Iodmlld0NvbnRhaW5lclJlZjogVmlld0NvbnRhaW5lclJlZiwgdmlld1NlcnZpY2U6Vmlld1NlcnZpY2V8bnVsbCkge1xyXG5cdFxyXG5cdFx0aWYodmlld1NlcnZpY2UgIT09IG51bGwpe1xyXG5cdFx0XHRcclxuXHRcdFx0dmlld1NlcnZpY2Uudmlld0NvbnRhaW5lclJlZiA9IHZpZXdDb250YWluZXJSZWY7XHJcblx0XHR9XHRcclxuXHR9XHJcbn1cclxuIl19
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVmlldy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3Byb2plY3RzL3R1cmJvZ3VpLWFuZ3VsYXIvc3JjL21haW4vbW9kZWwvY2xhc3Nlcy9WaWV3LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7O0dBT0c7QUFNSDs7O0dBR0c7QUFDSCxNQUFNLE9BQWdCLElBQUk7SUFHekI7OztPQUdHO0lBQ0gsWUFBWSxnQkFBa0MsRUFBRSxXQUE0QjtRQUUzRSxJQUFHLFdBQVcsS0FBSyxJQUFJLEVBQUM7WUFFdkIsV0FBVyxDQUFDLGdCQUFnQixHQUFHLGdCQUFnQixDQUFDO1NBQ2hEO0lBQ0YsQ0FBQztDQUNEIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXHJcbiAqIFR1cmJvR1VJIGlzIEEgbGlicmFyeSB0aGF0IGhlbHBzIHdpdGggdGhlIG1vc3QgY29tbW9uIGFuZCBnZW5lcmljIFVJIGVsZW1lbnRzIGFuZCBmdW5jdGlvbmFsaXRpZXNcclxuICpcclxuICogV2Vic2l0ZSA6IC0+IGh0dHA6Ly93d3cudHVyYm9ndWkub3JnXHJcbiAqIExpY2Vuc2UgOiAtPiBMaWNlbnNlZCB1bmRlciB0aGUgQXBhY2hlIExpY2Vuc2UsIFZlcnNpb24gMi4wLiBZb3UgbWF5IG5vdCB1c2UgdGhpcyBmaWxlIGV4Y2VwdCBpbiBjb21wbGlhbmNlIHdpdGggdGhlIExpY2Vuc2UuXHJcbiAqIExpY2Vuc2UgVXJsIDogLT4gaHR0cDovL3d3dy5hcGFjaGUub3JnL2xpY2Vuc2VzL0xJQ0VOU0UtMi4wXHJcbiAqIENvcHlSaWdodCA6IC0+IENvcHlyaWdodCAyMDE4IEVkZXJ0b25lIEFkdmFuZGVkIFNvbHV0aW9ucy4gaHR0cHM6Ly93d3cuZWRlcnRvbmUuY29tXHJcbiAqL1xyXG5cbmltcG9ydCB7IFZpZXdDb250YWluZXJSZWYgfSBmcm9tIFwiQGFuZ3VsYXIvY29yZVwiO1xuaW1wb3J0IHsgVmlld1NlcnZpY2UgfSBmcm9tIFwiLi9WaWV3U2VydmljZVwiO1xuXHJcblxyXG4vKipcclxuICogRGVmaW5lcyBhbiBhcHBsaWNhdGlvbiB2aWV3LlxyXG4gKiBPdXIgVmlldyBjb21wb25lbnRzIG11c3QgZXh0ZW5kIHRoaXMgY2xhc3Mgc28gdGhleSBjYW4gYmUgbWFuaXB1bGF0ZWQgdmlhIFZpZXdzU2VydmljZSBhbmQgYmUgY29ycmVjdGx5IGxpbmtlZCB0byBhIHZpZXdzLWNvbnRhaW5lci5cclxuICovXHJcbmV4cG9ydCBhYnN0cmFjdCBjbGFzcyBWaWV3IHtcclxuXHJcblxyXG5cdC8qKlxyXG5cdCAqIFRoaXMgY29uc3RydWN0b3IgaXMgc3BlY2lmaWNhbGx5IGRlc2lnbmVkIHRvIGZvcmNlIHRoZSB2aWV3IHRvIHNldCB0aGUgdmlld0NvbnRhaW5lclJlZiB3aGljaCB3aWxsIGJlIGF1dG9tYXRpY2FsbHkgYXNzaWduZWRcclxuXHQgKiB0byB0aGUgcmVzcGVjdGl2ZSB2aWV3IHNlcnZpY2UuIElmIHRoZSB2aWV3IGhhcyBubyBzZXJ2aWNlLCB3ZSBjYW4gc2V0IGl0IHRvIG51bGwuXHJcblx0ICovXHJcblx0Y29uc3RydWN0b3Iodmlld0NvbnRhaW5lclJlZjogVmlld0NvbnRhaW5lclJlZiwgdmlld1NlcnZpY2U6Vmlld1NlcnZpY2V8bnVsbCkge1xyXG5cdFxyXG5cdFx0aWYodmlld1NlcnZpY2UgIT09IG51bGwpe1xyXG5cdFx0XHRcclxuXHRcdFx0dmlld1NlcnZpY2Uudmlld0NvbnRhaW5lclJlZiA9IHZpZXdDb250YWluZXJSZWY7XHJcblx0XHR9XHRcclxuXHR9XHJcbn1cclxuIl19

package/fesm2022/turbogui-angular.mjs

@@ -811,8 +811,8 @@ class DialogService extends SingletoneStrictClass {
      *            - viewContainerRef: This is important if we want to propagate providers from a parent component to this dialog. We must specify
      *              this reference to make sure the same services injected on the parent are available too at the child dialog
      *
-     * @param callback A function that will be called after the dialog is closed and will receive a selection object with the numeric index and value for
-     *        the option that's been selected by the user. if no option was selected, index will be -1 and value null
+     * @param callback A function that will be called after the dialog is closed. It will receive a selection object with two properties: index and value. Those
+     *        will contain the index and value from the options array that's selected by the user. if no option selected, index will be -1 and value null
      */
     addDialog(dialogComponentClass, properties, callback = null) {
         if (!this._isEnabled) {
@@ -1135,6 +1135,8 @@ class TurboApiCallerService extends SingletoneStrictClass {
         this.browserService = browserService;
         /**
          * URI Path to the web service that performs the user login
+         * TODO - crear una clase apipaths amb les constants de totes les rutes i moure aquestes 3 alla
+         * aquesta classe haura de ser extesa a la nostra app amb les altres que es fagin servir
          */
         this.loginServiceURI = 'users/login';
         /**
@@ -1147,6 +1149,8 @@ class TurboApiCallerService extends SingletoneStrictClass {
         this.mailVerifyServiceURI = 'users/user-mail-verify';
         /**
          * The username that is currently defined and will be used by the login methods
+         * TODO - We must use a setter and a getter of user and psw. If any of the values change
+         * we must clear the logged state and the token.
          */
         this.userName = '';
         /**
@@ -1252,10 +1256,13 @@ class TurboApiCallerService extends SingletoneStrictClass {
         ;
     }
     /**
-     * Authenticates the user by sending an encoded credentials request to the login web service.
+     * Authenticates the userName and password that are currently defined at the respective properties of this service.
      * Returns a promise that resolves with the server's response or rejects with an error if the login fails.
      * Path to the login service must be correctly defined at this.loginWebService
      *
+     * The authentication process is performed by sending an encoded credentials request to the login web service using the
+     * currently defined user name and psw.
+     *
      * Here's an example of a call:
      *
      *  login().then(response => {
@@ -1306,7 +1313,8 @@ class TurboApiCallerService extends SingletoneStrictClass {
         return !StringUtils.isEmpty(this.userName) && !StringUtils.isEmpty(this.password);
     }
     /**
-     * Tells if exists a user that is currently logged or not
+     * Tells if the user name and psw that are specified on this service are currently logged or not. This means
+     * also a token is active.
      */
     get isLogged() {
         return this._isLogged;
@@ -1529,6 +1537,10 @@ class ViewsService extends SingletoneStrictClass {
          * Contains the reference to the currently loaded view component
          */
         this._currentComponentRef = null;
+        /**
+         * Flag that stores if any view is in the process of being loaded
+         */
+        this._isLoadingView = false;
     }
     /**
      * Tells if there's any view currently loaded on the application views container
@@ -1550,20 +1562,25 @@ class ViewsService extends SingletoneStrictClass {
     }
     /**
      * Create a new view instance with the specified type and add it to the current application views container. Any currently loaded
-     * view will be removed
+     * view will be removed.
      *
-     * Make sure this method is called when all the visual components of the application have been created (ngAfterViewInit)
+     * If we push a view while another one is in the process of being loaded, the new push will be ignored.
      *
-     * @param view The classname for the view that we want to create and add to the views container (must extend View base class).
+     * Make sure this method is called when all the visual components of the application have been created (ngAfterViewInit)
      *
-     * @return The instance of the newly added and created view.
+     * @param view The classname for the view that we want to create (must extend View base class). A new angular object
+     *        will be instantiated and loaded into the views container.
      */
     async pushView(view) {
-        this.verifyViewsContainerExist();
         // If the loaded view is the same as the specified one, we will do nothing
         if (this._loadedViewClass === view) {
-            return this._currentComponentRef;
+            return;
+        }
+        // If a view is already being loaded, nothing to do
+        if (this._isLoadingView) {
+            return;
         }
+        this._isLoadingView = true;
         // If a view is already loaded, we will unload it first
         if (this._loadedViewClass !== null) {
             await this.removeCurrentView();
@@ -1582,18 +1599,17 @@ class ViewsService extends SingletoneStrictClass {
             fadeInPlayer.onDone(() => {
                 this._currentComponentRef = newComponentRef;
                 this._loadedViewClass = view;
+                this._isLoadingView = false;
                 resolve();
             });
             fadeInPlayer.play();
         });
-        return this._currentComponentRef;
     }
     /**
      * Delete the currently loaded view from the views container, and leave it empty.
      * If no view is currently loaded, this method will do nothing
      */
     async popView() {
-        this.verifyViewsContainerExist();
         if (this._loadedViewClass !== null && this._currentComponentRef) {
             await this.removeCurrentView();
         }
@@ -1602,6 +1618,9 @@ class ViewsService extends SingletoneStrictClass {
      * Aux method to remove the currently loaded view from the views container using a promise
      */
     removeCurrentView() {
+        if (this._viewContainerRef === null) {
+            throw new Error('Views container not defined. Please declare a <views-container> element in your application');
+        }
         return new Promise((resolve) => {
             if (this._currentComponentRef) {
                 const element = this._currentComponentRef.location.nativeElement;
@@ -1624,14 +1643,6 @@ class ViewsService extends SingletoneStrictClass {
             }
         });
     }
-    /**
-     * Auxiliary method to test if the views container instance is available on the application
-     */
-    verifyViewsContainerExist() {
-        if (this._viewContainerRef === null) {
-            throw new Error('Views container not defined. Please declare a <views-container> element in your application');
-        }
-    }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "17.0.8", ngImport: i0, type: ViewsService, deps: [{ token: i1$2.AnimationBuilder }], target: i0.ɵɵFactoryTarget.Injectable }); }
     static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "17.0.8", ngImport: i0, type: ViewsService, providedIn: 'root' }); }
 }
@@ -2281,7 +2292,7 @@ class GUINotification {
  */
 /**
  * Defines an application view.
- * Our View components must extend this class so they can be manipulated via ViewsService and be correctly linked to a view service.
+ * Our View components must extend this class so they can be manipulated via ViewsService and be correctly linked to a views-container.
  */
 class View {
     /**