ngx-dsxlibrary 1.21.40 → 1.21.42

package/fesm2022/ngx-dsxlibrary.mjs

@@ -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}`);
     }
@@ -2867,6 +2909,58 @@ class UtilityAddService {
             this._serviceAlerta.toastrAlerts(4, 'Error', error instanceof Error ? error.message : String(error), 2);
         }
     }
+    /**
+     * Maneja la respuesta estándar de una operación HTTP que devuelve un ServiceResult<T>,
+     * mostrando alertas y realizando acciones comunes en formularios.
+     *
+     * @typeParam T - Tipo de dato contenido en la propiedad data de ServiceResult.
+     * @param response - Respuesta del servicio (debe tener isSuccess, title, message, etc.).
+     * @param urlHome - Ruta a la que se navega si la operación es exitosa y el id es mayor a 0.
+     * @param form - Formulario reactivo a resetear si la operación es exitosa.
+     * @param getForm - Función para recargar el formulario (por ejemplo, para obtener datos actualizados).
+     * @param id - Identificador usado para decidir si se navega a urlHome tras éxito.
+     *
+     * @example
+     * // Uso típico en un componente con ServiceResult
+     * this.utilityAddService.handleResponseService<MiModelo>(
+     *   response,
+     *   '/home',
+     *   this.form,
+     *   () => this.getForm(),
+     *   this.id
+     * );
+     *
+     * @description
+     * - Si response.isSuccess es true:
+     *   - Muestra alerta tipo toastr.
+     *   - Si id > 0, navega a urlHome.
+     *   - Resetea el formulario y ejecuta getForm().
+     * - Si response.isSuccess es false:
+     *   - Muestra alerta visual personalizada con icono de error.
+     */
+    handleResponseService(response, urlHome, form, getForm, id) {
+        try {
+            this.logIfNotProduction('handleResponse - response:', response);
+            if (response.isSuccess) {
+                this._serviceAlerta.toastrAlerts(1, response.title, response.message, 2);
+                if (id > 0) {
+                    this._router.navigate([urlHome]);
+                }
+                getForm();
+                form?.reset();
+            }
+            else {
+                this._serviceAlerta.alertaHtmlSuccess(response.title, response.message, {
+                    icono: 'icon2/hard_drive_error.png',
+                    showConfirmButton: true,
+                });
+            }
+        }
+        catch (error) {
+            this.logIfNotProduction('Error en handleResponseService:', error);
+            this._serviceAlerta.toastrAlerts(4, 'Error', error instanceof Error ? error.message : String(error), 2);
+        }
+    }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.1", ngImport: i0, type: UtilityAddService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.1", ngImport: i0, type: UtilityAddService, providedIn: 'root' });
 }