ngx-dsxlibrary 1.0.58 → 1.0.60

package/fesm2022/ngx-dsxlibrary.mjs

@@ -14,8 +14,8 @@ import * as i1$2 from 'primeng/menubar';
 import { MenubarModule } from 'primeng/menubar';
 import { ToastrService } from 'ngx-toastr';
 import Swal from 'sweetalert2';
+import { of, retry, delay, map, throwError, catchError, switchMap, finalize, Observable } from 'rxjs';
 import { HttpClient, HttpHeaders, HttpParams, HttpStatusCode, HttpErrorResponse } from '@angular/common/http';
-import { throwError, catchError, switchMap, finalize, Observable } from 'rxjs';
 import { JwtHelperService } from '@auth0/angular-jwt';
 import { CookieService } from 'ngx-cookie-service';
 import { CommonModule } from '@angular/common';
@@ -211,11 +211,11 @@ class LoadingComponent {
     // Accedemos directamente a la señal del servicio
     _spinnerService = inject(SpinnerLoadingService);
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: LoadingComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "20.1.6", type: LoadingComponent, isStandalone: true, selector: "app-loading", ngImport: i0, template: "<!-- Actualizaci\u00F3n 2025-31-01 12:00 -->\r\n@if(_spinnerService.spinnerVisible()){\r\n<div class=\"spinner-overlay\">\r\n  <div class=\"loader\">\r\n    <div class=\"external-shadow\">\r\n      <div class=\"central\"></div>\r\n    </div>\r\n    <img src=\"assets/dsxResource/icon/secure.png\" class=\"spinner-image\" />\r\n  </div>\r\n  <p class=\"loading-text\">&copy;DevsoftXela {{ currentYear }}</p>\r\n</div>\r\n}\r\n", styles: [".spinner-overlay{position:fixed;top:0;left:0;width:100vw;height:100vh;background-color:#000c;display:flex;flex-direction:column;justify-content:center;align-items:center;z-index:9999}.loader{display:flex;justify-content:center;align-items:center;position:relative;cursor:not-allowed;scale:.7}.central{display:flex;justify-content:center;align-items:center;position:relative;width:10em;height:10em;border-radius:50%;box-shadow:.5em 1em 1em #8a2be2,-.5em .5em 1em #00f,.5em -.5em 1em purple,-.5em -.5em 1em #0ff;background-color:#0000004d}.external-shadow{width:10em;height:10em;border-radius:50%;display:flex;justify-content:center;align-items:center;position:relative;box-shadow:.5em .5em 3em #8a2be2,-.5em .5em 3em #00f,.5em -.5em 3em purple,-.5em -.5em 3em #0ff;z-index:999;animation:rotate 3s linear infinite;background-color:#21212180}@keyframes rotate{0%{transform:rotate(0)}50%{transform:rotate(180deg)}to{transform:rotate(360deg)}}.spinner-image{width:70%;height:70%;border-radius:50%;object-fit:cover;position:absolute;z-index:1000}.loading-text{font-family:Montserrat,sans-serif;text-transform:uppercase;letter-spacing:3px;background:linear-gradient(45deg,#0ff,#f0f);-webkit-background-clip:text;background-clip:text;color:transparent}@keyframes pulse{0%,to{opacity:.7}50%{opacity:1}}\n"] });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "20.1.6", type: LoadingComponent, isStandalone: true, selector: "app-loading", ngImport: i0, template: "<!-- Actualizaci\u00F3n 2025-31-01 12:00 -->\r\n@if(_spinnerService.spinnerVisible()){\r\n<div class=\"spinner-overlay\">\r\n  <div class=\"loader\">\r\n    <div class=\"external-shadow\">\r\n      <div class=\"central\"></div>\r\n    </div>\r\n    <img src=\"assets/dsxResource/icon/secure.png\" class=\"spinner-image\" />\r\n  </div>\r\n  <p class=\"loading-text\">&copy;DevsoftXela {{ currentYear }}</p>\r\n</div>\r\n}\r\n", styles: [".spinner-overlay{position:fixed;top:0;left:0;width:100vw;height:100vh;background-color:#000000e6;display:flex;flex-direction:column;justify-content:center;align-items:center;z-index:9999}.loader{display:flex;justify-content:center;align-items:center;position:relative;cursor:not-allowed;scale:.8}.central{display:flex;justify-content:center;align-items:center;position:relative;width:10em;height:10em;border-radius:50%;box-shadow:.5em 1em 1em #8a2be2,-.5em .5em 1em #00f,.5em -.5em 1em purple,-.5em -.5em 1em #0ff;background-color:#0003}.external-shadow{width:10em;height:10em;border-radius:50%;display:flex;justify-content:center;align-items:center;position:relative;box-shadow:.5em .5em 3em #8a2be2,-.5em .5em 3em #00f,.5em -.5em 3em purple,-.5em -.5em 3em #0ff;z-index:999;animation:rotate 3s linear infinite;background-color:#21212180}@keyframes rotate{0%{transform:rotate(0)}50%{transform:rotate(180deg)}to{transform:rotate(360deg)}}.spinner-image{width:70%;height:70%;border-radius:50%;object-fit:cover;position:absolute;z-index:1000}.loading-text{font-family:Montserrat,sans-serif;text-transform:uppercase;letter-spacing:3px;background:linear-gradient(45deg,#0ff,#f0f);-webkit-background-clip:text;background-clip:text;color:transparent;margin-top:1em}@keyframes pulse{0%,to{opacity:.7}50%{opacity:1}}\n"] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: LoadingComponent, decorators: [{
             type: Component,
-            args: [{ selector: 'app-loading', imports: [], template: "<!-- Actualizaci\u00F3n 2025-31-01 12:00 -->\r\n@if(_spinnerService.spinnerVisible()){\r\n<div class=\"spinner-overlay\">\r\n  <div class=\"loader\">\r\n    <div class=\"external-shadow\">\r\n      <div class=\"central\"></div>\r\n    </div>\r\n    <img src=\"assets/dsxResource/icon/secure.png\" class=\"spinner-image\" />\r\n  </div>\r\n  <p class=\"loading-text\">&copy;DevsoftXela {{ currentYear }}</p>\r\n</div>\r\n}\r\n", styles: [".spinner-overlay{position:fixed;top:0;left:0;width:100vw;height:100vh;background-color:#000c;display:flex;flex-direction:column;justify-content:center;align-items:center;z-index:9999}.loader{display:flex;justify-content:center;align-items:center;position:relative;cursor:not-allowed;scale:.7}.central{display:flex;justify-content:center;align-items:center;position:relative;width:10em;height:10em;border-radius:50%;box-shadow:.5em 1em 1em #8a2be2,-.5em .5em 1em #00f,.5em -.5em 1em purple,-.5em -.5em 1em #0ff;background-color:#0000004d}.external-shadow{width:10em;height:10em;border-radius:50%;display:flex;justify-content:center;align-items:center;position:relative;box-shadow:.5em .5em 3em #8a2be2,-.5em .5em 3em #00f,.5em -.5em 3em purple,-.5em -.5em 3em #0ff;z-index:999;animation:rotate 3s linear infinite;background-color:#21212180}@keyframes rotate{0%{transform:rotate(0)}50%{transform:rotate(180deg)}to{transform:rotate(360deg)}}.spinner-image{width:70%;height:70%;border-radius:50%;object-fit:cover;position:absolute;z-index:1000}.loading-text{font-family:Montserrat,sans-serif;text-transform:uppercase;letter-spacing:3px;background:linear-gradient(45deg,#0ff,#f0f);-webkit-background-clip:text;background-clip:text;color:transparent}@keyframes pulse{0%,to{opacity:.7}50%{opacity:1}}\n"] }]
+            args: [{ selector: 'app-loading', imports: [], template: "<!-- Actualizaci\u00F3n 2025-31-01 12:00 -->\r\n@if(_spinnerService.spinnerVisible()){\r\n<div class=\"spinner-overlay\">\r\n  <div class=\"loader\">\r\n    <div class=\"external-shadow\">\r\n      <div class=\"central\"></div>\r\n    </div>\r\n    <img src=\"assets/dsxResource/icon/secure.png\" class=\"spinner-image\" />\r\n  </div>\r\n  <p class=\"loading-text\">&copy;DevsoftXela {{ currentYear }}</p>\r\n</div>\r\n}\r\n", styles: [".spinner-overlay{position:fixed;top:0;left:0;width:100vw;height:100vh;background-color:#000000e6;display:flex;flex-direction:column;justify-content:center;align-items:center;z-index:9999}.loader{display:flex;justify-content:center;align-items:center;position:relative;cursor:not-allowed;scale:.8}.central{display:flex;justify-content:center;align-items:center;position:relative;width:10em;height:10em;border-radius:50%;box-shadow:.5em 1em 1em #8a2be2,-.5em .5em 1em #00f,.5em -.5em 1em purple,-.5em -.5em 1em #0ff;background-color:#0003}.external-shadow{width:10em;height:10em;border-radius:50%;display:flex;justify-content:center;align-items:center;position:relative;box-shadow:.5em .5em 3em #8a2be2,-.5em .5em 3em #00f,.5em -.5em 3em purple,-.5em -.5em 3em #0ff;z-index:999;animation:rotate 3s linear infinite;background-color:#21212180}@keyframes rotate{0%{transform:rotate(0)}50%{transform:rotate(180deg)}to{transform:rotate(360deg)}}.spinner-image{width:70%;height:70%;border-radius:50%;object-fit:cover;position:absolute;z-index:1000}.loading-text{font-family:Montserrat,sans-serif;text-transform:uppercase;letter-spacing:3px;background:linear-gradient(45deg,#0ff,#f0f);-webkit-background-clip:text;background-clip:text;color:transparent;margin-top:1em}@keyframes pulse{0%,to{opacity:.7}50%{opacity:1}}\n"] }]
         }], ctorParameters: () => [] });
 
 class AlertaService {
@@ -267,6 +267,7 @@ class AlertaService {
         return this.preloadImage(icono).then(() => Swal.fire({
             title: title,
             html: text,
+            //theme: 'borderless',
             footer: '<strong>DevSoftXela</strong> 2025',
             imageUrl: `assets/dsxResource/${icono}`,
             imageWidth: 150,
@@ -415,72 +416,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImpor
 
 const INITIAL_PARAMETERS = new InjectionToken('InitialParameters');
 
-class ParameterValuesService {
-    // Inyecta INITIAL_PARAMETERS usando inject()
-    initialParameters = inject(INITIAL_PARAMETERS);
-    // Inicializa con valores predeterminados usando una Signal
-    _dataParameter = signal(this.initialParameters, ...(ngDevMode ? [{ debugName: "_dataParameter" }] : []));
-    // Getter para acceder a los valores actuales
-    get dataParameter() {
-        return this._dataParameter();
-    }
-    // Setter para actualizar los valores
-    set dataParameter(values) {
-        this._dataParameter.set(values);
-    }
-    getAllParameterValues(data) {
-        // Verifica si los datos de la API son válidos
-        if (!data || !data.parameterSecurity) {
-            console.error('Los datos proporcionados desde la API no son válidos.');
-            return [];
-        }
-        // Obtén los parámetros iniciales y de la API
-        const initialParameters = this._dataParameter();
-        const apiParameters = data.parameterSecurity;
-        // Compara las cantidades
-        if (initialParameters.length !== apiParameters.length) {
-            console.warn(`Advertencia: La cantidad de parámetros inicializados (${initialParameters.length}) no coincide con la cantidad de parámetros cargados desde la API (${apiParameters.length}).`);
-        }
-        // Validación de nombres de parámetros
-        const initialParameterNames = initialParameters.map((p) => p.parameterName);
-        const apiParameterNames = apiParameters.map((p) => p.parameterName);
-        // Encuentra parámetros faltantes o adicionales
-        const missingParameters = initialParameterNames.filter((name) => !apiParameterNames.includes(name));
-        const extraParameters = apiParameterNames.filter((name) => !initialParameterNames.includes(name));
-        // Reporta discrepancias
-        if (missingParameters.length > 0) {
-            console.error(`Error: Los siguientes parámetros no se encontraron en la API: ${missingParameters.join(', ')}`);
-        }
-        if (extraParameters.length > 0) {
-            console.warn(`Advertencia: La API devolvió parámetros no esperados: ${extraParameters.join(', ')}`);
-        }
-        // Transforma los datos de la API al formato MyParameterValues
-        return apiParameters
-            .filter((param) => initialParameterNames.includes(param.parameterName))
-            .map((param) => ({
-            parameterName: param.parameterName,
-            values: param.parameterValues
-                ? param.parameterValues.map((v) => v.value)
-                : [],
-        }));
-    }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: ParameterValuesService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: ParameterValuesService, providedIn: 'root' });
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: ParameterValuesService, decorators: [{
-            type: Injectable,
-            args: [{
-                    providedIn: 'root',
-                }]
-        }] });
-
 class SecurityService {
     // Inyecta el servicio HttpClient para realizar peticiones HTTP
     http = inject(HttpClient);
     // Inyecta la configuración del entorno usando el token ENVIRONMENT
     environment = inject(ENVIRONMENT);
     // Construye la URL base de la API utilizando la URL de la aplicación desde la configuración del entorno
-    urlApi = `${this.environment.myAppUrl}api/authorize`;
+    urlApi = `${this.environment.myAppUrl}api/auth`;
     /**
      * Método para obtener un nuevo token de acceso utilizando un refresh token.
      * @param refreshToken El refresh token que se utilizará para obtener un nuevo token de acceso.
@@ -490,7 +432,7 @@ class SecurityService {
         // Crea el cuerpo de la solicitud con el refresh token
         const body = { refreshToken };
         // Realiza una solicitud POST al endpoint de refresco de token
-        return this.http.post(`${this.urlApi}/TokenRefresh/`, body, {
+        return this.http.post(`${this.urlApi}/token-refresh/`, body, {
             headers: new HttpHeaders({
                 'Content-Type': 'application/json', // Establece el tipo de contenido como JSON
             }),
@@ -506,7 +448,7 @@ class SecurityService {
         // parametro diseñado para invalidar la caché a traves del filtro
         const params = new HttpParams().set('invalidCacheParam', invalidCacheParam.toString());
         // Realiza una solicitud GET al endpoint de parámetros de seguridad
-        return this.http.get(`${this.urlApi}/securityParameter/`, { params });
+        return this.http.get(`${this.urlApi}/security-parameter/`, { params });
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: SecurityService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
     static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: SecurityService, providedIn: 'root' });
@@ -518,6 +460,159 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImpor
                 }]
         }] });
 
+/**
+ * Servicio para gestionar los parámetros de seguridad de la aplicación.
+ * Permite cargar los parámetros desde la API, mantenerlos en memoria, y acceder
+ * a sus valores de forma segura evitando `undefined` en los componentes.
+ */
+class ParameterValuesService {
+    /** Parámetros iniciales inyectados mediante INITIAL_PARAMETERS */
+    initialParameters = inject(INITIAL_PARAMETERS);
+    /** Servicio que contiene el método getParameterSecurity() */
+    apiService = inject(SecurityService);
+    /** Señal que contiene los parámetros cargados */
+    _dataParameter = signal(this.initialParameters, ...(ngDevMode ? [{ debugName: "_dataParameter" }] : []));
+    /** Flag que indica si ya se cargaron los parámetros desde la API */
+    _loaded = false;
+    /** ===================== GETTERS/SETTERS ===================== */
+    /**
+     * Devuelve los parámetros actuales como un array de solo lectura.
+     */
+    get dataParameter() {
+        return this._dataParameter();
+    }
+    /**
+     * Setter privado para actualizar los parámetros.
+     * Solo puede ser usado dentro del servicio para mantener la integridad de los datos.
+     * @param values Array de parámetros a almacenar
+     */
+    setDataParameter(values) {
+        if (!Array.isArray(values)) {
+            console.error('Error: valores inválidos para dataParameter');
+            return;
+        }
+        this._dataParameter.set(values);
+    }
+    /** ===================== MÉTODOS PRINCIPALES ===================== */
+    /**
+     * Carga los parámetros desde la API.
+     * Si ya se cargaron y force=false, devuelve la copia en memoria.
+     * @param force Indica si se debe forzar la recarga desde la API (default: false)
+     * @returns Observable que emite los parámetros cargados como MyParameterValues[]
+     */
+    loadParameters(force = false) {
+        if (this._loaded && !force) {
+            return of([...this.dataParameter]); // copia mutable
+        }
+        return this.apiService.getParameterSecurity(force).pipe(retry({
+            count: 3,
+            delay: (error, retryCount) => {
+                console.warn(`Reintentando carga de parámetros (${retryCount})...`, error);
+                // espera progresiva
+                return of(null).pipe(delay(1000 * retryCount));
+            },
+        }), map((response) => {
+            const apiParameters = response.parameterSecurity ?? [];
+            this.validateParameters(apiParameters);
+            const values = this.mapToMyParameterValues(apiParameters);
+            this.setDataParameter(values);
+            this._loaded = true;
+            return values;
+        }));
+    }
+    /**
+     * Fuerza la recarga de los parámetros desde la API.
+     * @returns Observable que emite los parámetros actualizados
+     */
+    refreshParameters() {
+        return this.loadParameters(true);
+    }
+    /** ===================== MÉTODOS PRIVADOS ===================== */
+    /**
+     * Valida que los parámetros devueltos por la API coincidan con los iniciales.
+     * Muestra errores o advertencias en consola si existen diferencias.
+     * @param apiParameters Parámetros recibidos desde la API
+     */
+    validateParameters(apiParameters) {
+        const initialNames = this.initialParameters.map((p) => p.parameterName);
+        const apiNames = apiParameters.map((p) => p.parameterName);
+        const missing = initialNames.filter((name) => !apiNames.includes(name));
+        const extra = apiNames.filter((name) => !initialNames.includes(name));
+        if (missing.length)
+            console.error(`Faltan en API: ${missing.join(', ')}`);
+        if (extra.length)
+            console.warn(`Extra en API: ${extra.join(', ')}`);
+        if (initialNames.length !== apiNames.length) {
+            console.warn(`Cantidad distinta: iniciales=${initialNames.length}, api=${apiNames.length}`);
+        }
+    }
+    /**
+     * Transforma un array de ParameterSecurity en MyParameterValues
+     * @param apiParameters Parámetros recibidos desde la API
+     * @returns Array de MyParameterValues
+     */
+    mapToMyParameterValues(apiParameters) {
+        const initialNames = this.initialParameters.map((p) => p.parameterName);
+        return apiParameters
+            .filter((param) => initialNames.includes(param.parameterName))
+            .map((param) => ({
+            parameterName: param.parameterName,
+            values: param.parameterValues?.map((v) => v.value) ?? [],
+        }));
+    }
+    /** ===================== HELPERS SEGUROS ===================== */
+    /**
+     * Obtiene un valor específico de un parámetro.
+     * Devuelve `defaultValue` si no existe o el índice es inválido.
+     * @param parameterName Nombre del parámetro
+     * @param index Índice del valor dentro del array (default: 0)
+     * @param defaultValue Valor por defecto si no existe
+     * @returns Valor del parámetro o defaultValue
+     */
+    getValue(parameterName, index = 0, defaultValue = null) {
+        const param = this.dataParameter.find((p) => p.parameterName === parameterName);
+        if (!param || index < 0 || index >= param.values.length) {
+            return defaultValue;
+        }
+        return param.values[index];
+    }
+    /**
+     * Compara un valor específico con un valor esperado.
+     * @param parameterName Nombre del parámetro
+     * @param expectedValue Valor esperado
+     * @param index Índice del valor dentro del array (default: 0)
+     * @returns true si coincide, false en caso contrario
+     */
+    isParameterValue(parameterName, expectedValue, index = 0) {
+        return this.getValue(parameterName, index) === expectedValue;
+    }
+    /**
+     * Verifica si un parámetro tiene al menos un valor.
+     * @param parameterName Nombre del parámetro
+     * @returns true si tiene al menos un valor, false si no tiene
+     */
+    hasAnyValue(parameterName) {
+        return this.getAllValues(parameterName).length > 0;
+    }
+    /**
+     * Devuelve todos los valores de un parámetro.
+     * @param parameterName Nombre del parámetro
+     * @returns Array de valores
+     */
+    getAllValues(parameterName) {
+        return (this.dataParameter.find((p) => p.parameterName === parameterName)
+            ?.values ?? []);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: ParameterValuesService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: ParameterValuesService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: ParameterValuesService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }] });
+
 class NavbarDsxComponent {
     _securityService = inject(SecurityService);
     _parameterSecurityService = inject(ParameterValuesService);
@@ -555,13 +650,15 @@ class NavbarDsxComponent {
         localStorage.setItem('theme', theme);
     }
     actualizarSeguridadIT() {
-        this._securityService.getParameterSecurity(true).subscribe({
-            next: (response) => {
-                const values = this._parameterSecurityService.getAllParameterValues(response);
-                this._parameterSecurityService.dataParameter = values;
+        this._parameterSecurityService.refreshParameters().subscribe({
+            next: (values) => {
                 this._alertaService.toastrAlerts(2, 'SeguridadIT', 'Parametro actualizado!', 2);
+                console.log('Parámetros cargados:', values);
+            },
+            error: (err) => {
+                console.error('Error al actualizar parámetros de SeguridadIT', err);
+                this._alertaService.toastrAlerts(3, 'SeguridadIT', 'Error al actualizar parámetros!', 2);
             },
-            error: (err) => console.log(err),
             complete: () => '',
         });
     }
@@ -853,7 +950,7 @@ const httpAuthorizeInterceptor = (req, next) => {
     _activeRequest++;
     // Función para controlar el spinner.hide()
     const hideSpinner = () => {
-        // Solo oculta si NO está en modo depuración
+        // Se debe comentarizar para evitar que se oculte el spinner inmediatamente
         _spinnerService.hide();
     };
     return next(authReq).pipe(catchError((error) => {
@@ -943,6 +1040,13 @@ function createInitialCache(cacheKeys) {
     return Object.fromEntries(Object.values(cacheKeys).map((key) => [key, false]));
 }
 
+const INITIAL_PARAMETERS_FOR_TYPE = [
+    'pCreate',
+    'pRead',
+    'pUpdate',
+    'pDelete',
+];
+
 class DsxAddToolsModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.1.6", ngImport: i0, type: DsxAddToolsModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
     static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "20.1.6", ngImport: i0, type: DsxAddToolsModule, imports: [JsonValuesDebujComponent], exports: [CommonModule,
@@ -1119,23 +1223,46 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImpor
  * Este servicio utiliza señales (`signal`) para almacenar el estado de invalidación de caché
  * y permite marcar ciertas entradas como inválidas mediante una llamada a `invalidate`.
  *
- * ### Ejemplo de definición del mapa de claves:
+ * ---
+ * ## Uso básico
+ * Si no se especifica el tipo genérico `T`, el servicio funcionará con un mapa genérico
+ * `Record<string, string>` sin autocompletado.
+ *
+ * ```ts
+ * const cacheService = inject(CacheService);
+ * cacheService.invalidate(['cualquierClave']);
+ * ```
+ *
+ * ---
+ * ## Uso tipado (recomendado)
+ * 1. Definir las claves de caché en el proyecto consumidor:
  * ```ts
- * export const CACHE_KEYS = {
+ * export const INITIAL_CACHE_KEYS = {
  *   cliente: 'invalidateCacheCliente',
  *   empresa: 'invalidateCacheEmpresa'
  * } as const;
+ *
+ * export type ValueCacheKeys = typeof INITIAL_CACHE_KEYS;
  * ```
  *
- * ### Ejemplo de uso:
+ * 2. Proveer estas claves en `AppModule` o un módulo raíz:
  * ```ts
- * const cacheService = inject(CacheService<typeof CACHE_KEYS>);
+ * providers: [
+ *   { provide: CACHE_KEYS, useValue: INITIAL_CACHE_KEYS }
+ * ]
+ * ```
+ *
+ * 3. Inyectar el servicio especificando el tipo:
+ * ```ts
+ * const cacheService = inject<CacheService<ValueCacheKeys>>(CacheService);
  *
- * cacheService.options.invalidateCacheCliente; // acceso tipado
- * cacheService.invalidate(['cliente']); // marca la propiedad como true
+ * cacheService.options.invalidateCacheCliente; // ✅ boolean con autocompletado
+ * cacheService.invalidate(['cliente']); // marca como invalidado
  * ```
  *
- * @typeParam T - Objeto con claves simbólicas como `cliente`, `empresa`, y valores string literales usados como claves reales de caché.
+ * @typeParam T - Objeto con claves simbólicas (`keyof T`) como `cliente`, `empresa`,
+ * y valores string literales usados como claves reales de caché.
+ * Por defecto: `Record<string, string>`.
  */
 class CacheService {
     /**
@@ -1194,6 +1321,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.1.6", ngImpor
                 }]
         }] });
 
+function createTypedCacheProvider(tokenName) {
+    const token = new InjectionToken(tokenName);
+    const provider = {
+        provide: token,
+        useFactory: () => new CacheService(),
+        deps: [],
+    };
+    return { token, provider };
+}
+
 class EndpointService {
     http = inject(HttpClient);
     environment = inject(ENVIRONMENT);
@@ -1790,5 +1927,5 @@ function CUICorrecto(cui) {
  * Generated bundle index. Do not edit.
  */
 
-export { AlertaService, AppMessageErrorComponent, AuthorizeService, CACHE_KEYS, CacheService, DsxAddToolsModule, ENVIRONMENT, EndpointService, INITIAL_PARAMETERS, JsonHighlightPipe, JsonValuesDebujComponent, KpicardComponent, LoadingComponent, NavbarDsxComponent, OnlyRangoPatternDirective, ParameterValuesService, PrimeNgModule, SecurityService, SelectAllOnFocusDirective, TruncatePipe, UtilityAddService, atLeastOneFieldRequiredValidator, createInitialCache, cuiValidator, dateMinMaxValidator, dateRangeValidator, httpAuthorizeInterceptor, nitValidator };
+export { AlertaService, AppMessageErrorComponent, AuthorizeService, CACHE_KEYS, CacheService, DsxAddToolsModule, ENVIRONMENT, EndpointService, INITIAL_PARAMETERS, JsonHighlightPipe, JsonValuesDebujComponent, KpicardComponent, LoadingComponent, NavbarDsxComponent, OnlyRangoPatternDirective, ParameterValuesService, PrimeNgModule, SecurityService, SelectAllOnFocusDirective, TruncatePipe, UtilityAddService, atLeastOneFieldRequiredValidator, createInitialCache, createTypedCacheProvider, cuiValidator, dateMinMaxValidator, dateRangeValidator, httpAuthorizeInterceptor, nitValidator };
 //# sourceMappingURL=ngx-dsxlibrary.mjs.map