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

package/src/functions/base64.d.ts

@@ -1,2 +0,0 @@
-export declare function b64Encode(val: string): string;
-export declare function b64Decode(val: string): string;

package/src/functions/browser.d.ts

@@ -1 +0,0 @@
-export declare function getBrowserName(): "edge" | "opera" | "chrome" | "ie" | "firefox" | "safari" | "other";

package/src/functions/crypto-js.d.ts

@@ -1,2 +0,0 @@
-export declare function encriptar(text: string): string;
-export declare function desencriptar(ciphertext: string): string;

package/src/functions/date.d.ts

@@ -1,3 +0,0 @@
-export declare function formatearFechaFormato(val: string, format?: string): string;
-export declare function formatearFecha(val: string, hora?: string): string | Date;
-export declare function formatearFechaCadena(fecha: string): Date;

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

@@ -1,97 +0,0 @@
-/**
- * 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/src/functions/email.d.ts

@@ -1,2 +0,0 @@
-export declare function maskEmail(email: string): string;
-export declare function isEmail(email: string): boolean;

package/src/functions/file.d.ts

@@ -1,10 +0,0 @@
-export declare function obtenerMimeType(nombreArchivo: string): string | null;
-export declare function sanitizarNombreArchivo(nombre: string, reemplazo?: string): string;
-export declare function getDataArchivoFromPath(value: string, conTimeStamp?: boolean): {
-    nombre: string;
-    extension?: string;
-    d?: any;
-    fechaSubida: any;
-};
-export declare function convertirBytes(valor: number, unidadSalida?: string | null, incluirUnidad?: boolean): string | number | null;
-export declare function downLoadFileStream(data: any, type: string, nombreArchivo?: string): void;

package/src/functions/forms.d.ts

@@ -1,23 +0,0 @@
-import { AbstractControl, FormControl, FormGroup } from '@angular/forms';
-import { BehaviorSubject } from 'rxjs';
-export declare function establecerQuitarRequired(formulario: FormGroup, establecer?: any[], quitar?: any[], camposDisabled?: string[] | 'todos'): void;
-export declare function getFormValidationErrors(form: FormGroup): {
-    control: string;
-    error: string;
-    value: any;
-}[];
-export declare function mensajesErrorFormControl(control: AbstractControl | null): string;
-export declare function toFormData<T extends Record<string, any>>(formValue: T): FormData;
-export declare function markAsTouchedWithoutEmitEvent(control: AbstractControl): void;
-export interface SetControlDesdeListaConfig<T, V = any> {
-    lista$: BehaviorSubject<T[]>;
-    formControl?: FormControl<V>;
-    formGroup?: FormGroup;
-    controlName?: string;
-    idProp?: keyof T;
-    idValor?: any;
-    selector?: (item: T) => V;
-    usarPrimeraOpcion?: boolean;
-}
-export declare function setControlDesdeLista<T, V = any>(config: SetControlDesdeListaConfig<T, V>): void;
-export declare function transformarFechasPorNombreDeCampo<T extends Record<string, any>>(formValue: T): T;

package/src/functions/http-client.d.ts

@@ -1,2 +0,0 @@
-import { HttpErrorResponse } from '@angular/common/http';
-export declare function mensajesDeError(error: HttpErrorResponse, toast?: boolean): void;

package/src/functions/index.d.ts

@@ -1,5 +0,0 @@
-/**
- * Generated bundle index. Do not edit.
- */
-/// <amd-module name="@jvsoft/utils/src/functions" />
-export * from './public-api';

package/src/functions/local-storage.d.ts

