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

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();
@@ -1647,10 +1846,10 @@ class DataEnListaPipe {
         }
         return null;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: DataEnListaPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.16", ngImport: i0, type: DataEnListaPipe, isStandalone: true, name: "dataEnLista" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: DataEnListaPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.14", ngImport: i0, type: DataEnListaPipe, isStandalone: true, name: "dataEnLista" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: DataEnListaPipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: DataEnListaPipe, decorators: [{
             type: Pipe,
             args: [{
                     name: 'dataEnLista',
@@ -1739,10 +1938,10 @@ class DateDiffStringPipe {
             seconds,
         };
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: DateDiffStringPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.16", ngImport: i0, type: DateDiffStringPipe, isStandalone: true, name: "dateDiffString" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: DateDiffStringPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.14", ngImport: i0, type: DateDiffStringPipe, isStandalone: true, name: "dateDiffString" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: DateDiffStringPipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: DateDiffStringPipe, decorators: [{
             type: Pipe,
             args: [{
                     name: 'dateDiffString',
@@ -1794,10 +1993,10 @@ class FiltroPipe {
             return false;
         });
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: FiltroPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.16", ngImport: i0, type: FiltroPipe, isStandalone: true, name: "filtro" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: FiltroPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.14", ngImport: i0, type: FiltroPipe, isStandalone: true, name: "filtro" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: FiltroPipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: FiltroPipe, decorators: [{
             type: Pipe,
             args: [{
                     name: 'filtro'
@@ -1811,10 +2010,10 @@ class FormControlIsRequiredPipe {
         }
         return formControl.hasValidator(Validators.required);
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: FormControlIsRequiredPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.16", ngImport: i0, type: FormControlIsRequiredPipe, isStandalone: true, name: "formControlIsRequired" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: FormControlIsRequiredPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.14", ngImport: i0, type: FormControlIsRequiredPipe, isStandalone: true, name: "formControlIsRequired" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: FormControlIsRequiredPipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: FormControlIsRequiredPipe, decorators: [{
             type: Pipe,
             args: [{
                     name: 'formControlIsRequired'
@@ -1837,10 +2036,10 @@ class JsonParsePipe {
             return [];
         }
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: JsonParsePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.16", ngImport: i0, type: JsonParsePipe, isStandalone: true, name: "jsonParse" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: JsonParsePipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.14", ngImport: i0, type: JsonParsePipe, isStandalone: true, name: "jsonParse" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: JsonParsePipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: JsonParsePipe, decorators: [{
             type: Pipe,
             args: [{
                     name: 'jsonParse'
@@ -1855,10 +2054,10 @@ class NoSanitizePipe {
     transform(html) {
         return this.domSanitizer.bypassSecurityTrustHtml(html);
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: NoSanitizePipe, deps: [{ token: i1.DomSanitizer }], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.16", ngImport: i0, type: NoSanitizePipe, isStandalone: true, name: "noSanitize" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: NoSanitizePipe, deps: [{ token: i1.DomSanitizer }], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.14", ngImport: i0, type: NoSanitizePipe, isStandalone: true, name: "noSanitize" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: NoSanitizePipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: NoSanitizePipe, decorators: [{
             type: Pipe,
             args: [{ name: 'noSanitize' }]
         }], ctorParameters: () => [{ type: i1.DomSanitizer }] });
@@ -1873,10 +2072,10 @@ class TipoValorFuncionPipe {
         }
         return datoParam;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: TipoValorFuncionPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.16", ngImport: i0, type: TipoValorFuncionPipe, isStandalone: true, name: "tipoValorFuncion" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: TipoValorFuncionPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.14", ngImport: i0, type: TipoValorFuncionPipe, isStandalone: true, name: "tipoValorFuncion" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: TipoValorFuncionPipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: TipoValorFuncionPipe, decorators: [{
             type: Pipe,
             args: [{
                     name: 'tipoValorFuncion',
@@ -1895,10 +2094,10 @@ class ZeroFillPipe {
         }
         return s;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: ZeroFillPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
-    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.16", ngImport: i0, type: ZeroFillPipe, isStandalone: true, name: "zeroFill" });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: ZeroFillPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.14", ngImport: i0, type: ZeroFillPipe, isStandalone: true, name: "zeroFill" });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.16", ngImport: i0, type: ZeroFillPipe, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.14", ngImport: i0, type: ZeroFillPipe, decorators: [{
             type: Pipe,
             args: [{
                     name: 'zeroFill',
@@ -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