@jvsoft/utils 0.0.13-alpha.6 → 1.0.0-alpha.5

package/functions/base64.d.ts

@@ -1,26 +1,89 @@
+/**
+ * Codifica un string a base64 (método legacy)
+ * @param val - String a codificar
+ * @returns String codificado en base64
+ * @deprecated Use encodeBase64String() en su lugar
+ */
 export declare function b64Encode(val: string): string;
+/**
+ * Decodifica un string desde base64 (método legacy)
+ * @param val - String en base64 a decodificar
+ * @returns String decodificado
+ * @deprecated Use decodeBase64String() en su lugar
+ */
 export declare function b64Decode(val: string): string;
 /**
  * Codificar string a Base64 (UTF-8 seguro)
+ * @param str - String a codificar
+ * @returns String codificado en base64
+ *
+ * @example
+ * ```typescript
+ * const encoded = encodeBase64String('Hola Mundo ñ');
+ * // encoded: "SG9sYSBNdW5kbyDDsQ=="
+ * ```
  */
 export declare function encodeBase64String(str: string): string;
 /**
  * Decodificar Base64 a string (UTF-8 seguro)
+ * @param b64 - String en base64 a decodificar
+ * @returns String decodificado
+ *
+ * @example
+ * ```typescript
+ * const decoded = decodeBase64String('SG9sYSBNdW5kbyDDsQ==');
+ * // decoded: "Hola Mundo ñ"
+ * ```
  */
 export declare function decodeBase64String(b64: string): string;
 /**
  * Codificar un objeto a base64 (UTF-8 seguro)
+ * @param obj - Objeto a codificar
+ * @returns String codificado en base64
+ *
+ * @example
+ * ```typescript
+ * const obj = { nombre: 'Juan', edad: 25 };
+ * const encoded = encodeBase64Object(obj);
+ * ```
  */
 export declare function encodeBase64Object(obj: any): string;
 /**
  * Decodificar un base64 y obtener el objeto original
+ * @param b64 - String en base64 a decodificar
+ * @returns Objeto decodificado
+ *
+ * @example
+ * ```typescript
+ * const obj = decodeBase64Object<{ nombre: string, edad: number }>(encoded);
+ * // obj: { nombre: 'Juan', edad: 25 }
+ * ```
  */
 export declare function decodeBase64Object<T = any>(b64: string): T;
 /**
  * Codificar archivo a Base64 (retorna solo el contenido, sin "data:...")
+ * @param file - Archivo o Blob a codificar
+ * @returns Promise con el string en base64
+ *
+ * @example
+ * ```typescript
+ * const file = event.target.files[0];
+ * const base64 = await encodeBase64File(file);
+ * // base64: "iVBORw0KGgoAAAANSUhEUgAA..."
+ * ```
  */
 export declare function encodeBase64File(file: File | Blob): Promise<string>;
 /**
  * Decodificar Base64 a Blob (para reconstruir archivos en Angular)
+ * @param b64 - String en base64
+ * @param mimeType - Tipo MIME del archivo (opcional)
+ * @returns Blob con el contenido decodificado
+ *
+ * @example
+ * ```typescript
+ * const blob = decodeBase64ToBlob(base64String, 'image/png');
+ * const url = URL.createObjectURL(blob);
+ * // Usar url para mostrar imagen o descargar
+ * ```
  */
 export declare function decodeBase64ToBlob(b64: string, mimeType?: string): Blob;

