2.5.0 (2026-10-03)

Features

• area-codes: add getMunicipalitiesByAreaCode and getAreaCodeByMunicipalityCode (538f915)
• cbo: add formatCbo (c26888c)
• cest: add isValidCest, formatCest, parseCest and getCest (32e2aff)
• cfop: add formatCfop (ae2a308)
• cid10: add isValidCid10, getCid10, formatCid10 and parseCid10 (495a0a8)
• isbn: add isValidIsbn, parseIsbn, getIsbnInfo and formatIsbn (1a50bcc)
• license-plate: let isValidLicensePlate take the format to accept (3dec90d)
• municipalities: add getCodeByMunicipalityName (c69befc)
• nbs: add parseNbs (6fe8ca1)
• nbs: add the pad option to formatNbs (dc85223)
• processo-juridico: add getProcessoJuridicoInfo (3640237)
• registro-profissional: accept the CRO number form of art. 115 of the CFO norms (e60fe5a)
• states: add getStateCapital, getRegions and getStatesByRegion (6e62985)
• voter-id: add getVoterIdInfo (16d51e8)

Bug Fixes

• area-codes: read codes by their digits, as getAreaCodeInfo and getMunicipalityByCode do (feeabca)
• boleto: accept only the código de moeda 9 and the 988 layout, and generate dated factors (035a04e)
• boleto: accept the 44 digit cobranca bancaria barcode (7334fba)
• boleto: ignore an invalid referenceDate in getBoletoInfo (07a5780)
• boleto: read a number only when it is a non-negative safe integer (c67c1ba)
• boleto: reject letters and stray characters in isValidBoleto (e1a9b4d)
• caepf: read a number only when it is a non-negative safe integer (a99fe3d)
• caepf: reject negative and fractional numbers (6fc9a90)
• capitalize: keep every roman numeral up to XXXIX upper case, not just to XXIII (0c419d5)
• capitalize: keep more prepositions and S.A in the right case, scan linearly (e936f51)
• capitalize: write the UF of a "Cidade - UF" address in upper case (526a27a)
• cbo: build the table from the MTE's current release, kept in the repository (cac077f)
• cbo: read a number only when it is a non-negative safe integer (3ff37bb)
• cei,cno: reject negative and fractional numbers (801f2f9)
• cei: read a number only when it is a non-negative safe integer (88f5bda)
• cep: read a number only when it is a non-negative safe integer (040b530)
• cep: reject negative and fractional numbers (97969c0)
• certidao: read a number only when it is a non-negative safe integer (90592af)
• cest: read a number only when it is a non-negative safe integer (4ae9a5d)
• cfop: read a number only when it is a non-negative safe integer (a590084)
• cid10: add the U07 codes of the DATASUS SIM table the V2008 files lack (196985e)
• classifications: read null options as none in isValidCst and isValidClassTrib (840604f)
• cnae: read a number only when it is a non-negative safe integer (72a5de6)
• cnh: read a number only when it is a non-negative safe integer (3215bb6)
• cno: read a number only when it is a non-negative safe integer (d19ad28)
• cnpj: never generate the número de ordem 0000, which is never assigned (6e0dee4)
• cnpj: read a number only when it is a non-negative safe integer (b6563f3)
• cns: read a number only when it is a non-negative safe integer (8592439)
• cns: reject negative and fractional numbers (29b5a18)
• convert-number-to-words: export NumberToWordsGender from the subpath entry (7fbabbf)
• cpf: read a number only when it is a non-negative safe integer (e484f4e)
• cst: accept the bare 2 digit Tabela B codes for tax icms (f2f1aff)
• email: cap the address length and accept a punycode final label (aafdabd)
• format: return an empty string when the value has no digits, even with pad (960d9bb)
• generate-cep: draw the CEP inside the ranges the states own (54bb018)
• get-address-info-by-cep: abort the providers that lost the race (df8b01d)
• get-address-info-by-cep: read a provider CEP without its leading zero as the same CEP (b32ce6c)
• get-address-info-by-cep: reject an address that contradicts the CEP (17f121f)
• get-address-info-by-cep: validate like isValidCep, add timeoutMs and signal (c3f3a7f)
• get-cep-info-by-address: validate the city and street before the request (9ff2296)
• get-holidays: drop the AM and PR optional days no state norm declares (c919097)
• get-holidays: list Acre's Dia do Católico and name both transfer exceptions (567978d)
• get-holidays: list Alagoas' 20 November from 1995 to 2023 under Lei ...

2.4.0 (2026-09-17)

Features

