# brazilian-utils/javascript

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/brazilian-utils-javascript).**

1,664 stars · 126 forks · TypeScript · MIT

## Links

- GitHub: https://github.com/brazilian-utils/javascript
- Homepage: https://brazilian-utils.com.br
- awesome-repositories: https://awesome-repositories.com/repository/brazilian-utils-javascript.md

## Topics

`boleto` `brazilian` `cep` `cnpj` `cpf` `cumbucadev` `email` `estados` `format` `formatter` `generator` `gerador` `inscricao-estadual` `mask` `phone` `pis` `processo-juridico` `states` `validador` `validator`

## Description

This library provides a collection of utilities for processing, validating, and formatting Brazilian personal data and national identifiers. It serves as a toolkit for managing common data formats within the Brazilian ecosystem, ensuring that information such as tax identification numbers, phone numbers, and postal codes conform to official standards.

The project distinguishes itself by combining mathematical checksum verification with structural pattern matching to ensure data integrity. It includes specialized functions for generating synthetic, valid identification numbers for testing environments, as well as utilities for masking sensitive information to support privacy requirements in user interfaces.

Beyond core identification tasks, the library offers a suite of data processing tools that handle string normalization and consistent formatting. These functions are organized to allow for modular composition, enabling developers to integrate validation and transformation logic into their applications. The package is available as a JavaScript and TypeScript utility library.

## Tags

### Data & Databases

- [Brazilian Data Validation Libraries](https://awesome-repositories.com/f/data-databases/brazilian-data-validation-libraries.md) — Provides a comprehensive toolkit for validating, formatting, and generating Brazilian personal data and national identifiers.
- [Identification Number Validation](https://awesome-repositories.com/f/data-databases/data-validation/number-type-validation/identification-number-validation.md) — Validates the structural integrity and mathematical validity of Brazilian national identification and tax documents.

### Testing & Quality Assurance

- [Luhn Checksum Validators](https://awesome-repositories.com/f/testing-quality-assurance/validation-verification/input-validation/algorithmic-validation-tools/luhn-checksum-validators.md) — Implements mathematical checksum validation algorithms to verify the authenticity of Brazilian national identification documents.

### User Interface & Experience

- [Brazilian Formatters](https://awesome-repositories.com/f/user-interface-experience/phone-number-formatting/brazilian-formatters.md) — Standardizes Brazilian phone numbers, postal codes, and identification documents into consistent display formats.

### Development Tools & Productivity

- [Deterministic Generators](https://awesome-repositories.com/f/development-tools-productivity/random-identifier-generators/deterministic-generators.md) — Provides deterministic generation of valid Brazilian identification numbers for testing and development environments.

### Programming Languages & Runtimes

- [Test Data Generators](https://awesome-repositories.com/f/programming-languages-runtimes/language-features-paradigms/language-features/core-conceptual-frameworks/programming-language-concepts/random-number-generation/random-number-generators/random-data-generators/test-data-generators.md) — Generates valid, randomized Brazilian tax IDs and document numbers for testing and development purposes.

### Security & Cryptography

- [String Masking Utilities](https://awesome-repositories.com/f/security-cryptography/sensitive-data-access-controls/data-masking/string-masking-utilities.md) — Provides utilities for masking sensitive Brazilian personal data to support privacy requirements in user interfaces.

### Software Engineering & Architecture

- [String Validation and Normalization](https://awesome-repositories.com/f/software-engineering-architecture/string-validation-and-normalization.md) — Normalizes raw input strings by stripping non-numeric characters to ensure consistent data representation.