package/functions/dev-log.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Configura el modo de producción para las utilidades de logging
+ * @param production - true si está en modo producción, false para desarrollo
+ *
+ * @example
+ * ```typescript
+ * import { setProductionMode } from '@jvsoft/utils';
+ * import { environment } from './environments/environment';
+ *
+ * setProductionMode(environment.production);
+ * ```
+ */
+export declare function setProductionMode(production: boolean): void;
+/**
+ * Obtiene el estado actual del modo de producción
+ * @returns true si está en modo producción, false en desarrollo
+ */
+export declare function isProduction(): boolean;
+/**
+ * Muestra mensajes de log solo en modo desarrollo
+ * @param args - Argumentos a mostrar en consola
+ *
+ * @example
+ * ```typescript
+ * devLog('Usuario cargado:', usuario);
+ * devLog('Estado:', { activo: true, rol: 'admin' });
+ * ```
+ */
+export declare function devLog(...args: any[]): void;
+/**
+ * Muestra advertencias solo en modo desarrollo
+ * @param args - Argumentos a mostrar como advertencia
+ *
+ * @example
+ * ```typescript
+ * devWarn('Función deprecada, usar nuevaFuncion() en su lugar');
+ * ```
+ */
+export declare function devWarn(...args: any[]): void;
+/**
+ * Muestra errores en consola (siempre, incluso en producción)
+ * @param args - Argumentos a mostrar como error
+ *
+ * @example
+ * ```typescript
+ * devError('Error al cargar datos:', error);
+ * ```
+ */
+export declare function devError(...args: any[]): void;
+/**
+ * Crea un grupo de logs solo en modo desarrollo
+ * @param label - Etiqueta del grupo
+ * @param collapsed - Si el grupo debe estar colapsado por defecto
+ *
+ * @example
+ * ```typescript
+ * devGroup('Datos del usuario');
+ * devLog('Nombre:', usuario.nombre);
+ * devLog('Email:', usuario.email);
+ * devGroupEnd();
+ * ```
+ */
+export declare function devGroup(label: string, collapsed?: boolean): void;
+/**
+ * Cierra el grupo de logs actual
+ */
+export declare function devGroupEnd(): void;
+/**
+ * Muestra una tabla en consola solo en modo desarrollo
+ * @param data - Datos a mostrar en formato tabla
+ *
+ * @example
+ * ```typescript
+ * devTable([
+ *   { nombre: 'Juan', edad: 25 },
+ *   { nombre: 'María', edad: 30 }
+ * ]);
+ * ```
+ */
+export declare function devTable(data: any): void;
+/**
+ * Inicia un temporizador solo en modo desarrollo
+ * @param label - Etiqueta del temporizador
+ *
+ * @example
+ * ```typescript
+ * devTime('carga-datos');
+ * // ... código a medir
+ * devTimeEnd('carga-datos'); // Muestra: carga-datos: 123.45ms
+ * ```
+ */
+export declare function devTime(label: string): void;
+/**
+ * Finaliza un temporizador y muestra el tiempo transcurrido
+ * @param label - Etiqueta del temporizador
+ */
+export declare function devTimeEnd(label: string): void;

package/functions/mat-form-controls/autocomplete.d.ts

@@ -1,26 +1,40 @@
 import { AbstractControl } from '@angular/forms';
