ngx-dsxlibrary 1.21.41 → 1.21.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-dsxlibrary",
-  "version": "1.21.41",
+  "version": "1.21.42",
   "description": "Libreria para control de código automatizado.",
   "author": "DevSoftXela",
   "dependencies": {

package/types/ngx-dsxlibrary.d.ts

@@ -1086,13 +1086,55 @@ declare class DteService {
     static ɵprov: i0.ɵɵInjectableDeclaration<DteService>;
 }
 
+/**
+ * Servicio genérico para consumir endpoints REST de la API.
+ *
+ * @typeParam T Tipo de dato que representa el recurso manejado por el endpoint.
+ */
 declare class EndpointService<T> {
+    /** Cliente HTTP de Angular utilizado para realizar las peticiones. */
     private http;
+    /** Configuración de entorno que contiene la URL base de la API. */
     private 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.
+     */
     private getUrl;
+    /**
+     * 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: string, invalidateCache?: boolean): Observable<T[]>;
+    /**
+     * 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: string, id: number): Observable<T>;
-    save(endpoint: string, values: T): Observable<ResponseHttpModel>;
+    /**
+     * 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: string, values: T): Observable<ServiceResult<T>>;
+    /**
+     * 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: string, id: number, softDelete?: boolean): Observable<ResponseHttpModel>;
     static ɵfac: i0.ɵɵFactoryDeclaration<EndpointService<any>, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<EndpointService<any>>;