h7-validate-cnpj
v1.0.3
Published
A TypeScript library to validate Brazilian CNPJ. It ensures valid structure, verifies check digits, and handles known invalid patterns.
Downloads
50
Maintainers
Readme
H7 Verify CNPJ
H7 Verify CNPJ is a TypeScript library designed to validate Brazilian CNPJs. It ensures that the CNPJ is correctly formatted, checks for repeated digits (e.g., 11.111.111/0001-11), validates the number of digits, and confirms whether the CNPJ is valid or not.
💖 Support This Project / Apoie Este Projeto
If this project has been helpful to you, please consider making a donation to support its ongoing development. Maintaining and improving this package takes time and effort, and your contribution helps ensure we can keep delivering quality solutions to the community.
Se este projeto foi útil para você, considere fazer uma doação para apoiar seu desenvolvimento contínuo. Manter este pacote atualizado e funcional exige tempo e esforço. Sua contribuição ajuda a garantir que possamos continuar fornecendo soluções de qualidade para a comunidade.
Even a small contribution makes a big difference. Thank you for helping make this project possible!
Mesmo uma pequena contribuição faz uma grande diferença. Obrigado por ajudar a tornar este projeto possível! 🙏
Why donate? / Por que doar?
✅ To help develop new features.
Para ajudar no desenvolvimento de novos recursos.
✅ To maintain compatibility with the latest versions of libraries and tools.
Para manter a compatibilidade com as últimas versões de bibliotecas e ferramentas.
✅ To support a developer who values community contributions.
Para apoiar um desenvolvedor que acredita na contribuição com a comunidade.
📦 Installation
To install the library, use the following command:
npm install h7-validate-cnpj
🚀 Usage
Here's how to use the VerifyCPF class to validate a CPF:
import { VerifyCNPJ } from "h7-validate-cnpj";
const verifyCNPJ = new VerifyCNPJ();
console.log(verifyCNPJ.verifyCNPJ("12345678000195"));
console.log(verifyCNPJ.verifyCNPJ("11111111000111"));
📖 Features
- Validates CNPJs: Checks if the provided CNPJ is correct.
- Rejects repeated digits: Detects invalid CNPJs with all digits the same (e.g., 11.111.111/0001-11).
- TypeScript support: Fully typed and compatible with TypeScript projects.
- Lightweight: A simple and efficient library with no dependencies.
🛠️ How it Works
This library verifies CNPJs by:
- Removing all non-numeric characters.
- Calculating the two verification digits based on the CNPJ algorithm.
- Comparing the calculated verification digits with the input to determine validity.
📜 Example Use Case
Imagine an application where users must provide a valid CNPJ for authentication or registration. Using this library, you can ensure that only valid CNPJs are accepted:
import { VerifyCNPJ } from "h7-validate-cnpj";
const cnpj = "12345678000195";
const verifyCNPJ = new VerifyCNPJ();
if (verifyCNPJ.verifyCNPJ(cnpj)) {
console.log("O CNPJ é válido.");
} else {
console.log("CNPJ inválido. Por favor, verifique e tente novamente.");
}
🤝 Contributing
Feel free to contribute to this project by opening issues or submitting pull requests. All contributions are welcome!
👨💻 Author
Developed by Herlandio. If you find this library helpful, consider starring the repository on GitHub!
📝 License
This project is licensed under the MIT License. You are free to use, modify, and distribute it as long as you provide proper attribution.