@jvsoft/utils 1.0.0-alpha.4 → 1.0.0-alpha.5

package/fesm2022/jvsoft-utils.mjs

@@ -262,6 +262,30 @@ function eliminarElementos(origen, elementosAEliminar, claves) {
         return !clavesSet.has(key);
     });
 }
+/**
+ * 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)
+        return data;
+    const normalizar = (val) => val?.toString()?.toLowerCase() ?? '';
+    const esNum = !isNaN(Number(value));
+    return data.filter(item => {
+        const campos = Array.isArray(campoBuscar) ? campoBuscar : [campoBuscar];
+        return campos.some(campo => {
+            const campoVal = item[campo];
+            if (campoVal == null)
+                return false;
+            return esNum
+                ? campoVal.toString().includes(value.toString())
+                : normalizar(campoVal).includes(normalizar(value));
+        });
+    });
+}
 
 function mostrarValorEnBusqueda(campos, idxSel) {
     const impDataMostrar = () => {
@@ -484,17 +508,192 @@ function changeSelectApi(control, queryService, formControl, tipo, dataExtra = {
         }
     });
 }
+/**
+ * Comprueba si un valor es una Promesa
+ * @param valor - Valor a verificar
+ * @returns true si es una Promise
+ */
+function esPromise(valor) {
+    return !!valor && typeof valor.then === 'function';
+}
+/**
+ * Selecciona todo el texto de un input
+ * @param event - Evento del input
+ */
+function seleccionarTextoInput$1(event) {
+    event.target.select();
+}
+/**
+ * Función genérica para vincular un FormControl con datos desde API o Promise.
+ * Preparada para migrar a signals en el futuro.
+ */
+function changeSelectReformateado(config) {
+    const { objThis, tipoReq, formControl, queryService, campoId, minLength = 3, dataExtra = {}, dataExtraVariable = [], anonimo = false, variableResultado = tipoReq, } = config;
+    formControl.valueChanges.pipe(debounceTime(500), tap(() => {
+        objThis.filtrados[variableResultado + 'tmp'] = isObservable(objThis.filtrados[variableResultado])
+            ? []
+            : objThis.filtrados[variableResultado] || [];
+        if (objThis.filtrados[variableResultado] !== objThis.filtrados[variableResultado + 'tmp']) {
+            objThis.filtrados[variableResultado] = [];
+        }
+        objThis.isLoading = true;
+    }), switchMap(value => {
+        if (campoId) {
+            const existe = objThis.filtrados[variableResultado + 'tmp']
+                .findIndex((item) => item[campoId] === value);
+            if (existe >= 0) {
+                return of({ [tipoReq]: objThis.filtrados[variableResultado + 'tmp'] });
+            }
+        }
+        if (!value || value.length < minLength) {
+            objThis.isLoading = false;
+            return of({ [tipoReq]: [] });
+        }
+        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] ?? [] }))
+                .finally(() => { objThis.isLoading = false; });
+        }
+        return query.pipe(finalize(() => { objThis.isLoading = false; }));
+    })).subscribe((data) => {
+        objThis.filtrados[variableResultado] = data[tipoReq] ?? [];
+    });
+}
 
 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();
+    const bytes = encoder.encode(str);
+    let binary = '';
+    bytes.forEach(b => binary += String.fromCharCode(b));
+    return btoa(binary);
+}
+/**
+ * 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);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    const decoder = new TextDecoder();
+    return decoder.decode(bytes);
+}
+/**
+ * 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) => {
+        const reader = new FileReader();
+        reader.onload = () => {
+            const result = reader.result;
+            resolve(result.split(',')[1]); // quita el prefijo "data:...;base64,"
+        };
+        reader.onerror = reject;
+        reader.readAsDataURL(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);
+    const byteNumbers = new Array(byteChars.length);
+    for (let i = 0; i < byteChars.length; i++) {
+        byteNumbers[i] = byteChars.charCodeAt(i);
+    }
+    return new Blob([new Uint8Array(byteNumbers)], { type: mimeType });
+}
 
 function getBrowserName() {
     const agent = window.navigator.userAgent.toLowerCase();
@@ -1921,5 +2120,5 @@ function zeroFill(value, digitos, ...args) {
  * Generated bundle index. Do not edit.
  */
 
-export { DataEnListaPipe, DataModel, DateDiffStringPipe, FiltroPipe, FormControlIsRequiredPipe, JsonParsePipe, NoSanitizePipe, TipoValorFuncionPipe, ZeroFillPipe, b64Decode, b64Encode, buscarPorCampo, changeSelect, changeSelectApi, changeSelectData, changeSelectDataApi, convertirBytes, dataEnLista, dateDiffString, deepClone, deepMerge, delLocalStorage, desencriptar, devError, devGroup, devGroupEnd, devLog, devTable, devTime, devTimeEnd, devWarn, downLoadFileStream, eliminarColumnaPorIndex, eliminarDuplicados, eliminarElementos, encriptar, esNumero, establecerQuitarRequired, extraerDominio, formControlIsRequired, formatearFecha, formatearFechaCadena, formatearFechaFormato, generateRandomString, getBrowserName, getCambiarPwd, getDataArchivoFromPath, getFormValidationErrors, getLocalStorage, getUniqueValues, getUniqueValuesByProperty, 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, tipoValorFuncion, toFormData, transformarFechasPorNombreDeCampo, verificarRUC, zeroFill };
+export { DataEnListaPipe, DataModel, DateDiffStringPipe, FiltroPipe, FormControlIsRequiredPipe, JsonParsePipe, NoSanitizePipe, TipoValorFuncionPipe, ZeroFillPipe, b64Decode, b64Encode, buscarPorCampo, changeSelect, changeSelectApi, changeSelectData, changeSelectDataApi, changeSelectReformateado, convertirBytes, dataEnLista, dateDiffString, 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, formControlIsRequired, 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, tipoValorFuncion, toFormData, transformarFechasPorNombreDeCampo, verificarRUC, zeroFill };
 //# sourceMappingURL=jvsoft-utils.mjs.map