hp3

Una colección de funciones utilitarias modernas y livianas para JavaScript. Hecha para simplificar tareas comunes de validación, transformación y manipulación de datos.

🚀 Instalación

npm install hp3

o usando Yarn:

yarn add hp3

🧩 ¿Qué incluye?

hp3 proporciona funciones listas para usar en validaciones, chequeos de tipo, transformaciones seguras y manejo de estructuras complejas como objetos y arreglos.

✅ Validaciones Generales (src/type.mjs)

| Función | Descripción breve | | --------------------- | ------------------------------------------------------------------------------------------------------------------ | | is_blank(value) | Devuelve true si el valor es null, una cadena vacía, un iterable vacío, o se considera vacío según is_empty. | | is_filled(value) | Devuelve true si el valor no es "en blanco" (lo opuesto a is_blank). | | is_undefined(value) | Devuelve true si el valor es estrictamente undefined. | | is_empty(value) | Devuelve true si el valor es undefined, null, una cadena vacía, un array vacío o un objeto sin propiedades. | | is_null(value) | Devuelve true si el valor es exactamente null. | | is_string(value) | Devuelve true si el valor es una cadena (typeof === "string" o instancia de String). | | is_numeric(value) | Devuelve true si el valor puede ser interpretado como un número (ej: "123" o 42). | | is_number(value) | Devuelve true si el valor es estrictamente del tipo number. | | is_bool(value) | Devuelve true si el valor es un booleano (true o false). | | is_symbol(value) | Devuelve true si el valor es un symbol. | | is_bigint(value) | Devuelve true si el valor es de tipo bigint. | | is_object(value) | Devuelve true si el valor es un objeto y no es null. | | is_function(value) | Devuelve true si el valor es una función. | | is_array(value) | Devuelve true si el valor es un array (Array.isArray). | | is_iterable(value) | Devuelve true si el valor tiene Symbol.iterator (por ejemplo, strings, arrays, Maps, Sets). | | is_date(value) | Devuelve true si el valor es una instancia de Date. | | is_regexp(value) | Devuelve true si el valor es una expresión regular (RegExp). | | is_promise(value) | Devuelve true si el valor es una promesa (tiene métodos .then() y .catch()). | | is_error(value) | Devuelve true si el valor es una instancia de Error. | | is(value, type) | Verifica si el valor coincide con un tipo dado (typeof, instanceof, o un array de tipos). |

💡 Condiciones Expresivas (src/conditions.mjs)