-/**
- * Devuelve un valor de visualización para un elemento buscado.
- * Compatible con listas simples, objetos y campos múltiples.
- */
-export declare function mostrarValorEnBusqueda(campos: any, idxSel: any): any;
-/**
- * Vincula un FormControl a datos locales para autocompletado.
- */
-export declare function changeSelectData(objThis: any, { formControl, data, campoBuscar, variableResultado }: {
+export declare function mostrarValorEnBusqueda(campos: any, idxSel: any): string;
+export declare function changeSelectData(objThis: any, dataFiltro: {
     formControl: AbstractControl;
     data: any[];
     campoBuscar: string | string[];
     variableResultado: string;
 }): void;
+export declare function changeSelect(control: any, formControl: AbstractControl, tipo: any, campoBuscar: any, campoFiltro?: null): void;
+export declare function changeSelectDataApi(objThis: any, dataFiltro: {
+    tipoReq: string;
+    campoId?: string;
+    minLength?: number;
+    dataExtra?: any;
+    dataExtraVariable?: any;
+    anonimo?: boolean;
+    queryService: any;
+    formControl: AbstractControl;
+    variableResultado?: string;
+}): void;
+export declare function changeSelectApi(control: any, queryService: any, formControl: AbstractControl, tipo: any, dataExtra?: {}, dataExtraVariable?: any[] | null, minLength?: number, anonimo?: boolean): void;
 /**
- * Vincula un FormControl a datos locales obtenidos de dataServidor o dataServidorSuscripcion.
+ * Comprueba si un valor es una Promesa
+ * @param valor - Valor a verificar
+ * @returns true si es una Promise
  */
-export declare function changeSelect(control: any, formControl: AbstractControl, tipo: string, campoBuscar: string | string[], campoFiltro?: string | null): void;
+export declare function esPromise(valor: any): boolean;
 /**
- * Configuración para changeSelectReformateado.
+ * Selecciona todo el texto de un input
+ * @param event - Evento del input
  */
-interface ChangeSelectConfig {
+export declare function seleccionarTextoInput(event: any): void;
+/**
+ * Función genérica para vincular un FormControl con datos desde API o Promise.
+ * Preparada para migrar a signals en el futuro.
+ */
+export declare function changeSelectReformateado(config: {
     objThis: any;
     tipoReq: string;
     formControl: AbstractControl;
@@ -28,24 +42,7 @@ interface ChangeSelectConfig {
     campoId?: string;
     minLength?: number;
     dataExtra?: any;
-    dataExtraVariable?: {
-        campo: string;
-        ctrlValue: AbstractControl;
-    }[];
+    dataExtraVariable?: any[];
     anonimo?: boolean;
     variableResultado?: string;
-}
-/**
- * Función genérica para vincular un FormControl con datos desde API o Promise.
- * Preparada para migrar a signals en el futuro.
- */
-export declare function changeSelectReformateado(config: ChangeSelectConfig): void;
-/**
- * Alias para compatibilidad.
- */
-export declare function changeSelectDataApi(objThis: any, dataFiltro: any): void;
-/**
- * Alias para compatibilidad.
- */
-export declare function changeSelectApi(control: any, queryService: any, formControl: AbstractControl, tipo: any, dataExtra?: {}, dataExtraVariable?: any[] | null, minLength?: number, anonimo?: boolean): void;
-export {};
+}): void;

package/functions/objects-arrays.d.ts

@@ -1,23 +1,8 @@
-/**
- * Realiza una fusión profunda entre dos objetos, sin modificar el original.
- * Si el valor en target no es un objeto, lo reemplaza directamente.
- *
- * @param source - Objeto fuente que se clonará y fusionará.
- * @param target - Objeto destino cuyos valores se fusionarán.
- * @returns Un nuevo objeto con la fusión profunda.
- */
 export declare function deepMerge(source: any, target: any): any;
-/**
- * Realiza una clonación profunda de un objeto, manejando funciones, fechas y arrays.
- *
- * @param obj - Objeto a clonar.
- * @returns Una copia profunda del objeto.
- */
 export declare function deepClone(obj: any): any;
 /**
  * Busca un elemento en un array o jerarquía de objetos según un campo y valor especificado.
  *
- * @param datosFn - Objeto con los parámetros de búsqueda: items, campo, valor y opcionalmente campoHijo.
  * @returns El elemento encontrado o undefined si no existe.
  */
 export declare function buscarPorCampo<T>(datosFn: {
@@ -26,91 +11,29 @@ export declare function buscarPorCampo<T>(datosFn: {
     valor: any;
     campoHijo?: string;
 }): T | undefined;
-/**
- * Suma los valores de las propiedades especificadas de un objeto.
- *
- * @param item - Objeto con las propiedades a sumar.
- * @param campos - Array de nombres de las propiedades a sumar.
- * @returns La suma de los valores de las propiedades.
- */
 export declare function sumarPropiedades(item: Record<string, any>, campos: string[]): number;
-/**
- * Verifica si el valor proporcionado es un número válido.
- *
- * @param value - Valor a verificar.
- * @returns true si es un número, false en caso contrario.
- */
 export declare function esNumero(value: any): boolean;
-/**
- * Suma los valores de las propiedades especificadas en un array de objetos.
- *
- * @param arrayObjetos - Array de objetos a procesar.
- * @param campos - Array de nombres de las propiedades a sumar.
- * @returns Objeto con la suma de cada propiedad.
- */
 export declare function sumarObjetos(arrayObjetos: any[], campos: string[]): Record<string, number>;
-/**
- * Obtiene los valores únicos de un array.
- *
- * @param array - Array de valores.
- * @returns Array con los valores únicos.
- */
 export declare function getUniqueValues(array: any[]): any[];
-/**
- * Obtiene los objetos únicos de un array según una propiedad específica.
- *
- * @param objetos - Array de objetos.
- * @param campo - Nombre de la propiedad para determinar unicidad.
- * @returns Array de objetos únicos por la propiedad.
- */
 export declare function getUniqueValuesByProperty<T>(objetos: T[], campo: string): T[];
-/**
- * Ordena un array de valores numéricos o alfabéticos.
- *
- * @param array - Array a ordenar.
- * @param numeros - Si es true, ordena como números.
- * @param sentido - 'ASC' para ascendente, 'DESC' para descendente.
- * @returns Array ordenado.
- */
 export declare function ordenarArray(array: any[], numeros?: boolean, sentido?: 'ASC' | 'DESC'): any[];
-/**
- * Ordena un array de objetos por una propiedad específica.
- *
- * @param objData - Array de objetos a ordenar.
- * @param propiedad - Propiedad por la que se ordena.
- * @param numeros - (Obsoleto) Si es true, ordena como números.
- * @returns Array ordenado.
- */
 export declare function ordenarPorPropiedad(objData: any, propiedad: string, /**@deprecated*/ numeros?: boolean): {
     [x: string]: {};
 }[];
-/**
- * Ordena un array de objetos por varias propiedades y direcciones.
- *
- * @param arr - Array de objetos a ordenar.
- * @param options - Opciones con propiedades y direcciones de orden.
- * @returns Array ordenado.
- */
 export declare function ordenarPorPropiedades<T>(arr: T[], options: {
     propiedades: (keyof T)[];
     direcciones?: ('asc' | 'desc' | '')[];
 }): T[];
-/**
- * Agrupa los elementos de un array según una clave o función de clave.
- *
- * @param array - Array de objetos a agrupar.
- * @param key - Propiedad o función para agrupar.
- * @returns Objeto con los grupos por clave.
- */
 export declare function groupBy<T extends Record<string, any>, K extends keyof T>(array: T[], key: K | ((obj: T) => string)): Record<string, T[]>;
+export declare function nestGroupsBy(arr: any, properties: any): any;
 /**
- * Agrupa y anida los elementos de un array según una lista de propiedades.
+ * Obtiene un valor de un objeto usando una ruta de propiedad anidada.
  *
- * @param arr - Array de objetos a agrupar.
- * @param properties - Propiedades para agrupar de forma anidada.
- * @returns Objeto anidado por los grupos de propiedades.
+ * @param obj - Objeto de entrada.
+ * @param path - Ruta en formato punto (ej: "cliente.orden").
+ * @returns El valor encontrado o undefined si no existe.
  */
-export declare function nestGroupsBy(arr: any, properties: any): any;
+export declare function getValueByPath(obj: any, path: string): any;
 /**
  * Retorna el valor máximo del campo especificado (incluso anidado) en un arreglo de objetos.
  *
@@ -128,20 +51,13 @@ export declare function obtenerUltimoOrden(data: any[], campo: string, increment
  * @returns Nuevo array con las columnas eliminadas.
  */
 export declare function eliminarColumnaPorIndex<T extends unknown[][]>(data: T, columnIndex: number | number[]): T;
-/**
- * Elimina elementos duplicados de un array de objetos según claves específicas.
- *
- * @param array - Array de objetos.
- * @param claves - Claves para determinar unicidad. Si no se especifica, compara todo el objeto.
- * @returns Array sin duplicados.
- */
 export declare function eliminarDuplicados<T extends object>(array: T[], claves?: (keyof T)[]): T[];
+export declare function eliminarElementos<T extends object>(origen: T[], elementosAEliminar: T[], claves?: (keyof T)[]): T[];
 /**
- * Elimina elementos de un array origen que estén presentes en otro array, según claves específicas.
- *
- * @param origen - Array original.
- * @param elementosAEliminar - Elementos a eliminar del array origen.
- * @param claves - Claves para comparar los objetos. Si no se especifica, compara todo el objeto.
- * @returns Array filtrado sin los elementos eliminados.
+ * Filtra datos localmente según un valor de búsqueda
+ * @param data - Array de datos a filtrar
+ * @param value - Valor de búsqueda
+ * @param campoBuscar - Campo(s) por el cual buscar
+ * @returns Array filtrado
  */
-export declare function eliminarElementos<T extends object>(origen: T[], elementosAEliminar: T[], claves?: (keyof T)[]): T[];
+export declare function filtrarDatosLocal(data: any[], value: any, campoBuscar: string | string[]): any[];

package/functions/public-api.d.ts

@@ -3,6 +3,7 @@ export * from './base64';
 export * from './browser';
 export * from './crypto-js';
 export * from './date';
+export * from './dev-log';
 export * from './email';
 export * from './file';
 export * from './forms';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jvsoft/utils",
-  "version": "0.0.13-alpha.6",
+  "version": "1.0.0-alpha.5",
   "description": "JVSOFT Angular Utils",
   "publishConfig": {
     "tag": "alpha",
@@ -11,7 +11,14 @@
     "@angular/core": ">=16.0.0",
     "@angular/forms": ">=16.0.0",
     "@angular/material": ">=16.0.0",
-    "@rxweb/reactive-form-validators": ">=13.0.0"
+    "@rxweb/reactive-form-validators": ">=13.0.0",
+    "crypto-js": "^4.2.0",
+    "file-saver": "^2.0.5",
+    "jwt-decode": "^4.0.0",
+    "moment": "^2.30.1",
+    "ngx-toastr": "^19.0.0",
+    "sweetalert2": "^11.17.2",
+    "xlsx": "^0.18.5"
   },
   "sideEffects": false,
   "module": "fesm2022/jvsoft-utils.mjs",

package/src/functions/base64.d.ts

@@ -1,26 +1,89 @@
+/**
+ * Codifica un string a base64 (método legacy)
+ * @param val - String a codificar
+ * @returns String codificado en base64
+ * @deprecated Use encodeBase64String() en su lugar
+ */
 export declare function b64Encode(val: string): string;
+/**
+ * Decodifica un string desde base64 (método legacy)
+ * @param val - String en base64 a decodificar
+ * @returns String decodificado
+ * @deprecated Use decodeBase64String() en su lugar
+ */
 export declare function b64Decode(val: string): string;
 /**
  * Codificar string a Base64 (UTF-8 seguro)
+ * @param str - String a codificar
+ * @returns String codificado en base64
+ *
+ * @example
+ * ```typescript
+ * const encoded = encodeBase64String('Hola Mundo ñ');
+ * // encoded: "SG9sYSBNdW5kbyDDsQ=="
+ * ```
  */
 export declare function encodeBase64String(str: string): string;
 /**
  * Decodificar Base64 a string (UTF-8 seguro)
+ * @param b64 - String en base64 a decodificar
+ * @returns String decodificado
+ *
+ * @example
+ * ```typescript
+ * const decoded = decodeBase64String('SG9sYSBNdW5kbyDDsQ==');
+ * // decoded: "Hola Mundo ñ"
+ * ```
  */
 export declare function decodeBase64String(b64: string): string;
 /**
  * Codificar un objeto a base64 (UTF-8 seguro)
+ * @param obj - Objeto a codificar
+ * @returns String codificado en base64
+ *
+ * @example
+ * ```typescript
+ * const obj = { nombre: 'Juan', edad: 25 };
+ * const encoded = encodeBase64Object(obj);
+ * ```
  */
 export declare function encodeBase64Object(obj: any): string;
 /**
  * Decodificar un base64 y obtener el objeto original
+ * @param b64 - String en base64 a decodificar
+ * @returns Objeto decodificado
+ *
+ * @example
+ * ```typescript
+ * const obj = decodeBase64Object<{ nombre: string, edad: number }>(encoded);
+ * // obj: { nombre: 'Juan', edad: 25 }
+ * ```
  */
 export declare function decodeBase64Object<T = any>(b64: string): T;
 /**
  * Codificar archivo a Base64 (retorna solo el contenido, sin "data:...")
+ * @param file - Archivo o Blob a codificar
+ * @returns Promise con el string en base64
+ *
+ * @example
+ * ```typescript
+ * const file = event.target.files[0];
+ * const base64 = await encodeBase64File(file);
+ * // base64: "iVBORw0KGgoAAAANSUhEUgAA..."
+ * ```
  */
 export declare function encodeBase64File(file: File | Blob): Promise<string>;
 /**
  * Decodificar Base64 a Blob (para reconstruir archivos en Angular)
+ * @param b64 - String en base64
+ * @param mimeType - Tipo MIME del archivo (opcional)
+ * @returns Blob con el contenido decodificado
+ *
+ * @example
+ * ```typescript
+ * const blob = decodeBase64ToBlob(base64String, 'image/png');
+ * const url = URL.createObjectURL(blob);
+ * // Usar url para mostrar imagen o descargar
+ * ```
  */
 export declare function decodeBase64ToBlob(b64: string, mimeType?: string): Blob;

package/src/functions/dev-log.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Configura el modo de producción para las utilidades de logging
+ * @param production - true si está en modo producción, false para desarrollo
+ *
+ * @example
+ * ```typescript
+ * import { setProductionMode } from '@jvsoft/utils';
+ * import { environment } from './environments/environment';
+ *
+ * setProductionMode(environment.production);
+ * ```
+ */
+export declare function setProductionMode(production: boolean): void;
+/**
+ * Obtiene el estado actual del modo de producción
+ * @returns true si está en modo producción, false en desarrollo
+ */
+export declare function isProduction(): boolean;
+/**
+ * Muestra mensajes de log solo en modo desarrollo
+ * @param args - Argumentos a mostrar en consola
+ *
+ * @example
+ * ```typescript
+ * devLog('Usuario cargado:', usuario);
+ * devLog('Estado:', { activo: true, rol: 'admin' });
+ * ```
+ */
+export declare function devLog(...args: any[]): void;
+/**
+ * Muestra advertencias solo en modo desarrollo
+ * @param args - Argumentos a mostrar como advertencia
+ *
+ * @example
+ * ```typescript
+ * devWarn('Función deprecada, usar nuevaFuncion() en su lugar');
+ * ```
+ */
+export declare function devWarn(...args: any[]): void;
+/**
+ * Muestra errores en consola (siempre, incluso en producción)
+ * @param args - Argumentos a mostrar como error
+ *
+ * @example
+ * ```typescript
+ * devError('Error al cargar datos:', error);
+ * ```
+ */
+export declare function devError(...args: any[]): void;
+/**
+ * Crea un grupo de logs solo en modo desarrollo
+ * @param label - Etiqueta del grupo
+ * @param collapsed - Si el grupo debe estar colapsado por defecto
+ *
+ * @example
+ * ```typescript
+ * devGroup('Datos del usuario');
+ * devLog('Nombre:', usuario.nombre);
+ * devLog('Email:', usuario.email);
+ * devGroupEnd();
+ * ```
+ */
+export declare function devGroup(label: string, collapsed?: boolean): void;
+/**
+ * Cierra el grupo de logs actual
+ */
+export declare function devGroupEnd(): void;
+/**
+ * Muestra una tabla en consola solo en modo desarrollo
+ * @param data - Datos a mostrar en formato tabla
+ *
+ * @example
+ * ```typescript
+ * devTable([
+ *   { nombre: 'Juan', edad: 25 },
+ *   { nombre: 'María', edad: 30 }
+ * ]);
+ * ```
+ */
+export declare function devTable(data: any): void;
+/**
+ * Inicia un temporizador solo en modo desarrollo
+ * @param label - Etiqueta del temporizador
+ *
+ * @example
+ * ```typescript
+ * devTime('carga-datos');
+ * // ... código a medir
+ * devTimeEnd('carga-datos'); // Muestra: carga-datos: 123.45ms
+ * ```
+ */
+export declare function devTime(label: string): void;
+/**
+ * Finaliza un temporizador y muestra el tiempo transcurrido
+ * @param label - Etiqueta del temporizador
+ */
+export declare function devTimeEnd(label: string): void;