@koalarx/utils NPM

@koalarx/utils

Biblioteca utilitária para validações, conversões e abstrações de problemas comuns em JavaScript/TypeScript.

Instalação

npm install @koalarx/utils

Funcionalidades

KlString

Classe para manipulação avançada de strings.

Métodos Disponíveis

normalizeAndRemoveSpecialChars: Remove caracteres especiais e normaliza a string.
removeSpaces: Remove espaços, substituindo-os por um delimitador.
clear: Remove espaços e caracteres especiais.
toCamelCase: Converte a string para camelCase.
unmaskCoin: Remove a máscara de moeda e converte para número.
maskCpf: Aplica a máscara de CPF.
maskCnpj: Aplica a máscara de CNPJ.
validateCpf: Valida se a string é um CPF válido.
validateCnpj: Valida se a string é um CNPJ válido.
onlyNumbers: Remove todos os caracteres não numéricos.
nbl2br: Substitui quebras de linha por <br/>.
toBase64: Converte a string para Base64.
random: Gera uma string aleatória.

Exemplos de Uso

import { KlString, maskCpf, toCamelCase } from "@koalarx/utils/KlString";

const str = new KlString("Olá Mundo!");
console.log(str.normalizeAndRemoveSpecialChars().toString()); // "Ola Mundo"
console.log(maskCpf("12345678909")); // "123.456.789-09"
console.log(toCamelCase("Olá Mundo")); // "olaMundo"

KlNumber

Classe para manipulação avançada de números.

Métodos Disponíveis

random: Gera um número aleatório entre dois valores.
maskCoin: Formata o número como moeda.

Exemplos de Uso

import { maskCoin, randomNumber } from "@koalarx/utils/KlNumber";

console.log(maskCoin(1000)); // "R$ 1.000,00"
console.log(randomNumber(1, 100)); // Exemplo: 42

KlDate

Classe para manipulação avançada de datas.

Métodos Disponíveis

format: Formata a data com base em uma máscara.
changeTimeZone: Altera o fuso horário da data.
toUTC: Converte a data para UTC.
add: Adiciona tempo à data.
sub: Subtrai tempo da data.
diff: Calcula a diferença entre duas datas.
isHoliday: Verifica se a data é um feriado.

Exemplos de Uso

import { KlDate, isHoliday } from "@koalarx/utils/KlDate";

const date = new KlDate("2023-10-01");
console.log(date.format("dd/MM/yyyy")); // "01/10/2023"
console.log(isHoliday(date, "BR")); // true ou false

KlTime

Classe para manipulação avançada de horários.

Métodos Disponíveis

format: Formata um horário com base em uma máscara.
changeTimeZone: Altera o fuso horário da data.
toUTC: Converte a data para UTC.
add: Adiciona tempo à data.
sub: Subtrai tempo da data.
diff: Calcula a diferença entre duas datas.

Exemplos de Uso

import { KlTime } from "@koalarx/utils/KlTime";

const date = new KlTime(13);
console.log(date.format()); // "13:00:00"

KlArray

Classe para manipulação avançada de arrays.

Métodos Disponíveis

clearEmptyValues: Remove valores "falsy" do array.
split: Divide o array em subarrays.
orderBy: Ordena o array por uma propriedade.
shuffle: Embaralha os elementos do array.

Exemplos de Uso

import { KlArray } from "@koalarx/utils/KlArray";

const array = new KlArray([1, 2, 3, 4]);
console.log(array.split(2)); // [[1, 2], [3, 4]]
console.log(array.shuffle()); // Exemplo: [3, 1, 4, 2]

KlDelay

Classe para criar atrasos no código.

Métodos Disponíveis

waitFor: Aguarda um período de tempo especificado.

Exemplos de Uso

import { delay } from "@koalarx/utils/KlDelay";

await delay(1000);
console.log("Aguardou 1 segundo");

KlCron

Classe para medir a duração de execuções.

Métodos Disponíveis

start: Inicia o cronômetro.
end: Finaliza o cronômetro.
duration: Calcula a duração entre o início e o fim.

Exemplos de Uso

import { KlCron } from "@koalarx/utils/KlCron";

const cron = new KlCron();
cron.start();
// ... código a ser medido ...
cron.end();
console.log(cron.duration()); // Duração em segundos