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

package/fesm2022/jvsoft-utils-src-functions.mjs

@@ -11,14 +11,6 @@ import moment from 'moment';
 import swal from 'sweetalert2';
 import { jwtDecode } from 'jwt-decode';
 
-/**
- * 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.
- */
 function deepMerge(source, target) {
     // Crea un clon profundo sin usar JSON.parse(JSON.stringify)
     let cloneSource = deepClone(source);
@@ -40,12 +32,7 @@ function deepMerge(source, target) {
     }
     return cloneSource; // Retorna el clon y no modifica el original
 }
-/**
- * Realiza una clonación profunda de un objeto, manejando funciones, fechas y arrays.
- *
- * @param obj - Objeto a clonar.
- * @returns Una copia profunda del objeto.
- */
+// Función de clonación profunda que maneja funciones, fechas y otros tipos especiales
 function deepClone(obj) {
     if (obj === null || typeof obj !== 'object') {
         return obj; // Devuelve el valor si no es un objeto
@@ -71,7 +58,6 @@ function deepClone(obj) {
 /**
  * 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.
  */
 function buscarPorCampo(datosFn) {
@@ -98,33 +84,13 @@ function buscarPorCampo(datosFn) {
     // Si no se encuentra nada, retorna undefined
     return 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.
- */
 function sumarPropiedades(item, campos) {
     const datosSumar = campos.map(campo => (item[campo] * 1));
     return datosSumar.reduce((a, b) => a + b, 0);
 }
-/**
- * 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.
- */
 function esNumero(value) {
     return !isNaN(Number(value));
 }
-/**
- * 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.
- */
 function sumarObjetos(arrayObjetos, campos) {
     return arrayObjetos.reduce((accumulator, item) => {
         campos.forEach(campo => {
@@ -136,22 +102,9 @@ function sumarObjetos(arrayObjetos, campos) {
         return accumulator;
     }, {});
 }
-/**
- * Obtiene los valores únicos de un array.
- *
- * @param array - Array de valores.
- * @returns Array con los valores únicos.
- */
 function getUniqueValues(array) {
     return array.filter((currentValue, index, arr) => (arr.indexOf(currentValue) === index));
 }
-/**
- * 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.
- */
 function getUniqueValuesByProperty(objetos, campo) {
     const objetosUnicos = {};
     objetos.forEach(objeto => {
@@ -167,14 +120,6 @@ function getUniqueValuesByProperty(objetos, campo) {
     // Convertir el objeto de claves únicas de vuelta a una lista de objetos
     return Object.values(objetosUnicos);
 }
-/**
- * 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.
- */
 function ordenarArray(array, numeros = false, sentido = 'ASC') {
     if (numeros) {
         if (sentido != 'ASC') {
@@ -184,24 +129,9 @@ function ordenarArray(array, numeros = false, sentido = 'ASC') {
     }
     return array.sort((a, b) => (a > b) ? 1 : ((b > a) ? -1 : 0));
 }
-/**
- * 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.
- */
 function ordenarPorPropiedad(objData, propiedad, /**@deprecated*/ numeros = false) {
     return ordenarPorPropiedades(objData, { propiedades: [propiedad], direcciones: ['asc'] });
 }
-/**
- * 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.
- */
 function ordenarPorPropiedades(arr, options) {
     const { propiedades, direcciones = [] } = options;
     const orden = direcciones.map(d => d === 'desc' ? -1 : 1);
@@ -221,13 +151,6 @@ function ordenarPorPropiedades(arr, options) {
         }, 0);
     });
 }
-/**
- * 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.
- */
 function groupBy(array, key) {
     const keyFn = key instanceof Function ? key : (obj) => obj[key];
     return array.reduce((objectsByKeyValue, obj) => {
@@ -236,13 +159,6 @@ function groupBy(array, key) {
         return objectsByKeyValue;
     }, {});
 }
-/**
- * Agrupa y anida los elementos de un array según una lista de propiedades.
- *
- * @param arr - Array de objetos a agrupar.
- * @param properties - Propiedades para agrupar de forma anidada.
- * @returns Objeto anidado por los grupos de propiedades.
- */
 function nestGroupsBy(arr, properties) {
     const fnGroupBy = (conversions, property2) => {
         return conversions.reduce((acc, obj) => {
@@ -316,13 +232,6 @@ function eliminarColumnaPorIndex(data, columnIndex) {
         return newRow;
     });
 }
-/**
- * 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.
- */
 function eliminarDuplicados(array, claves) {
     const unicos = new Map();
     for (const item of array) {
@@ -335,14 +244,6 @@ function eliminarDuplicados(array, claves) {
     }
     return Array.from(unicos.values());
 }
-/**
- * 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.
- */
 function eliminarElementos(origen, elementosAEliminar, claves) {
     const clavesSet = new Set();
     for (const item of elementosAEliminar) {
@@ -358,41 +259,12 @@ function eliminarElementos(origen, elementosAEliminar, claves) {
         return !clavesSet.has(key);
     });
 }
-
-/**
- * Devuelve un valor de visualización para un elemento buscado.
- * Compatible con listas simples, objetos y campos múltiples.
- */
-function mostrarValorEnBusqueda(campos, idxSel) {
-    const buscarEnLista = (lista) => {
-        if (!lista)
-            return null;
-        if (campos.campoId === '*object*' || campos.campoId === '*objeto*') {
-            return lista.find((x) => JSON.stringify(x).trim() === JSON.stringify(idxSel).trim());
-        }
-        return lista.find((x) => x[campos.campoId] === idxSel);
-    };
-    const impDataMostrar = () => {
-        let vD = buscarEnLista(campos.lista) || (campos.opcExtra && buscarEnLista(campos.opcExtra));
-        if (!vD)
-            return '';
-        if (Array.isArray(campos.campoValue)) {
-            return campos.campoValue.map((vCampo) => vD[vCampo] ?? '').join(' - ').trim();
-        }
-        return (vD[campos.campoValue] ?? '').trim();
-    };
-    if (esNumero(idxSel)) {
-        if ((idxSel > 0 && campos.lista?.length) || (idxSel && typeof idxSel === 'object')) {
-            return impDataMostrar();
-        }
-    }
-    else if (campos.lista?.length) {
-        return impDataMostrar();
-    }
-    return '';
-}
 /**
- * Filtra datos locales de un array basado en un valor de búsqueda.
+ * 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
  */
 function filtrarDatosLocal(data, value, campoBuscar) {
     if (!value)
@@ -411,24 +283,242 @@ function filtrarDatosLocal(data, value, campoBuscar) {
         });
     });
 }
+
+function mostrarValorEnBusqueda(campos, idxSel) {
+    const impDataMostrar = () => {
+        let vD;
+        if (campos.campoId == '*object*' || campos.campoId == '*objeto*') {
+            console.log(campos);
+            vD = campos.lista.find((x) => JSON.stringify(x).trim() == JSON.stringify(idxSel).trim());
+            console.log(vD);
+        }
+        else {
+            vD = campos.lista.find((x) => x[campos.campoId] == idxSel);
+        }
+        if (!vD && campos.opcExtra) {
+            console.log('eval ', campos.opcExtra);
+            if (campos.campoId == '*object*' || campos.campoId == '*objeto*') {
+                console.log(campos);
+                vD = campos.opcExtra.find((x) => JSON.stringify(x).trim() == JSON.stringify(idxSel).trim());
+                console.log(vD);
+            }
+            else {
+                vD = campos.opcExtra.find((x) => x[campos.campoId] == idxSel);
+            }
+        }
+        if (vD) {
+            let txtFinal = '';
+            if (Array.isArray(campos.campoValue)) {
+                campos.campoValue.forEach((vCampo, idx) => {
+                    txtFinal += (vD[vCampo] ?? '');
+                    if (idx < campos.campoValue.length - 1) {
+                        txtFinal += ' - ';
+                    }
+                });
+            }
+            else {
+                txtFinal = vD[campos.campoValue] ?? '';
+            }
+            return txtFinal.trim();
+        }
+        else {
+            console.log('ASSSSS ----- SSSS ');
+        }
+        return '';
+    };
+    if (esNumero(idxSel)) {
+        if (idxSel > 0 && campos.lista?.length > 0) {
+            return impDataMostrar();
+        }
+        else if (idxSel && typeof idxSel == 'object') {
+            return impDataMostrar();
+        }
+    }
+    else {
+        if (campos.lista?.length > 0) {
+            return impDataMostrar();
+        }
+    }
+    return '';
+}
+function changeSelectData(objThis, dataFiltro) {
+    objThis['filtrados'][dataFiltro.variableResultado] = dataFiltro.formControl.valueChanges.pipe(untilDestroyed(objThis)).pipe(startWith(''), map(value => {
+        const varN = dataFiltro.data;
+        if (varN) {
+            if (value) {
+                return varN.map(x => x).filter(dat => {
+                    if (Array.isArray(dataFiltro.campoBuscar)) {
+                        let encontrado = false;
+                        for (const vCampo of dataFiltro.campoBuscar) {
+                            // console.log(vCampo, value, dat[vCampo]);
+                            if (isNaN(Number(value))) {
+                                // NO ES NUMERO
+                                if (value && dat[vCampo] && dat[vCampo].toLowerCase().includes(value?.toString().toLowerCase())) {
+                                    encontrado = true;
+                                    break;
+                                }
+                            }
+                            else {
+                                if (value && dat[vCampo] && dat[vCampo].toString().includes(value?.toString())) {
+                                    encontrado = true;
+                                    break;
+                                }
+                            }
+                        }
+                        return encontrado;
+                    }
+                    else {
+                        if (isNaN(Number(value))) {
+                            return dat[dataFiltro.campoBuscar].toLowerCase().includes(value?.toString().toLowerCase());
+                        }
+                        else {
+                            return dat[dataFiltro.campoBuscar].toString().includes(value?.toString());
+                        }
+                    }
+                });
+            }
+            return varN;
+        }
+        return false;
+    }));
+}
+function changeSelect(control, formControl, tipo, campoBuscar, campoFiltro = null) {
+    // console.log(formControl);
+    // const formGroup = formControl.parent.controls;
+    // console.warn( Object.keys(formGroup).find(name => formControl === formGroup[name]) || null );
+    if (!campoFiltro) {
+        campoFiltro = tipo;
+    }
+    control['filtrados'][campoFiltro ?? '__'] = formControl.valueChanges.pipe(untilDestroyed(control)).pipe(startWith(''), map(value => {
+        // console.warn(value);
+        const partes = tipo.split('.');
+        let varN;
+        if (control['dataServidor']) {
+            varN = (partes.length > 1) ? control['dataServidor'][partes[0]][partes[1]] : control['dataServidor'][tipo];
+        }
+        else if (control['dataServidorSuscripcion']) {
+            varN = control['dataServidorSuscripcion'][tipo].getValue();
+        }
+        if (varN) {
+            if (value) {
+                return varN.map((x) => x).filter((dat) => {
+                    if (Array.isArray(campoBuscar)) {
+                        let encontrado = false;
+                        for (const vCampo of campoBuscar) {
+                            // console.log(vCampo, value, dat[vCampo]);
+                            if (isNaN(Number(value))) {
+                                // NO ES NUMERO
+                                if (value && dat[vCampo] && dat[vCampo].toLowerCase().includes(value?.toString().toLowerCase())) {
+                                    encontrado = true;
+                                    break;
+                                }
+                            }
+                            else {
+                                if (value && dat[vCampo] && dat[vCampo].toString().includes(value?.toString())) {
+                                    encontrado = true;
+                                    break;
+                                }
+                            }
+                        }
+                        return encontrado;
+                    }
+                    else {
+                        if (isNaN(Number(value))) {
+                            return dat[campoBuscar].toLowerCase().includes(value?.toString().toLowerCase());
+                        }
+                        else {
+                            return dat[campoBuscar].toString().includes(value?.toString());
+                        }
+                    }
+                });
+            }
+            return varN;
+        }
+        return false;
+    }));
+}
+function changeSelectDataApi(objThis, dataFiltro) {
+    if (!dataFiltro.variableResultado) {
+        dataFiltro.variableResultado = dataFiltro.tipoReq;
+    }
+    const idFiltrado = dataFiltro.variableResultado;
+    dataFiltro.formControl.valueChanges.pipe(debounceTime(500), tap(() => {
+        objThis.filtrados[dataFiltro.variableResultado + 'tmp'] = isObservable(objThis.filtrados[idFiltrado]) ? [] : objThis.filtrados[idFiltrado] || [];
+        if (objThis.filtrados[idFiltrado] !== objThis.filtrados[idFiltrado + 'tmp']) {
+            objThis.filtrados[idFiltrado] = [];
+        }
+        objThis.isLoading = true;
+    }), switchMap(value => {
+        if (dataFiltro.campoId) {
+            const busquedaActual2 = objThis.filtrados[idFiltrado + 'tmp'].findIndex((item) => item[dataFiltro.campoId ?? '--'] === value);
+            if (busquedaActual2 >= 0) {
+                return of({ [dataFiltro.tipoReq]: objThis.filtrados[idFiltrado + 'tmp'] });
+            }
+        }
+        return !value || value.length < (dataFiltro.minLength ?? 3) ? [] : (dataFiltro.queryService.getDataMethod('GET', dataFiltro.tipoReq, {
+            ...(dataFiltro.dataExtra ?? {}),
+            ...(dataFiltro.dataExtraVariable ? Object.fromEntries(dataFiltro.dataExtraVariable.map((objData) => [objData.campo, objData.ctrlValue.value])) : {}),
+            txtBuscar: value,
+        }, dataFiltro.anonimo).pipe(finalize(() => objThis.isLoading = false)));
+    })).subscribe((data) => {
+        objThis.filtrados[idFiltrado] = data[dataFiltro.tipoReq] ?? [];
+    });
+}
+function changeSelectApi(control, queryService, formControl, tipo, dataExtra = {}, dataExtraVariable = null, minLength = 1, anonimo = false) {
+    formControl.valueChanges.pipe(debounceTime(500), tap((value) => {
+        control['filtrados'][tipo + 'tmp'] = isObservable(control['filtrados'][tipo]) ? [] : control['filtrados'][tipo];
+        if (control['filtrados'][tipo] != control['filtrados'][tipo + 'tmp']) {
+            control['filtrados'][tipo] = [];
+        }
+        control['isLoading'] = true;
+    }), switchMap(value => {
+        const formGroup = formControl.parent?.controls;
+        const nombreControl = Object.keys(formGroup).find(name => formControl === formGroup[name]) || null;
+        if (nombreControl && control['filtrados'][tipo + 'tmp'] && control['filtrados'][tipo + 'tmp'].length > 0) {
+            const busquedaActual = control['filtrados'][tipo + 'tmp'].findIndex((item) => item[nombreControl] == value);
+            if (busquedaActual >= 0) {
+                const vRet = {};
+                vRet[tipo] = control['filtrados'][tipo + 'tmp'];
+                control['isLoading'] = false;
+                return of(vRet);
+            }
+        }
+        if (!value || value.length < minLength) {
+            return [];
+        }
+        const dataExtraVariableData = {};
+        if (dataExtraVariable) {
+            // @ts-ignore
+            for (const objData of dataExtraVariable) {
+                dataExtraVariableData[objData.campo] = objData.ctrlValue.value;
+            }
+        }
+        return queryService.getDataMethod('GET', tipo, { ...dataExtra, ...dataExtraVariableData, ...{ txtBuscar: value } }, anonimo).pipe(finalize(() => {
+            control['isLoading'] = false;
+        }));
+    })).subscribe((data) => {
+        if (data[tipo] == undefined) {
+            control['filtrados'][tipo] = [];
+        }
+        else {
+            control['filtrados'][tipo] = data[tipo];
+        }
+    });
+}
 /**
- * Vincula un FormControl a datos locales para autocompletado.
+ * Comprueba si un valor es una Promesa
+ * @param valor - Valor a verificar
+ * @returns true si es una Promise
  */
-function changeSelectData(objThis, { formControl, data, campoBuscar, variableResultado }) {
-    objThis.filtrados[variableResultado] = formControl.valueChanges.pipe(untilDestroyed(objThis)).pipe(startWith(''), map(value => data ? filtrarDatosLocal(data, value, campoBuscar) : []));
+function esPromise(valor) {
+    return !!valor && typeof valor.then === 'function';
 }
 /**
- * Vincula un FormControl a datos locales obtenidos de dataServidor o dataServidorSuscripcion.
+ * Selecciona todo el texto de un input
+ * @param event - Evento del input
  */
-function changeSelect(control, formControl, tipo, campoBuscar, campoFiltro = null) {
-    const filtro = campoFiltro ?? tipo;
-    control.filtrados[filtro] = formControl.valueChanges.pipe(untilDestroyed(control)).pipe(startWith(''), map(value => {
-        const partes = tipo.split('.');
-        const varN = control.dataServidor?.[partes[0]]?.[partes[1]] ??
-            control.dataServidor?.[tipo] ??
-            control.dataServidorSuscripcion?.[tipo]?.getValue();
-        return varN ? filtrarDatosLocal(varN, value, campoBuscar) : [];
-    }));
+function seleccionarTextoInput$1(event) {
+    event.target.select();
 }
 /**
  * Función genérica para vincular un FormControl con datos desde API o Promise.
@@ -456,10 +546,11 @@ function changeSelectReformateado(config) {
             objThis.isLoading = false;
             return of({ [tipoReq]: [] });
         }
-        const extraVars = Object.fromEntries(dataExtraVariable.map(v => [v.campo, v.ctrlValue.value]));
+        const extraVars = Object.fromEntries(dataExtraVariable.map((v) => [v.campo, v.ctrlValue.value]));
         const query = queryService.getDataMethod('GET', tipoReq, { ...dataExtra, ...extraVars, txtBuscar: value }, anonimo);
         if (esPromise(query)) {
-            return query.then((data) => ({ [tipoReq]: data[tipoReq] ?? [] }))
+            return query
+                .then((data) => ({ [tipoReq]: data[tipoReq] ?? [] }))
                 .finally(() => { objThis.isLoading = false; });
         }
         return query.pipe(finalize(() => { objThis.isLoading = false; }));
@@ -467,57 +558,39 @@ function changeSelectReformateado(config) {
         objThis.filtrados[variableResultado] = data[tipoReq] ?? [];
     });
 }
-/**
- * Alias para compatibilidad.
- */
-function changeSelectDataApi(objThis, dataFiltro) {
-    return changeSelectReformateado({
-        objThis,
-        tipoReq: dataFiltro.tipoReq,
-        formControl: dataFiltro.formControl,
-        queryService: dataFiltro.queryService,
-        campoId: dataFiltro.campoId,
-        minLength: dataFiltro.minLength,
-        dataExtra: dataFiltro.dataExtra,
-        dataExtraVariable: dataFiltro.dataExtraVariable,
-        anonimo: dataFiltro.anonimo,
-        variableResultado: dataFiltro.variableResultado,
-    });
-}
-/**
- * Alias para compatibilidad.
- */
-function changeSelectApi(control, queryService, formControl, tipo, dataExtra = {}, dataExtraVariable = null, minLength = 1, anonimo = false) {
-    return changeSelectReformateado({
-        objThis: control,
-        tipoReq: tipo,
-        formControl,
-        queryService,
-        minLength,
-        dataExtra,
-        dataExtraVariable: dataExtraVariable ?? [],
-        anonimo,
-    });
-}
-/**
- * Comprueba si un valor es una Promesa.
- */
-function esPromise(valor) {
-    return !!valor && typeof valor.then === 'function';
-}
 
 function seleccionarTextoInput(event) {
     event.target.select();
 }
 
+/**
+ * Codifica un string a base64 (método legacy)
+ * @param val - String a codificar
+ * @returns String codificado en base64
+ * @deprecated Use encodeBase64String() en su lugar
+ */
 function b64Encode(val) {
     return Buffer.from(val, 'binary').toString('base64');
 }
+/**
+ * Decodifica un string desde base64 (método legacy)
+ * @param val - String en base64 a decodificar
+ * @returns String decodificado
+ * @deprecated Use decodeBase64String() en su lugar
+ */
 function b64Decode(val) {
     return Buffer.from(val, 'base64').toString('binary');
 }
 /**
  * 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=="
+ * ```
  */
 function encodeBase64String(str) {
     const encoder = new TextEncoder();
@@ -528,6 +601,14 @@ function encodeBase64String(str) {
 }
 /**
  * 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 ñ"
+ * ```
  */
 function decodeBase64String(b64) {
     const binary = atob(b64);
@@ -540,18 +621,43 @@ function decodeBase64String(b64) {
 }
 /**
  * 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);
+ * ```
  */
 function encodeBase64Object(obj) {
     return encodeBase64String(JSON.stringify(obj));
 }
 /**
  * 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 }
+ * ```
  */
 function decodeBase64Object(b64) {
     return JSON.parse(decodeBase64String(b64));
 }
 /**
  * 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..."
+ * ```
  */
 function encodeBase64File(file) {
     return new Promise((resolve, reject) => {
@@ -566,6 +672,16 @@ function encodeBase64File(file) {
 }
 /**
  * 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
+ * ```
  */
 function decodeBase64ToBlob(b64, mimeType = 'application/octet-stream') {
     const byteChars = atob(b64);
@@ -639,6 +755,147 @@ function formatearFechaCadena(fecha) {
     return new Date(year, month, day);
 }
 
+/**
+ * Configuración global para las utilidades de logging
+ */
+let isProductionMode = false;
+/**
+ * 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);
+ * ```
+ */
+function setProductionMode(production) {
+    isProductionMode = production;
+}
+/**
+ * Obtiene el estado actual del modo de producción
+ * @returns true si está en modo producción, false en desarrollo
+ */
+function isProduction() {
+    return isProductionMode;
+}
+/**
+ * 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' });
+ * ```
+ */
+function devLog(...args) {
+    if (!isProductionMode) {
+        console.log(...args);
+    }
+}
+/**
+ * Muestra advertencias solo en modo desarrollo
+ * @param args - Argumentos a mostrar como advertencia
+ *
+ * @example
+ * ```typescript
+ * devWarn('Función deprecada, usar nuevaFuncion() en su lugar');
+ * ```
+ */
+function devWarn(...args) {
+    if (!isProductionMode) {
+        console.warn(...args);
+    }
+}
+/**
+ * Muestra errores en consola (siempre, incluso en producción)
+ * @param args - Argumentos a mostrar como error
+ *
+ * @example
+ * ```typescript
+ * devError('Error al cargar datos:', error);
+ * ```
+ */
+function devError(...args) {
+    console.error(...args);
+}
+/**
+ * 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();
+ * ```
+ */
+function devGroup(label, collapsed = false) {
+    if (!isProductionMode) {
+        if (collapsed) {
+            console.groupCollapsed(label);
+        }
+        else {
+            console.group(label);
+        }
+    }
+}
+/**
+ * Cierra el grupo de logs actual
+ */
+function devGroupEnd() {
+    if (!isProductionMode) {
+        console.groupEnd();
+    }
+}
+/**
+ * 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 }
+ * ]);
+ * ```
+ */
+function devTable(data) {
+    if (!isProductionMode) {
+        console.table(data);
+    }
+}
+/**
+ * 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
+ * ```
+ */
+function devTime(label) {
+    if (!isProductionMode) {
+        console.time(label);
+    }
+}
+/**
+ * Finaliza un temporizador y muestra el tiempo transcurrido
+ * @param label - Etiqueta del temporizador
+ */
+function devTimeEnd(label) {
+    if (!isProductionMode) {
+        console.timeEnd(label);
+    }
+}
+
 function maskEmail(email) {
     const [user, domain] = email.split("@");
     if (user.length <= 2) {
@@ -1446,5 +1703,5 @@ function verificarRUC(ruc) {
  * Generated bundle index. Do not edit.
  */
 
-export { b64Decode, b64Encode, buscarPorCampo, changeSelect, changeSelectApi, changeSelectData, changeSelectDataApi, changeSelectReformateado, convertirBytes, decodeBase64Object, decodeBase64String, decodeBase64ToBlob, deepClone, deepMerge, delLocalStorage, desencriptar, downLoadFileStream, eliminarColumnaPorIndex, eliminarDuplicados, eliminarElementos, encodeBase64File, encodeBase64Object, encodeBase64String, encriptar, esNumero, establecerQuitarRequired, extraerDominio, formatearFecha, formatearFechaCadena, formatearFechaFormato, generateRandomString, getBrowserName, getCambiarPwd, getDataArchivoFromPath, getFormValidationErrors, getLocalStorage, getUniqueValues, getUniqueValuesByProperty, groupBy, inicializarVariablesSessionStorage, isEmail, jwtToken, jwtTokenData, jwtTokenExpiracion, jwtTokenExpiracionFaltante, localStorageKeys, markAsTouchedWithoutEmitEvent, maskEmail, mensajeAlerta, mensajeConfirmacion, mensajeTimer, mensajeToast, mensajesDeError, mensajesErrorFormControl, mostrarValorEnBusqueda, nestGroupsBy, numberToWords, objectPropertiesBoolean, objectPropertiesToType, obtenerHostDesdeUrl, obtenerMimeType, obtenerUltimoOrden, ordenarArray, ordenarPorPropiedad, ordenarPorPropiedades, roundToDecimal, sanitizarNombreArchivo, seleccionarTextoInput, setCambiarPwd, setControlDesdeLista, setJwtTokenData, setLocalStorage, sumarObjetos, sumarPropiedades, toFormData, transformarFechasPorNombreDeCampo, verificarRUC };
+export { b64Decode, b64Encode, buscarPorCampo, changeSelect, changeSelectApi, changeSelectData, changeSelectDataApi, changeSelectReformateado, convertirBytes, decodeBase64Object, decodeBase64String, decodeBase64ToBlob, deepClone, deepMerge, delLocalStorage, desencriptar, devError, devGroup, devGroupEnd, devLog, devTable, devTime, devTimeEnd, devWarn, downLoadFileStream, eliminarColumnaPorIndex, eliminarDuplicados, eliminarElementos, encodeBase64File, encodeBase64Object, encodeBase64String, encriptar, esNumero, esPromise, establecerQuitarRequired, extraerDominio, filtrarDatosLocal, formatearFecha, formatearFechaCadena, formatearFechaFormato, generateRandomString, getBrowserName, getCambiarPwd, getDataArchivoFromPath, getFormValidationErrors, getLocalStorage, getUniqueValues, getUniqueValuesByProperty, getValueByPath, groupBy, inicializarVariablesSessionStorage, isEmail, isProduction, jwtToken, jwtTokenData, jwtTokenExpiracion, jwtTokenExpiracionFaltante, localStorageKeys, markAsTouchedWithoutEmitEvent, maskEmail, mensajeAlerta, mensajeConfirmacion, mensajeTimer, mensajeToast, mensajesDeError, mensajesErrorFormControl, mostrarValorEnBusqueda, nestGroupsBy, numberToWords, objectPropertiesBoolean, objectPropertiesToType, obtenerHostDesdeUrl, obtenerMimeType, obtenerUltimoOrden, ordenarArray, ordenarPorPropiedad, ordenarPorPropiedades, roundToDecimal, sanitizarNombreArchivo, seleccionarTextoInput, setCambiarPwd, setControlDesdeLista, setJwtTokenData, setLocalStorage, setProductionMode, sumarObjetos, sumarPropiedades, toFormData, transformarFechasPorNombreDeCampo, verificarRUC };
 //# sourceMappingURL=jvsoft-utils-src-functions.mjs.map