ngx-dsxlibrary 2.21.2 → 2.21.4

package/fesm2022/ngx-dsxlibrary.mjs

@@ -3258,7 +3258,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.7", ngImpor
 /**
  * Servicio genérico para consumir endpoints REST de la API.
  *
- * @typeParam T Tipo de dato que representa el recurso manejado por el endpoint.
+ * @typeParam T Tipo base de la entidad. Puede sobrescribirse por método.
  */
 class EndpointService {
     /** Cliente HTTP de Angular utilizado para realizar las peticiones. */
@@ -3277,9 +3277,10 @@ class EndpointService {
     /**
      * Obtiene un listado de recursos del endpoint especificado.
      *
+     * @typeParam TList Tipo de cada elemento del listado (por defecto `T`).
      * @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`.
+     * @returns Observable con un arreglo de elementos del tipo `TList`.
      */
     list(endpoint, invalidateCache = false) {
         return this.http.get(`${this.getUrl(endpoint)}/listar/${invalidateCache}`);
@@ -3287,9 +3288,10 @@ class EndpointService {
     /**
      * Obtiene un recurso por su identificador.
      *
+     * @typeParam TEdit Tipo del recurso retornado (por defecto `T`).
      * @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`.
+     * @returns Observable con el elemento del tipo `TEdit`.
      */
     edit(endpoint, id) {
         return this.http.get(`${this.getUrl(endpoint)}/get-id/${id}`);
@@ -3297,9 +3299,11 @@ class EndpointService {
     /**
      * Crea o actualiza un recurso en el endpoint especificado.
      *
+     * @typeParam TSave Tipo del payload enviado al backend (por defecto `T`).
+     * @typeParam TResponse Tipo de la entidad en la respuesta (por defecto `T`).
      * @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`.
+     * @returns Observable con el resultado del servicio que envuelve `TResponse`.
      */
     save(endpoint, values) {
         return this.http.put(`${this.getUrl(endpoint)}/save`, values);
@@ -3308,7 +3312,7 @@ class EndpointService {
      * Elimina un recurso del endpoint especificado.
      *
      * @param endpoint Segmento del endpoint (sin la parte de `api/`).
-     * @param id Identificador del recurso a eliminar.
+     * @param id Identificador del recurso a eliminar (numérico o textual).
      * @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.
      */
@@ -3325,19 +3329,46 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.7", ngImpor
                 }]
         }] });
 
+/**
+ * Clase base para servicios CRUD tipados.
+ *
+ * @typeParam TBase Modelo base que representa la entidad principal.
+ * @typeParam TEdit Modelo de respuesta para la operación de edición/consulta por id.
+ * @typeParam TSave Modelo de entrada para guardar (create/update).
+ * @typeParam TList Modelo de cada elemento del listado.
+ * @typeParam TDelete Tipo del identificador usado para eliminar (number o string).
+ */
 class BaseCRUDService {
-    _endpointService = inject((EndpointService));
+    /** Servicio HTTP base para operaciones REST. */
+    _endpointService = inject(EndpointService);
+    /**
+     * Obtiene el listado de registros.
+     * @param invalidateCache Si es true, solicita invalidar caché en backend.
+     */
     list(invalidateCache = false) {
         return this._endpointService.list(this.endpoint, invalidateCache);
     }
+    /**
+     * Obtiene un registro por id para edición.
+     * @param id Identificador numérico del registro.
+     */
     edit(id) {
         return this._endpointService.edit(this.endpoint, id);
     }
+    /**
+     * Guarda un registro (creación o actualización).
+     * @param values Payload tipado para persistir.
+     */
     save(values) {
         return this._endpointService.save(this.endpoint, values);
     }
-    delete(id, softDelete = true) {
-        return this._endpointService.delete(this.endpoint, id, softDelete);
+    /**
+     * Elimina un registro por identificador.
+     * @param value Identificador del registro a eliminar.
+     * @param softDelete Si es true, realiza eliminación lógica.
+     */
+    delete(value, softDelete = true) {
+        return this._endpointService.delete(this.endpoint, value, softDelete);
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.7", ngImport: i0, type: BaseCRUDService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.7", ngImport: i0, type: BaseCRUDService, providedIn: 'root' });
@@ -3627,6 +3658,223 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.7", ngImpor
                 }]
         }] });
 
