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

package/functions/base64.d.ts

@@ -1,2 +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/mat-form-controls/autocomplete.d.ts

@@ -19,3 +19,30 @@ export declare function changeSelectDataApi(objThis: any, dataFiltro: {
     variableResultado?: string;
 }): void;
 export declare function changeSelectApi(control: any, queryService: any, formControl: AbstractControl, tipo: any, dataExtra?: {}, dataExtraVariable?: any[] | null, minLength?: number, anonimo?: boolean): void;
+/**
+ * Comprueba si un valor es una Promesa
+ * @param valor - Valor a verificar
+ * @returns true si es una Promise
+ */
+export declare function esPromise(valor: any): boolean;
+/**
+ * Selecciona todo el texto de un input
+ * @param event - Evento del input
+ */
+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;
+    queryService: any;
+    campoId?: string;
+    minLength?: number;
+    dataExtra?: any;
+    dataExtraVariable?: any[];
+    anonimo?: boolean;
+    variableResultado?: string;
+}): void;

package/functions/objects-arrays.d.ts

@@ -26,6 +26,14 @@ export declare function ordenarPorPropiedades<T>(arr: T[], options: {
 }): T[];
 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;
+/**
+ * Obtiene un valor de un objeto usando una ruta de propiedad anidada.
+ *
+ * @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 getValueByPath(obj: any, path: string): any;
 /**
  * Retorna el valor máximo del campo especificado (incluso anidado) en un arreglo de objetos.
  *
@@ -45,3 +53,11 @@ export declare function obtenerUltimoOrden(data: any[], campo: string, increment
 export declare function eliminarColumnaPorIndex<T extends unknown[][]>(data: T, columnIndex: number | number[]): T;
 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[];
+/**
+ * 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 filtrarDatosLocal(data: any[], value: any, campoBuscar: string | string[]): any[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jvsoft/utils",
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-alpha.5",
   "description": "JVSOFT Angular Utils",
   "publishConfig": {
     "tag": "alpha",
@@ -35,13 +35,13 @@
       "types": "./src/functions/index.d.ts",
       "default": "./fesm2022/jvsoft-utils-src-functions.mjs"
     },
-    "./src/pipes": {
-      "types": "./src/pipes/index.d.ts",
-      "default": "./fesm2022/jvsoft-utils-src-pipes.mjs"
-    },
     "./src/interfaces": {
       "types": "./src/interfaces/index.d.ts",
       "default": "./fesm2022/jvsoft-utils-src-interfaces.mjs"
+    },
+    "./src/pipes": {
+      "types": "./src/pipes/index.d.ts",
+      "default": "./fesm2022/jvsoft-utils-src-pipes.mjs"
     }
   },
   "dependencies": {

package/src/functions/base64.d.ts

@@ -1,2 +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/mat-form-controls/autocomplete.d.ts

@@ -19,3 +19,30 @@ export declare function changeSelectDataApi(objThis: any, dataFiltro: {
     variableResultado?: string;
 }): void;
 export declare function changeSelectApi(control: any, queryService: any, formControl: AbstractControl, tipo: any, dataExtra?: {}, dataExtraVariable?: any[] | null, minLength?: number, anonimo?: boolean): void;
+/**
+ * Comprueba si un valor es una Promesa
+ * @param valor - Valor a verificar
+ * @returns true si es una Promise
+ */
+export declare function esPromise(valor: any): boolean;
+/**
+ * Selecciona todo el texto de un input
+ * @param event - Evento del input
+ */
+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;
+    queryService: any;
+    campoId?: string;
+    minLength?: number;
+    dataExtra?: any;
+    dataExtraVariable?: any[];
+    anonimo?: boolean;
+    variableResultado?: string;
+}): void;

package/src/functions/objects-arrays.d.ts

@@ -26,6 +26,14 @@ export declare function ordenarPorPropiedades<T>(arr: T[], options: {
 }): T[];
 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;
+/**
+ * Obtiene un valor de un objeto usando una ruta de propiedad anidada.
+ *
+ * @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 getValueByPath(obj: any, path: string): any;
 /**
  * Retorna el valor máximo del campo especificado (incluso anidado) en un arreglo de objetos.
  *
@@ -45,3 +53,11 @@ export declare function obtenerUltimoOrden(data: any[], campo: string, increment
 export declare function eliminarColumnaPorIndex<T extends unknown[][]>(data: T, columnIndex: number | number[]): T;
 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[];
+/**
+ * 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 filtrarDatosLocal(data: any[], value: any, campoBuscar: string | string[]): any[];