# brazilian-utils/javascript

Utils library for specific Brazilian businesses

Repository: https://github.com/brazilian-utils/javascript
Canonical: https://ross.abutalabs.com/products/brazilian-utils-javascript
Homepage: https://brazilian-utils.com.br
Language: TypeScript
License: MIT
License Family: permissive
Topics: cpf, cnpj, brazilian, validator, mask, formatter, cep, boleto, phone, states, email, inscricao-estadual, pis, processo-juridico, validador, gerador, estados, generator, format, cumbucadev
Last push: 2026-07-14T13:53:43+00:00

## Health v2 (maintenance only)
Score: 89/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 92, release rhythm 78, longevity 100
- inputs: {"age_days": 3008, "days_push": 50, "days_rel": 146, "gap_med": 3.0, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1666, forks 130 (observed 2026-08-28T04:05:19.129067+00:00)

## What it is
A TypeScript/JavaScript utility library for validating, formatting, and generating Brazilian business identifiers such as CPF, CNPJ, CEP, boleto, phone numbers, and state registrations. It is distributed as an npm package and usable in both Node.js and browser environments.

## Use cases
- validate a Brazilian CPF number
- format CNPJ with mask
- generate valid CPF for testing
- validate CEP postal codes
- format Brazilian phone numbers
- validate inscricao estadual
- validate boleto bar codes

## When to choose
- building apps that handle Brazilian user data like CPF/CNPJ
- need both validation and formatting of Brazilian documents
- want a lightweight, well-tested npm library

## When to avoid
- need validation for non-Brazilian documents
- working outside JavaScript/TypeScript ecosystems

## Facets
- artifact type: library
- maturity: active
- function: form-handling, formatter, parser
- domain: developer-tools, web-development
- platform: browser
- tags: brazilian-documents, cpf, cnpj, cep, boleto, mask, validator, generator, localization, nodejs, javascript, typescript

## Member repositories
- brazilian-utils/javascript (main) score 89

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:19.129067+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:42:57.699036+00:00, confidence not recorded.
  - readme: https://github.com/brazilian-utils/javascript (fetched 2026-08-28T04:05:19.129067+00:00, sha 7cfccab94aa1)
  - homepage: https://brazilian-utils.com.br (fetched 2026-08-29T11:16:42.982690+00:00, sha f25c8469871c)
- Data as of 2026-08-30T08:39:29.467469+00:00.