ngx-dsxlibrary 1.0.58 → 1.0.60

package/index.d.ts

@@ -1,7 +1,7 @@
 import * as i3 from '@angular/forms';
 import { AbstractControl, FormGroup, FormBuilder, ValidatorFn, ValidationErrors } from '@angular/forms';
 import * as i0 from '@angular/core';
-import { OnInit, ElementRef, InjectionToken, PipeTransform } from '@angular/core';
+import { OnInit, ElementRef, InjectionToken, PipeTransform, Provider } from '@angular/core';
 import { SweetAlertIcon, SweetAlertResult } from 'sweetalert2';
 import { Observable } from 'rxjs';
 import { HttpInterceptorFn } from '@angular/common/http';
@@ -207,6 +207,7 @@ declare class AlertaService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AlertaService>;
 }
 
+declare const INITIAL_PARAMETERS_FOR_TYPE: readonly ["pCreate", "pRead", "pUpdate", "pDelete"];
 interface ParameterValue {
     value: number;
 }
@@ -222,15 +223,86 @@ interface SeguridadITParameter {
 }
 interface MyParameterValues {
     parameterName: string;
-    values: number[];
+    values: (string | number | boolean)[];
 }
+type ParameterName = (typeof INITIAL_PARAMETERS_FOR_TYPE)[number];
 
 declare class ParameterValuesService {
+    /** Parámetros iniciales inyectados mediante INITIAL_PARAMETERS */
     private initialParameters;
+    /** Servicio que contiene el método getParameterSecurity() */
+    private apiService;
+    /** Señal que contiene los parámetros cargados */
     private _dataParameter;
-    get dataParameter(): MyParameterValues[];
-    set dataParameter(values: MyParameterValues[]);
-    getAllParameterValues(data: SeguridadITParameter): MyParameterValues[];
+    /** Flag que indica si ya se cargaron los parámetros desde la API */
+    private _loaded;
+    /** ===================== GETTERS/SETTERS ===================== */
+    /**
+     * Devuelve los parámetros actuales como un array de solo lectura.
+     */
+    get dataParameter(): Readonly<MyParameterValues[]>;
+    /**
+     * 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
+     */
+    private setDataParameter;
+    /** ===================== 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?: boolean): Observable<MyParameterValues[]>;
+    /**
+     * Fuerza la recarga de los parámetros desde la API.
+     * @returns Observable que emite los parámetros actualizados
+     */
+    refreshParameters(): Observable<MyParameterValues[]>;
+    /** ===================== 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
+     */
+    private validateParameters;
+    /**
+     * Transforma un array de ParameterSecurity en MyParameterValues
+     * @param apiParameters Parámetros recibidos desde la API
+     * @returns Array de MyParameterValues
+     */
+    private mapToMyParameterValues;
+    /** ===================== 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<T = any>(parameterName: ParameterName, index?: number, defaultValue?: T | null): T;
+    /**
+     * 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<T = any>(parameterName: ParameterName, expectedValue: T, index?: number): boolean;
+    /**
+     * 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: ParameterName): boolean;
+    /**
+     * Devuelve todos los valores de un parámetro.
+     * @param parameterName Nombre del parámetro
+     * @returns Array de valores
+     */
+    getAllValues<T = any>(parameterName: ParameterName): T[];
     static ɵfac: i0.ɵɵFactoryDeclaration<ParameterValuesService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ParameterValuesService>;
 }
@@ -442,7 +514,7 @@ declare class AuthorizeService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AuthorizeService>;
 }
 
-declare class CacheService<T extends Record<string, string>> {
+declare class CacheService<T extends Record<string, string> = Record<string, string>> {
     /**
      * Mapa de claves simbólicas a claves reales de caché.
      * Se inyecta desde el proyecto consumidor mediante `CACHE_KEYS`.
@@ -481,6 +553,11 @@ declare class CacheService<T extends Record<string, string>> {
     static ɵprov: i0.ɵɵInjectableDeclaration<CacheService<any>>;
 }
 
+declare function createTypedCacheProvider<T extends Record<string, string>>(tokenName: string): {
+    token: InjectionToken<CacheService<T>>;
+    provider: Provider;
+};
+
 declare class EndpointService<T> {
     private http;
     private environment;
@@ -689,5 +766,5 @@ declare function nitValidator(control: AbstractControl): ValidationErrors | null
  */
 declare function cuiValidator(control: AbstractControl): ValidationErrors | null;
 
-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 type { Column, EnvironmentConfig, ExportColumn, FechasConversion, FieldConfig, FilterOption, InferCacheKeyType, InferCacheOptions, MyParameterValues, ParameterSecurity, ParameterValue, ResponseHttpModel, SeguridadITParameter, T, TipoFechaConversion, typeModel };
+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 };
+export type { Column, EnvironmentConfig, ExportColumn, FechasConversion, FieldConfig, FilterOption, InferCacheKeyType, InferCacheOptions, MyParameterValues, ParameterName, ParameterSecurity, ParameterValue, ResponseHttpModel, SeguridadITParameter, T, TipoFechaConversion, typeModel };

package/package.json

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

package/src/lib/models/index.d.ts

@@ -59,23 +59,5 @@ interface ResponseHttpModel {
     isAdmin: boolean;
 }
 
-interface ParameterValue {
-    value: number;
-}
-interface ParameterSecurity {
-    parameterName: string;
-    parameterValues: ParameterValue[];
-}
-interface SeguridadITParameter {
-    sistemaId: number;
-    sistema: string;
-    parameterBase: string | null;
-    parameterSecurity: ParameterSecurity[];
-}
-interface MyParameterValues {
-    parameterName: string;
-    values: number[];
-}
-
 export { createInitialCache };
-export type { Column, ExportColumn, FechasConversion, FieldConfig, FilterOption, InferCacheKeyType, InferCacheOptions, MyParameterValues, ParameterSecurity, ParameterValue, ResponseHttpModel, SeguridadITParameter, T, TipoFechaConversion, typeModel };
+export type { Column, ExportColumn, FechasConversion, FieldConfig, FilterOption, InferCacheKeyType, InferCacheOptions, ResponseHttpModel, T, TipoFechaConversion, typeModel };