@@ -1,29 +0,0 @@
-export interface JwtTokenResponse {
-    access_token: string;
-    expires_in: number;
-    token_type: string;
-    user: any;
-}
-export interface DataSessionStorage {
-    tokenStringKey?: string;
-    changePasswordKey?: string;
-    logoUrl?: string;
-    logoLogin?: string;
-    backgroundLogin?: string;
-    favicon?: string;
-    darkMode?: string;
-    serverTimestamp?: string;
-    apiDataKey?: string;
-}
-export declare let localStorageKeys: DataSessionStorage;
-export declare function inicializarVariablesSessionStorage(datSesion: DataSessionStorage): void;
-export declare function setJwtTokenData(data: string): void;
-export declare function jwtTokenData(key?: string): JwtTokenResponse | null;
-export declare function jwtToken(key?: string): string;
-export declare function jwtTokenExpiracion(key?: string): number | null;
-export declare function jwtTokenExpiracionFaltante(): number;
-export declare function setCambiarPwd(accion?: boolean): void;
-export declare function getCambiarPwd(): boolean | null;
-export declare function delLocalStorage(keyElim?: string[]): void;
-export declare function getLocalStorage(key: string | undefined): string | null;
-export declare function setLocalStorage(key: string, value?: string): void;

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

@@ -1,21 +0,0 @@
-import { AbstractControl } from '@angular/forms';
-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;

package/src/functions/mat-form-controls/index.d.ts

@@ -1,2 +0,0 @@
-export * from './autocomplete';
-export declare function seleccionarTextoInput(event: any): void;

package/src/functions/number.d.ts

@@ -1,2 +0,0 @@
-export declare function roundToDecimal(number: number, decimal: number): number;
-export declare function numberToWords(num: number): string;

package/src/functions/object-transformation.d.ts

@@ -1,2 +0,0 @@
-export declare function objectPropertiesToType(formFields: Record<string, any>): Record<string, any>;
-export declare function objectPropertiesBoolean(formFields: Record<string, any>, retorno?: 'boolean' | 'bit'): Record<string, any>;

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

@@ -1,47 +0,0 @@
-export declare function deepMerge(source: any, target: any): any;
-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.
- *
- * @returns El elemento encontrado o undefined si no existe.
- */
-export declare function buscarPorCampo<T>(datosFn: {
-    items: T[];
-    campo: keyof T;
-    valor: any;
-    campoHijo?: string;
-}): T | undefined;
-export declare function sumarPropiedades(item: Record<string, any>, campos: string[]): number;
-export declare function esNumero(value: any): boolean;
-export declare function sumarObjetos(arrayObjetos: any[], campos: string[]): Record<string, number>;
-export declare function getUniqueValues(array: any[]): any[];
-export declare function getUniqueValuesByProperty<T>(objetos: T[], campo: string): T[];
-export declare function ordenarArray(array: any[], numeros?: boolean, sentido?: 'ASC' | 'DESC'): any[];
-export declare function ordenarPorPropiedad(objData: any, propiedad: string, /**@deprecated*/ numeros?: boolean): {
-    [x: string]: {};
-}[];
-export declare function ordenarPorPropiedades<T>(arr: T[], options: {
-    propiedades: (keyof T)[];
-    direcciones?: ('asc' | 'desc' | '')[];
-}): 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;
-/**
- * Retorna el valor máximo del campo especificado (incluso anidado) en un arreglo de objetos.
- *
- * @param data - Lista de objetos a procesar.
- * @param campo - Nombre del campo a evaluar, puede ser anidado (ej. "campo.orden").
- * @param incrementar - Si es true, retorna el valor máximo + 1. Por defecto es true.
- * @returns El valor máximo encontrado, posiblemente incrementado.
- */
-export declare function obtenerUltimoOrden(data: any[], campo: string, incrementar?: boolean): number;
-/**
- * Elimina una o varias columnas específicas (por índice) de una tabla representada como array de arrays.
- *
- * @param data - Array de filas (cada fila debe ser un array).
- * @param columnIndex - Índice o lista de índices de las columnas a eliminar.
- * @returns Nuevo array con las columnas eliminadas.
- */
-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[];

package/src/functions/public-api.d.ts

@@ -1,17 +0,0 @@
-export * from './mat-form-controls';
-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';
-export * from './http-client';
-export * from './local-storage';
-export * from './number';
-export * from './object-transformation';
-export * from './objects-arrays';
-export * from './string';
-export * from './sweetalert';
-export * from './utiles';

package/src/functions/string.d.ts

