ngx-dsxlibrary 1.21.41 → 1.21.43

package/fesm2022/ngx-dsxlibrary.mjs

@@ -625,11 +625,11 @@ class LoadingLottieComponent {
         });
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.1", ngImport: i0, type: LoadingLottieComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.1.1", type: LoadingLottieComponent, isStandalone: true, selector: "app-loading-lottie", inputs: { jsonUrl: { classPropertyName: "jsonUrl", publicName: "jsonUrl", isSignal: true, isRequired: false, transformFunction: null }, size: { classPropertyName: "size", publicName: "size", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: "@if(_spinnerService.spinnerVisible()){\r\n<div class=\"loader-container\">\r\n  <ng-lottie [options]=\"options\" [width]=\"size()\" [height]=\"size()\"></ng-lottie>\r\n  <p class=\"loading-text\">&copy;DevsoftXela {{ currentYear }}</p>\r\n</div>\r\n}\r\n", styles: [".loader-container{position:fixed;top:0;left:0;width:100vw;height:100vh;background-color:#0009;display:flex;justify-content:center;align-items:center;z-index:9999;overflow:hidden;opacity:0;animation:overlayFadeIn .25s ease-out forwards}.loading-text{position:absolute;bottom:calc(53% - 175px);z-index:2;font-family:Montserrat,sans-serif;text-transform:uppercase;background:linear-gradient(45deg,#0ff,#f0f);-webkit-background-clip:text;background-clip:text;color:transparent;font-weight:700;text-align:center;pointer-events:none}@keyframes overlayFadeIn{0%{opacity:0}to{opacity:1}}\n"], dependencies: [{ kind: "component", type: LottieComponent, selector: "ng-lottie", inputs: ["width", "height"] }] });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.1.1", type: LoadingLottieComponent, isStandalone: true, selector: "app-loading-lottie", inputs: { jsonUrl: { classPropertyName: "jsonUrl", publicName: "jsonUrl", isSignal: true, isRequired: false, transformFunction: null }, size: { classPropertyName: "size", publicName: "size", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: "@if(_spinnerService.spinnerVisible()){\r\n<div class=\"loader-container\">\r\n  <ng-lottie [options]=\"options\" [width]=\"size()\" [height]=\"size()\"></ng-lottie>\r\n  <p class=\"loading-text\">&copy;DevsoftXela {{ currentYear }}</p>\r\n</div>\r\n}\r\n", styles: [".loader-container{position:fixed;top:0;left:0;width:100vw;height:100vh;background-color:#000c;display:flex;justify-content:center;align-items:center;z-index:9999;overflow:hidden;opacity:0;animation:overlayFadeIn .25s ease-out forwards}.loading-text{position:absolute;bottom:calc(53% - 175px);z-index:2;font-family:Montserrat,sans-serif;text-transform:uppercase;background:linear-gradient(45deg,#0ff,#f0f);-webkit-background-clip:text;background-clip:text;color:transparent;font-weight:700;text-align:center;pointer-events:none}@keyframes overlayFadeIn{0%{opacity:0}to{opacity:1}}\n"], dependencies: [{ kind: "component", type: LottieComponent, selector: "ng-lottie", inputs: ["width", "height"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.1", ngImport: i0, type: LoadingLottieComponent, decorators: [{
             type: Component,
-            args: [{ selector: 'app-loading-lottie', imports: [LottieComponent], template: "@if(_spinnerService.spinnerVisible()){\r\n<div class=\"loader-container\">\r\n  <ng-lottie [options]=\"options\" [width]=\"size()\" [height]=\"size()\"></ng-lottie>\r\n  <p class=\"loading-text\">&copy;DevsoftXela {{ currentYear }}</p>\r\n</div>\r\n}\r\n", styles: [".loader-container{position:fixed;top:0;left:0;width:100vw;height:100vh;background-color:#0009;display:flex;justify-content:center;align-items:center;z-index:9999;overflow:hidden;opacity:0;animation:overlayFadeIn .25s ease-out forwards}.loading-text{position:absolute;bottom:calc(53% - 175px);z-index:2;font-family:Montserrat,sans-serif;text-transform:uppercase;background:linear-gradient(45deg,#0ff,#f0f);-webkit-background-clip:text;background-clip:text;color:transparent;font-weight:700;text-align:center;pointer-events:none}@keyframes overlayFadeIn{0%{opacity:0}to{opacity:1}}\n"] }]
+            args: [{ selector: 'app-loading-lottie', imports: [LottieComponent], template: "@if(_spinnerService.spinnerVisible()){\r\n<div class=\"loader-container\">\r\n  <ng-lottie [options]=\"options\" [width]=\"size()\" [height]=\"size()\"></ng-lottie>\r\n  <p class=\"loading-text\">&copy;DevsoftXela {{ currentYear }}</p>\r\n</div>\r\n}\r\n", styles: [".loader-container{position:fixed;top:0;left:0;width:100vw;height:100vh;background-color:#000c;display:flex;justify-content:center;align-items:center;z-index:9999;overflow:hidden;opacity:0;animation:overlayFadeIn .25s ease-out forwards}.loading-text{position:absolute;bottom:calc(53% - 175px);z-index:2;font-family:Montserrat,sans-serif;text-transform:uppercase;background:linear-gradient(45deg,#0ff,#f0f);-webkit-background-clip:text;background-clip:text;color:transparent;font-weight:700;text-align:center;pointer-events:none}@keyframes overlayFadeIn{0%{opacity:0}to{opacity:1}}\n"] }]
         }], ctorParameters: () => [], propDecorators: { jsonUrl: [{ type: i0.Input, args: [{ isSignal: true, alias: "jsonUrl", required: false }] }], size: [{ type: i0.Input, args: [{ isSignal: true, alias: "size", required: false }] }] } });
 
 class CssV2Component {
@@ -2308,21 +2308,63 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.1", ngImpor
                 }]
         }] });
 