| Función | Descripción breve | | ------------------ | ------------------------------------------------------------------------------------------------ | | if_blank | Devuelve trueValue si value está en blanco según is_blank, si no, devuelve value. | | if_not_blank | Devuelve trueValue si value no está en blanco, si no, devuelve value. | | if_filled | Devuelve trueValue si value está lleno (no en blanco), si no, devuelve value. | | if_not_filled | Devuelve trueValue si value no está lleno, si no, devuelve value. | | if_undefined | Devuelve trueValue si value es undefined, si no, devuelve value. | | if_not_undefined | Devuelve trueValue si value no es undefined, si no, devuelve value. | | if_empty | Devuelve trueValue si value está vacío según is_empty, si no, devuelve value. | | if_not_empty | Devuelve trueValue si value no está vacío, si no, devuelve value. | | if_null | Devuelve trueValue si value es null, si no, devuelve value. | | if_not_null | Devuelve trueValue si value no es null, si no, devuelve value. | | if_string | Devuelve trueValue si value es una cadena, si no, devuelve value. | | if_not_string | Devuelve trueValue si value no es una cadena, si no, devuelve value. | | if_numeric | Devuelve trueValue si value es numérico, si no, devuelve value. | | if_not_numeric | Devuelve trueValue si value no es numérico, si no, devuelve value. | | if_number | Devuelve trueValue si value es un número (typeof === "number"), si no, devuelve value. | | if_not_number | Devuelve trueValue si value no es un número, si no, devuelve value. | | if_bool | Devuelve trueValue si value es booleano, si no, devuelve value. | | if_not_bool | Devuelve trueValue si value no es booleano, si no, devuelve value. | | if_symbol | Devuelve trueValue si value es un símbolo, si no, devuelve value. | | if_not_symbol | Devuelve trueValue si value no es un símbolo, si no, devuelve value. | | if_bigint | Devuelve trueValue si value es un bigint, si no, devuelve value. | | if_not_bigint | Devuelve trueValue si value no es un bigint, si no, devuelve value. | | if_object | Devuelve trueValue si value es un objeto, si no, devuelve value. | | if_not_object | Devuelve trueValue si value no es un objeto, si no, devuelve value. | | if_function | Devuelve trueValue si value es una función, si no, devuelve value. | | if_not_function | Devuelve trueValue si value no es una función, si no, devuelve value. | | if_array | Devuelve trueValue si value es un array, si no, devuelve value. | | if_not_array | Devuelve trueValue si value no es un array, si no, devuelve value. | | if_iterable | Devuelve trueValue si value es iterable (como array, string, etc.), si no, devuelve value. | | if_not_iterable | Devuelve trueValue si value no es iterable, si no, devuelve value. | | if_date | Devuelve trueValue si value es una instancia de Date, si no, devuelve value. | | if_not_date | Devuelve trueValue si value no es una instancia de Date, si no, devuelve value. | | if_regexp | Devuelve trueValue si value es una expresión regular (RegExp), si no, devuelve value. | | if_not_regexp | Devuelve trueValue si value no es una expresión regular, si no, devuelve value. | | if_promise | Devuelve trueValue si value es una promesa (Promise), si no, devuelve value. | | if_not_promise | Devuelve trueValue si value no es una promesa, si no, devuelve value. | | if_error | Devuelve trueValue si value es una instancia de Error, si no, devuelve value. | | if_not_error | Devuelve trueValue si value no es un error, si no, devuelve value. |

🧱 Manipulación de Objetos (src/object.mjs)

| Función | Descripción breve | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | object_get | Obtiene el valor de una propiedad anidada usando notación de punto ("a.b.c"). Devuelve un valor por defecto si no existe la ruta. | | object_set | Establece el valor de una propiedad anidada usando notación de punto. Crea la estructura si es necesario y soporta el comodín "*" para asignación masiva. | | object_has | Verifica si una ruta existe dentro de un objeto utilizando notación de punto. | | object_unset | Elimina una propiedad anidada de un objeto utilizando notación de punto. |

🛠️ Utilidades (src/utilities.mjs)

| Función | Descripción breve | | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | value | Devuelve el valor evaluado: si es una función, la ejecuta con los argumentos dados; si no, lo devuelve tal cual. | | transform | Aplica una función (callback) a un valor si está "relleno" (is_filled); de lo contrario, devuelve un valor por defecto (que también puede ser una función). | | first | Devuelve el primer elemento de una colección iterable con índice (como un array o string). Retorna undefined si no es iterable. | | last | Devuelve el último elemento de una colección iterable que tenga .slice(). Retorna undefined si no aplica. |

📦 Ejemplos de Uso

import { is_blank, transform, object_get, object_set } from 'hp3';

console.log(is_blank("   ")); // true
console.log(is_blank(42));    // false

const user = {
  profile: {
    name: "Antonio"
  }
};

console.log(object_get(user, "profile.name")); // "Antonio"
console.log(object_get(user, "profile.age", 30)); // 30

const updated = object_set(user, "profile.age", 35);
console.log(updated.profile.age); // 35

console.log(transform("dato", v => v.toUpperCase(), "VACÍO")); // "DATO"
console.log(transform("", v => v.toUpperCase(), "VACÍO"));     // "VACÍO"

📚 Documentación

Todas las funciones están documentadas usando JSDoc. Puedes revisar directamente el código fuente o generar documentación si lo necesitas.

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Puedes abrir un issue con una sugerencia o enviar un pull request.

📄 Licencia

MIT License / Licencia MIT

Copyright (c) 2025 hgjfkdls

>> LICENSE