@@ -1,23 +0,0 @@
-export declare function generateRandomString(length: number): string;
-/**
- * Obtiene el host (hostname) de una URL o cadena host[:port].
- * Opcionalmente puede devolver también el puerto si está presente.
- *
- * - Acepta inputs como:
- *   'https://example.com/path', 'example.com:3000', 'localhost', 'http://[::1]:4200'
- * - Usa la API URL cuando es posible (más robusta) y cae a un regex de respaldo.
- *
- * @param url Cadena que representa una URL o host
- * @param options
- * @param options.includePort Si es true, incluye":puerto" cuando exista (por defecto false)
- * @param options.includeProtocol Incluye "http://" o "https://" según corresponda (por defecto false)
- */
-export declare function obtenerHostDesdeUrl(url: string | null | undefined, options?: {
-    includePort?: boolean;
-    includeProtocol?: boolean;
-}): string | null;
-/** @deprecated Alias compatible (deprecated) — preferir usar `obtenerHostDesdeUrl`. */
-export declare const extraerDominio: (url: string | null | undefined, options?: {
-    includePort?: boolean;
-    includeProtocol?: boolean;
-}) => string | null;

package/src/functions/sweetalert.d.ts

@@ -1,5 +0,0 @@
-import { SweetAlertOptions, SweetAlertResult } from 'sweetalert2';
-export declare function mensajeAlerta(tipo: 'success' | 'error' | 'info' | 'warning' | 'question', titulo: string, mensaje: string, opciones?: SweetAlertOptions): Promise<SweetAlertResult<any>>;
-export declare function mensajeTimer(tipo: 'success' | 'error' | 'info' | 'warning' | 'question', titulo: string, mensaje: string, milisegundos?: number, showLoading?: boolean, opciones?: SweetAlertOptions): Promise<SweetAlertResult<any>>;
-export declare function mensajeConfirmacion(tipo: 'success' | 'error' | 'info' | 'warning' | 'question', titulo: any, mensaje: any, opciones?: SweetAlertOptions): Promise<SweetAlertResult<Awaited<any>>>;
-export declare function mensajeToast(tipo: 'success' | 'error' | 'info' | 'warning' | 'question', titulo: string, mensaje: string, opciones?: SweetAlertOptions): Promise<SweetAlertResult<any>>;

package/src/functions/utiles.d.ts

@@ -1 +0,0 @@
-export declare function verificarRUC(ruc: string): boolean;

package/src/interfaces/datos.d.ts

@@ -1,4 +0,0 @@
-import { BehaviorSubject } from 'rxjs';
-export interface DataServidor {
-    [key: string]: BehaviorSubject<any>;
-}

package/src/interfaces/index.d.ts

@@ -1,5 +0,0 @@
-/**
- * Generated bundle index. Do not edit.
- */
-/// <amd-module name="@jvsoft/utils/src/interfaces" />
-export * from './public-api';

package/src/interfaces/public-api.d.ts

@@ -1 +0,0 @@
-export * from './datos';

package/src/pipes/data-en-lista.pipe.d.ts

@@ -1,8 +0,0 @@
-import { PipeTransform } from '@angular/core';
-import * as i0 from "@angular/core";
-export declare class DataEnListaPipe implements PipeTransform {
-    transform(coleccion: object[], idBuscar: string | string[], dato: any): any;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DataEnListaPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<DataEnListaPipe, "dataEnLista", true>;
-}
-export declare function dataEnLista(coleccion: object[], idBuscar: string | string[], dato: any): any;

package/src/pipes/date-diff-string.pipe.d.ts

@@ -1,17 +0,0 @@
-import { PipeTransform } from '@angular/core';
-import * as i0 from "@angular/core";
-export declare class DateDiffStringPipe implements PipeTransform {
-    transform(startingDate: Date, endingDate: Date): any;
-    separarMilisegundos(milisegundos: any): {
-        years: number;
-        months: number;
-        weeks: number;
-        days: number;
-        hours: number;
-        minutes: number;
-        seconds: number;
-    };
-    static ɵfac: i0.ɵɵFactoryDeclaration<DateDiffStringPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<DateDiffStringPipe, "dateDiffString", true>;
-}
-export declare function dateDiffString(startingDate: Date, endingDate: Date): any;

package/src/pipes/filtro.pipe.d.ts