• area-code: add getAreaCodeInfo and getAreaCodesByState (748d9b8)
• area-code: list every state a DDD serves (42, 47, 49 and 61 span two states) (e17e55a)
• banks: add getBanks, getBankByCode and getBankByIspb; validate every Bacen bank account (ac2e84d)
• boleto: support boleto de arrecadação and a referenceDate option (6bde780)
• business-days: add isBusinessDay, addBusinessDays and differenceInBusinessDays (2b78c29)
• business-days: follow the date-fns signatures and add subBusinessDays (688359f)
• capitalize: keep company designations, roman numerals and state codes upper case by default (b6cb522)
• cbo: add getCbo and isValidCbo (a59ffbd)
• cei-cno-caepf: add isValidCei, formatCei, isValidCno, formatCno, isValidCaepf and formatCaepf (fda26b0)
• cep: declare the unidade, estado and regiao fields of the ViaCEP response (811cb10)
• certidao: add formatCertidao, isValidCertidao and parseCertidao (db5a602)
• cfop: add getCfop and isValidCfop (853202b)
• cnae,ncm: add the pad option to formatCnae and formatNcm (09408b1)
• cnae: add formatCnae, getCnae and isValidCnae (2defadd)
• cnpj: accept a branch number in generateCnpj (33e27be)
• cnpj: add an obfuscate option to formatCnpj (65c118c)
• cns: add isValidCns and formatCns (d054ce6)
• cpf: add an obfuscate option to formatCpf (b6150ab)
• credit-card: add isValidCreditCard (5c74b88)
• cst: add isValidCst and isValidCsosn (536eec5)
• currency-to-words: add convertCurrencyToWords (e24e446)
• date-to-words: add convertDateToWords (b9b3a63)
• export public types from the package root (6c67309)
• format: mask the new formatters progressively like formatCpf and add pad to formatLegalNature (e676688)
• iban: add formatIban, isValidIban and parseIban (31d3cb4)
• legal-nature: add getLegalNature (1abbd8c)
• legal-nature: expose the CONCLA category and add getLegalNaturesByCategory (defbdf8)
• legal-nature: mark the eight retired codes as legacy with their current code (bb52cda)
• municipality: add getMunicipalities and getMunicipalityByCode (offline IBGE data) (bed7b3f)
• municipality: add overloaded return types to getMunicipality (2687731)
• ncm: add formatNcm and isValidNcm (80f50d1)
• nfe-key: accept every 44-digit DF-e model, the SVC-SP emission and the XML id prefixes (60fcb46)
• nfe-key: accept the CT-e OS model 67 (fe9e30f)
• nfe-key: add formatNfeKey, isValidNfeKey and parseNfeKey (d639a7a)
• number-to-words: add convertNumberToWords (3a54ca0)
• parse: add the mask-stripping parse function of every new family (c2dfcfa)
• phone: accept 7 and 8 as mobile first digits under version 2 (af21b77)
• phone: add isValidServicePhone and an accept/auto-mask upgrade to isValidPhone/formatPhone (82df2d9)
• pix: add generatePixPayload, isValidPixPayload, isValidPixKey, parsePixPayload and parsePixKey (088861e)
• registro-profissional: add isValidRegistroProfissional (263c6ff)
• remove-accents: add removeAccents (18ff45e)
• renavam: add generateRenavam (e46aa21)
• states: add getStateByIbgeCode, getStateCodeByName, getStateNameByCode and getTimezoneByState (cc3ce8a)
• states: tie the name, region and IBGE code of State to its code (d8326f0)
• types: export the public types from the subpath entries (6f2b2e8)
• vin: add isValidVin (9d6c762)
• voter-id: support 13-digit São Paulo/Minas Gerais voter ids (9a3c4c4)

Bug Fixes

• account for FEBRABAN'"'"'s 22/02/2025 fator de vencimento cycle reset. (6bde780)
• adjust build error and update deps (40e0d85)
• api: align the new utils with the library conventions (58d561b)
• area-codes: return regionName and regionCode from getAreaCodeInfo, as State does (72856eb)
• bank-account: accept only P for a Bradesco remainder of 1 and drop the extinct bank 746 (e476a92)
• banks: follow the Bacen STR participants CSV to its new address and repoint dead sources (e5b8f9b)
• boleto: keep the fator de vencimento inside the first cycle for an early reference date (ee2f02b)
• business-days: return false from isBusinessDay for a non-string state code (03e5c11)
• caepf: reject a repeated base like CEI and CNO do (f7eb3bb)
• capitalize: keep the English possessive, single-letter designators and a pronoun me low ([7565d3d](7565d3de2e571d1c986d0e0eaf...

• feat: implement some extra utils (ba7ee79)

• feat: add passport utils (fae1472)
• chore: migrate to vite+ (8eb5d52)

• feat: add missing parse functions (d76c36e)

1.0.0-rc.12 (2020-10-27)

Features

• licenseplate: add a validador for brazilian and mercosul license plates (580d961), closes #112

1.0.0-rc.11 (2020-08-25)

Bug Fixes

• esm filename in package.json (32cd815)
• let formatCurrency() more flexible and remove default param from parseCurrency() (8a9a437)
• deps: upgrade devDependency to fix security warning (af7c353)
• replace array.flat with reduce to support node 10 (a47a51a)
• workflow: update workflow config (fb449c0)

Features

• add formatCurrency() and parseCurrency() (b0e6994)

1.0.0-rc.10 (2020-07-27)

Bug Fixes

• exported the function "capitalize()" to the public API (a16d603)

Features

• add function capitalize() (6d915fd)
• atualiza cidades novas (348ab84)

1.0.0-rc.9 (2020-07-09)

Bug Fixes

• applied code review (48a81f1)
• solve all Codecov issues (3394479)

Features

• add functions isValidLandlinePhone() and isValidMobilePhone() (e8fe8bd)

1.0.0-rc.8 (2020-06-17)

Bug Fixes

• add getCities to api public testes (3f8c4be)
• adjust docs typo (89cf335)
• adjust responsive docs (bafcdc0)
• export getCities (0472144)
• update-cities script command (bce5628)

Features

• add utility getCities (ebb949d)
• black lives matters (cce58d8)
• change the way the cities are filtered. Add docs (7f4ca6d)