npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2025 – Pkg Stats / Ryan Hefner

@firestormapps/utils

v1.4.0

Published

Utilities belt written in TypeScript

Downloads

28

Readme

Firestorm Apps - Utils

Cinto de utilidades da Firestorm Apps escrito em TypeScript


NOTA:

  1. Essa biblioteca expoe algumas funções diretamente do projeto brazilian-utils (versão atual ^1.0.0-rc.12).

As seguintes funções do brazilian-utils são expostas:

  • isValidBoleto
  • formatBoleto
  • isValidCEP
  • formatCEP
  • isValidCNPJ
  • formatCNPJ
  • isValidCPF
  • formatCPF
  • isValidPIS
  • isValidEmail
  1. Essa biblioteca expoe algumas funções diretamente do projeto creditcard.js (versão atual ^3.0.10).

As seguintes funções do creditcard.js são expostas:

  • isValid,
  • isExpirationDateValid,
  • isSecurityCodeValid,
  • getCreditCardNameByNumber,

Menu

Instalação

npm i @firestormapps/utils

ou

yarn add @firestormapps/utils

Helpers

Boleto

isValidBoleto

Retorna um boolean se o número de boleto informado é válido ou não.


import { isValidBoleto } from '@firestormapps/utils';

isValidBoleto('00190000090114971860168524522114675860000102656'); // true

formatBoleto

Adiciona a máscara com pontuação ao número de boleto informado.


import { formatBoleto } from '@firestormapps/utils';

formatBoleto('00190000090114971860168524522114675860000102656');

Strings

capitalize

Torna maiúscula apenas a primeira letra de cada palavra da frase informada.

import { capitalize } from '@firestormapps/utils';

capitalize("Apenas pra gente TESTAR"); // Apenas Pra Gente Testar

getNameInitials

Retorna uma string com as letras iniciais do nome informado

import { getNameInitials } from '@firestormapps/utils';

getNameInitials('Bora testar'); // BT

removeSpaces

Retorna uma string sem nenhum espaço ("/\ /")

import { removeSpaces } from '@firestormapps/utils';

removeSpaces('Bora testar'); // Boratestar

CEP

isValidCEP

Retorna um boolean se o CEP informado é válido ou não.

import { isValidCEP } from '@firestormapps/utils';

isValidCEP('92500000'); // true

formatCEP

Adicionar máscara ao número de CEP informado.

import { formatCEP } from '@firestormapps/utils';

formatCEP('92500000'); // 92500-000

CNPJ

isValidCNPJ

Retorna um boolean se o CNPJ informado é válido ou não.

import { isValidCNPJ } from '@firestormapps/utils';

isValidCNPJ('15515147234255'); // true/false

formatCNPJ

Adicionar máscara ao número de CNPJ informado.

import { formatCNPJ } from '@firestormapps/utils';

formatCNPJ('245222000174'); // 24.522.200/0174

validateCNPJ

Retorna um boolean se o CNPJ informado é válido ou não.

import { validateCNPJ } from '@firestormapps/utils';

validateCNPJ('17702663000150'); // true/false

maskCNPJ

Adicionar máscara ao número de CNPJ informado.

import { maskCNPJ } from '@firestormapps/utils';

maskCNPJ('17702663000150'); // 17.702.663/0001-50

unmaskCNPJ

Remove a máscara do número de CNPJ informado, retornando apenas os números.

import { unmaskCNPJ } from '@firestormapps/utils';

unmaskCNPJ('17.702.663/0001-50'); // 17702663000150

CPF

isValidCPF

Retorna um boolean se o CPF informado é válido ou não.

import { isValidCPF } from '@firestormapps/utils';

isValidCPF('155151475'); // true/false

formatCPF

Adicionar máscara ao número de CPF informado.

import { formatCPF } from '@firestormapps/utils';

formatCPF('746506880'); // 746.506.880

maskCPF

Adicionar máscara ao número de CPF informado.

import { maskCPF } from '@firestormapps/utils';

maskCPF('28832326280'); // 288.323.262-80

unmaskCPF

Remove a máscara do número de CPF informado, retornando apenas os números.

import { unmaskCPF } from '@firestormapps/utils';

unmaskCPF('288.323.262-80'); // 28832326280

validateCPF

Retorna um boolean se o CPF informado é válido ou não.

import { validateCPF } from '@firestormapps/utils';

validateCPF('03455455787'); // true/false

Cartão de Crédito

validateCreditCardNumber

Retorna um boolean se o número de cartão de crédito informado é válido ou não.

import { validateCreditCardNumber } from '@firestormapps/utils';

validateCreditCardNumber('5598928852411791'); // true/false

validateCreditCardExpiration

Retorna um boolean se a data de expiração do cartão de crédito informado é válido ou não.

import { validateCreditCardExpiration } from '@firestormapps/utils';

validateCreditCardExpiration('12/22'); // true/false

getCardBrand

Retorna uma string com a bandeira do cartão através do número informado (cardNumber). Os possíveis retornos são:

  • Elo,
  • HiperCard,
  • Visa,
  • MasterCard,
  • JCB,
  • Diners Club,
  • Discover,
  • American Express.
import { getCardBrand } from '@firestormapps/utils';

getCardBrand('5284929298198314'); 

/*
retorna: "MasterCard"
*/

getCreditCardInfo

Retorna um object com informações sobre o número de cartão de crédito informado.

import { getCreditCardInfo } from '@firestormapps/utils';

getCreditCardInfo('5485775006283622'); 

/*
retorna:

{
    card: {
      niceType: 'Mastercard',
      type: 'mastercard',
    },
    isValid: false,
  };
*/

creditcard.js utils

As funções expostas da lib creditcard.js podem ser usadas da seguinte maneira

import { 
    isValid, 
    isExpirationDateValid, 
    isSecurityCodeValid, 
    getCreditCardNameByNumber 
  } from '@firestormapps/utils';
  
  isValid('4916108926268679'); // returns true
  isExpirationDateValid('02', '2027'); // returns true
  isSecurityCodeValid('4556603578296676', '250'); // returns true
  getCreditCardNameByNumber('4539578763621486'); // returns 'Visa'

E-mail

isValidEmail

Retorna um boolean se o CPF informado é válido ou não.

import { isValidEmail } from '@firestormapps/utils';

isValidEmail('john.doe@hotmail.com'); // true

Telefone

validatePhone

Retorna um boolean se o número de telefone informado é válido ou não.

import { validatePhone } from '@firestormapps/utils';

validatePhone('(11) 99989-8887'); // true/false

maskPhone

Adicionar máscara ao número de telefone informado.

import { maskPhone } from '@firestormapps/utils';

maskPhone('11999898887'); // (11) 99989-8887

unmaskPhone

Remove a máscara do número de telefone informado, retornando apenas os números.

import { unmaskPhone } from '@firestormapps/utils';

unmaskPhone('(11) 99989-8887'); // 11999898887

PIS

isValidPIS

Retorna um boolean se o CPF informado é válido ou não.

import { isValidPIS } from '@firestormapps/utils';

isValidPIS('12056412547'); // true/false