+function pickByKeys(source, keys) {
+    const result = {};
+    for (const key of keys) {
+        result[key] = source[key];
+    }
+    return result;
+}
+function tryParseDateValue(value) {
+    if (value instanceof Date) {
+        const time = value.getTime();
+        return Number.isNaN(time) ? null : time;
+    }
+    if (typeof value === 'string' || typeof value === 'number') {
+        const parsed = new Date(value);
+        const time = parsed.getTime();
+        return Number.isNaN(time) ? null : time;
+    }
+    return null;
+}
+function normalizeComparableValue(base, current) {
+    const baseDateValue = tryParseDateValue(base);
+    if (baseDateValue !== null) {
+        const currentDateValue = tryParseDateValue(current);
+        return currentDateValue ?? current;
+    }
+    return current;
+}
+function normalizeBaseEntity(baseValue, keys) {
+    const normalized = {};
+    const selectedKeys = keys ?? Object.keys(baseValue);
+    for (const key of selectedKeys) {
+        const base = baseValue[key];
+        normalized[key] = normalizeComparableValue(base, base);
+    }
+    return normalized;
+}
+function normalizeRawEntityAgainstBase(baseValue, rawValue, keys, useBaseValueForNullish = true) {
+    const coerceByBaseType = (base, current) => {
+        if (typeof base === 'number') {
+            if (typeof current === 'string' && current.trim() !== '') {
+                const normalizedText = current.trim();
+                const direct = Number(normalizedText);
+                if (!Number.isNaN(direct))
+                    return direct;
+                const commaDecimal = Number(normalizedText.replace(',', '.'));
+                if (!Number.isNaN(commaDecimal))
+                    return commaDecimal;
+                const noSpaces = normalizedText.replace(/\s+/g, '');
+                const noThousandsDots = Number(noSpaces.replace(/\./g, '').replace(',', '.'));
+                if (!Number.isNaN(noThousandsDots))
+                    return noThousandsDots;
+                return current;
+            }
+            return current;
+        }
+        if (typeof base === 'boolean') {
+            if (typeof current === 'string') {
+                const lowered = current.trim().toLowerCase();
+                if (lowered === 'true')
+                    return true;
+                if (lowered === 'false')
+                    return false;
+            }
+            return current;
+        }
+        if (base instanceof Date) {
+            if (current instanceof Date)
+                return current;
+            if (typeof current === 'string' || typeof current === 'number') {
+                const parsed = new Date(current);
+                return Number.isNaN(parsed.getTime()) ? current : parsed;
+            }
+            return current;
+        }
+        if (typeof base === 'string') {
+            if (current === null || current === undefined)
+                return current;
+            return typeof current === 'string' ? current : String(current);
+        }
+        return current;
+    };
+    const normalized = {};
+    const selectedKeys = keys ?? Object.keys(baseValue);
+    for (const key of selectedKeys) {
+        const base = baseValue[key];
+        const current = rawValue[key];
+        const isNullish = current === null || current === undefined;
+        const isEmptyString = typeof current === 'string' && current.trim() === '';
+        const treatEmptyAsNullish = isEmptyString && typeof base !== 'string';
+        const shouldUseBase = useBaseValueForNullish && (isNullish || treatEmptyAsNullish);
+        normalized[key] = shouldUseBase ? base : coerceByBaseType(base, current);
+        normalized[key] = normalizeComparableValue(base, normalized[key]);
+    }
+    return normalized;
+}
+/**
+ * Servicio utilitario para detectar cambios en formularios o vistas
+ * maestro-detalle sin acoplarse a una estructura de dominio concreta.
+ */
+class MasterDetailChangeService {
+    static findFirstDifference(leftValue, rightValue, path = 'root') {
+        if (leftValue instanceof Date && rightValue instanceof Date) {
+            return leftValue.getTime() === rightValue.getTime()
+                ? null
+                : { path, leftValue, rightValue };
+        }
+        if (Array.isArray(leftValue) && Array.isArray(rightValue)) {
+            if (leftValue.length !== rightValue.length) {
+                return {
+                    path: `${path}.length`,
+                    leftValue: leftValue.length,
+                    rightValue: rightValue.length,
+                };
+            }
+            for (let index = 0; index < leftValue.length; index += 1) {
+                const difference = MasterDetailChangeService.findFirstDifference(leftValue[index], rightValue[index], `${path}[${index}]`);
+                if (difference) {
+                    return difference;
+                }
+            }
+            return null;
+        }
+        if (leftValue != null &&
+            rightValue != null &&
+            typeof leftValue === 'object' &&
+            typeof rightValue === 'object') {
+            const leftKeys = Object.keys(leftValue);
+            const rightKeys = Object.keys(rightValue);
+            if (leftKeys.length !== rightKeys.length) {
+                return {
+                    path: `${path}.__keys__`,
+                    leftValue: leftKeys,
+                    rightValue: rightKeys,
+                };
+            }
+            for (const key of leftKeys) {
+                const difference = MasterDetailChangeService.findFirstDifference(leftValue[key], rightValue[key], `${path}.${key}`);
+                if (difference) {
+                    return difference;
+                }
+            }
+            return null;
+        }
+        return Object.is(leftValue, rightValue)
+            ? null
+            : { path, leftValue, rightValue };
+    }
+    /**
+     * Version simplificada para formularios: recibe `getRawValue()` directamente
+     * y compara por claves sin requerir mapeo manual en el consumidor.
+     */
+    createSimpleFormTracker(initialState, options) {
+        const defaultMasterKeys = Object.keys(initialState.master);
+        const defaultDetailKeys = initialState.detail.length > 0
+            ? Object.keys(initialState.detail[0])
+            : [];
+        const masterKeys = options?.masterKeys ?? defaultMasterKeys;
+        const detailKeys = options?.detailKeys ?? defaultDetailKeys;
+        const useBaseValueForNullish = options?.useBaseValueForNullish ?? true;
+        let initialMaster = structuredClone(initialState.master);
+        let initialDetail = structuredClone(initialState.detail);
+        const buildComparisonPayload = (currentState) => {
+            const normalizedBaseMaster = normalizeBaseEntity(initialMaster, masterKeys);
+            const normalizedCurrentMaster = normalizeRawEntityAgainstBase(initialMaster, currentState.master, masterKeys, useBaseValueForNullish);
+            const normalizedBaseDetail = initialDetail.map((item) => normalizeBaseEntity(item, detailKeys));
+            const normalizedCurrentDetail = currentState.detail.map((item, index) => normalizeRawEntityAgainstBase(initialDetail[index] ?? {}, item, detailKeys, useBaseValueForNullish));
+            return {
+                normalizedBaseMaster,
+                normalizedCurrentMaster,
+                normalizedBaseDetail,
+                normalizedCurrentDetail,
+            };
+        };
+        const resolveChanges = (currentState) => {
+            const { normalizedBaseMaster, normalizedCurrentMaster, normalizedBaseDetail, normalizedCurrentDetail, } = buildComparisonPayload(currentState);
+            const masterDifference = MasterDetailChangeService.findFirstDifference(normalizedBaseMaster, normalizedCurrentMaster, 'master');
+            const detailDifference = MasterDetailChangeService.findFirstDifference(normalizedBaseDetail, normalizedCurrentDetail, 'detail');
+            return {
+                hasChanges: masterDifference !== null || detailDifference !== null,
+                masterChanged: masterDifference !== null,
+                detailChanged: detailDifference !== null,
+                firstDifference: masterDifference
+                    ? {
+                        scope: 'master',
+                        path: masterDifference.path,
+                        baseValue: masterDifference.leftValue,
+                        currentValue: masterDifference.rightValue,
+                    }
+                    : detailDifference
+                        ? {
+                            scope: 'detail',
+                            path: detailDifference.path,
+                            baseValue: detailDifference.leftValue,
+                            currentValue: detailDifference.rightValue,
+                        }
+                        : null,
+            };
+        };
+        return {
+            hasChanges: (currentState) => resolveChanges(currentState).hasChanges,
+            getChanges: (currentState) => resolveChanges(currentState),
+            reset: (state) => {
+                initialMaster = structuredClone(state.master);
+                initialDetail = structuredClone(state.detail);
+            },
+        };
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.7", ngImport: i0, type: MasterDetailChangeService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.7", ngImport: i0, type: MasterDetailChangeService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.7", ngImport: i0, type: MasterDetailChangeService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }] });
+
 class UtilityAddService {
     _serviceAlerta = inject(AlertaService);
     environment = inject(ENVIRONMENT);
@@ -4348,7 +4596,6 @@ class UtilityAddService {
     checkFormValid(control) {
         if (!control)
             return;
-        console.log(control);
         // Marca todos los controles (incluyendo anidados en FormGroup/FormArray)
         control.markAllAsTouched();
         // Muestra un mensaje de alerta
@@ -4957,5 +5204,5 @@ function CUICorrecto(cui) {
  * Generated bundle index. Do not edit.
  */
 
-export { AlertaService, AppMessageErrorComponent, ArrowNavigationDirective, AuthorizeService, BaseCRUDService, CACHE_KEYS, CacheService, CssV2Component, DocxPreviewComponent, DsxAddToolsModule, DteService, ENVIRONMENT, EndpointService, ErrorHandlerService, FileComponent, GTQFormatter, HttpHelpersService, INITIAL_PARAMETERS, IconDsxComponent, JoinByPipe, JsonHighlightPipe, JsonValuesDebujComponent, JsonViewerComponent, KpicardComponent, LoadingComponent, LoadingLottieComponent, LogoDsxComponent, NavbarDsxComponent, NetworkStatusComponent, OnlyRangoPatternDirective, ParameterValuesService, PrimeNgModule, SWEET_ALERT_THEMES, SecurityService, SelectAllOnFocusDirective, SpinnerLoadingService, TruncatePipe, UtilityAddService, atLeastOneFieldRequiredValidator, createCurrencyFormatter, createInitialCache, createTypedCacheProvider, cuiValidator, dateMinMaxValidator, dateRangeValidator, dateRangeValidatorFromTo, developmentEnvironment, getZeroBasedRolIndex, httpAuthorizeInterceptor, nitValidator, productionEnvironment, provideEnvironment, validateEnvironmentConfig };
+export { AlertaService, AppMessageErrorComponent, ArrowNavigationDirective, AuthorizeService, BaseCRUDService, CACHE_KEYS, CacheService, CssV2Component, DocxPreviewComponent, DsxAddToolsModule, DteService, ENVIRONMENT, EndpointService, ErrorHandlerService, FileComponent, GTQFormatter, HttpHelpersService, INITIAL_PARAMETERS, IconDsxComponent, JoinByPipe, JsonHighlightPipe, JsonValuesDebujComponent, JsonViewerComponent, KpicardComponent, LoadingComponent, LoadingLottieComponent, LogoDsxComponent, MasterDetailChangeService, NavbarDsxComponent, NetworkStatusComponent, OnlyRangoPatternDirective, ParameterValuesService, PrimeNgModule, SWEET_ALERT_THEMES, SecurityService, SelectAllOnFocusDirective, SpinnerLoadingService, TruncatePipe, UtilityAddService, atLeastOneFieldRequiredValidator, createCurrencyFormatter, createInitialCache, createTypedCacheProvider, cuiValidator, dateMinMaxValidator, dateRangeValidator, dateRangeValidatorFromTo, developmentEnvironment, getZeroBasedRolIndex, httpAuthorizeInterceptor, nitValidator, productionEnvironment, provideEnvironment, validateEnvironmentConfig };
 //# sourceMappingURL=ngx-dsxlibrary.mjs.map