@@ -1,18 +0,0 @@
-import { PipeTransform } from '@angular/core';
-import * as i0 from "@angular/core";
-interface OpcionesBusqueda {
-    texto: string;
-    longitudMinima?: number;
-    campo?: string | string[];
-    mostrarObligado?: MostrarObligado;
-}
-interface MostrarObligado {
-    campo: string;
-    items: any[];
-}
-export declare class FiltroPipe implements PipeTransform {
-    transform(items: any[], opcionesBusqueda: OpcionesBusqueda): any[];
-    static ɵfac: i0.ɵɵFactoryDeclaration<FiltroPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<FiltroPipe, "filtro", true>;
-}
-export {};

package/src/pipes/form-control-is-required.pipe.d.ts

@@ -1,9 +0,0 @@
-import { PipeTransform } from '@angular/core';
-import { AbstractControl } from '@angular/forms';
-import * as i0 from "@angular/core";
-export declare class FormControlIsRequiredPipe implements PipeTransform {
-    transform(formControl: AbstractControl, ...args: unknown[]): any;
-    static ɵfac: i0.ɵɵFactoryDeclaration<FormControlIsRequiredPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<FormControlIsRequiredPipe, "formControlIsRequired", true>;
-}
-export declare function formControlIsRequired(formControl: AbstractControl): any;

package/src/pipes/index.d.ts

@@ -1,5 +0,0 @@
-/**
- * Generated bundle index. Do not edit.
- */
-/// <amd-module name="@jvsoft/utils/src/pipes" />
-export * from './public-api';

package/src/pipes/json-parse.pipe.d.ts

@@ -1,7 +0,0 @@
-import { PipeTransform } from '@angular/core';
-import * as i0 from "@angular/core";
-export declare class JsonParsePipe implements PipeTransform {
-    transform(value: string, ...args: unknown[]): any;
-    static ɵfac: i0.ɵɵFactoryDeclaration<JsonParsePipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<JsonParsePipe, "jsonParse", true>;
-}

package/src/pipes/no-sanitize.pipe.d.ts

@@ -1,10 +0,0 @@
-import { PipeTransform } from '@angular/core';
-import { DomSanitizer, SafeHtml } from '@angular/platform-browser';
-import * as i0 from "@angular/core";
-export declare class NoSanitizePipe implements PipeTransform {
-    private domSanitizer;
-    constructor(domSanitizer: DomSanitizer);
-    transform(html: string): SafeHtml;
-    static ɵfac: i0.ɵɵFactoryDeclaration<NoSanitizePipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<NoSanitizePipe, "noSanitize", true>;
-}

package/src/pipes/public-api.d.ts

@@ -1,8 +0,0 @@
-export * from './data-en-lista.pipe';
-export * from './date-diff-string.pipe';
-export * from './filtro.pipe';
-export * from './form-control-is-required.pipe';
-export * from './json-parse.pipe';
-export * from './no-sanitize.pipe';
-export * from './tipo-valor-funcion.pipe';
-export * from './zero-fill.pipe';

package/src/pipes/tipo-valor-funcion.pipe.d.ts

@@ -1,9 +0,0 @@
-import { PipeTransform } from '@angular/core';
-import * as i0 from "@angular/core";
-export type TipoValorFuncion<T> = T | ((...param: any) => T);
-export declare class TipoValorFuncionPipe implements PipeTransform {
-    transform<T>(datoParam: TipoValorFuncion<T>, defaultValue?: T, ...param: any[]): T | undefined;
-    static ɵfac: i0.ɵɵFactoryDeclaration<TipoValorFuncionPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<TipoValorFuncionPipe, "tipoValorFuncion", true>;
-}
-export declare function tipoValorFuncion<T>(datoParam: TipoValorFuncion<T>, defaultValue?: T, ...param: any[]): T | undefined;

package/src/pipes/zero-fill.pipe.d.ts

@@ -1,8 +0,0 @@
-import { PipeTransform } from '@angular/core';
-import * as i0 from "@angular/core";
-export declare class ZeroFillPipe implements PipeTransform {
-    transform(value: unknown, digitos: number, ...args: unknown[]): string;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ZeroFillPipe, never>;
-    static ɵpipe: i0.ɵɵPipeDeclaration<ZeroFillPipe, "zeroFill", true>;
-}
-export declare function zeroFill(value: unknown, digitos: number, ...args: unknown[]): string;