+/**
+ * Servicio genérico para consumir endpoints REST de la API.
+ *
+ * @typeParam T Tipo de dato que representa el recurso manejado por el endpoint.
+ */
 class EndpointService {
+    /** Cliente HTTP de Angular utilizado para realizar las peticiones. */
     http = inject(HttpClient);
+    /** Configuración de entorno que contiene la URL base de la API. */
     environment = inject(ENVIRONMENT);
+    /**
+     * Construye la URL completa del endpoint a partir de la configuración de entorno.
+     *
+     * @param endpoint Segmento del endpoint (por ejemplo: 'usuarios', 'facturas').
+     * @returns URL absoluta del endpoint.
+     */
     getUrl(endpoint) {
         return `${this.environment.myAppUrl}api/${endpoint}`;
     }
+    /**
+     * Obtiene un listado de recursos del endpoint especificado.
+     *
+     * @param endpoint Segmento del endpoint (sin la parte de `api/`).
+     * @param invalidateCache Indica si se invalida la caché del lado del servidor.
+     * @returns Observable con un arreglo de elementos del tipo `T`.
+     */
     list(endpoint, invalidateCache = false) {
         return this.http.get(`${this.getUrl(endpoint)}/listar/${invalidateCache}`);
     }
+    /**
+     * Obtiene un recurso por su identificador.
+     *
+     * @param endpoint Segmento del endpoint (sin la parte de `api/`).
+     * @param id Identificador del recurso a recuperar.
+     * @returns Observable con el elemento del tipo `T`.
+     */
     edit(endpoint, id) {
         return this.http.get(`${this.getUrl(endpoint)}/get-id/${id}`);
     }
+    /**
+     * Crea o actualiza un recurso en el endpoint especificado.
+     *
+     * @param endpoint Segmento del endpoint (sin la parte de `api/`).
+     * @param values Objeto con los datos del recurso a guardar.
+     * @returns Observable con el resultado del servicio que envuelve al tipo `T`.
+     */
     save(endpoint, values) {
         return this.http.put(`${this.getUrl(endpoint)}/save`, values);
     }
+    /**
+     * Elimina un recurso del endpoint especificado.
+     *
+     * @param endpoint Segmento del endpoint (sin la parte de `api/`).
+     * @param id Identificador del recurso a eliminar.
+     * @param softDelete Indica si la eliminación es lógica (por defecto) o física.
+     * @returns Observable con el modelo de respuesta HTTP genérico.
+     */
     delete(endpoint, id, softDelete = true) {
         return this.http.delete(`${this.getUrl(endpoint)}/delete/${id}/${softDelete}`);
     }