brazilian-fake-data-generator

A small, zero-dependency JavaScript library for generating fictitious Brazilian data for tests, QA, automation, development, staging environments, and product demos.

All generated values are intended exclusively for testing and development. They are not sourced from real records and must not be used as real personal, company, or address data.

Features

• Generate valid formatted CPF numbers
• Generate valid formatted CNPJ numbers
• Generate Brazilian-style fictitious person names
• Generate Brazilian-style fictitious company names
• Generate reserved-domain fake email addresses
• Generate Brazilian-style mobile phone numbers
• Generate fictitious Brazilian addresses
• Generate complete person and company objects
• Pure JavaScript with ES Modules
• No external dependencies
• Node.js 18 or newer
• TypeScript definitions included

Installation

npm install brazilian-fake-data-generator

If the package is not published yet, clone the repository and import it locally.

Usage

import {
  generateCPF,
  generatePerson,
  generateCompany
} from 'brazilian-fake-data-generator';

console.log(generateCPF());
console.log(generatePerson());
console.log(generateCompany());

Examples

import {
  generateAddress,
  generateCNPJ,
  generateCPF,
  generateCompany,
  generateCompanyName,
  generateEmail,
  generatePerson,
  generatePersonName,
  generatePhone
} from 'brazilian-fake-data-generator';

console.log(generateCPF());
console.log(generateCNPJ());
console.log(generatePersonName());
console.log(generateCompanyName());
console.log(generateEmail());
console.log(generatePhone());
console.log(generateAddress());
console.log(generatePerson());
console.log(generateCompany());

You can also run the included local example:

node examples/basic.js

API

generateCPF()

Generates a mathematically valid, formatted CPF string.

generateCPF();
// "123.456.789-09"

generateCNPJ()

Generates a mathematically valid, formatted CNPJ string.

generateCNPJ();
// "12.345.678/0001-95"

generatePersonName()

Generates a Brazilian-style fictitious person name.

generatePersonName();
// "Ana Oliveira Santos"

generateCompanyName()

Generates a Brazilian-style fictitious company name.

generateCompanyName();
// "Alvorada Tecnologia Ltda"

generateEmail()

Generates a fictitious email address using reserved test-oriented domains.

generateEmail();
// "ana.oliveira.santos.4821@example.com"

generatePhone()

Generates a Brazilian-style fictitious mobile phone number.

generatePhone();
// "(11) 98765-4321"

generateAddress()

Generates a fictitious Brazilian address.

generateAddress();
// {
//   street: "Avenida Brasil",
//   number: "1200",
//   neighborhood: "Centro",
//   city: "Sao Paulo",
//   state: "SP",
//   zipCode: "01310-100"
// }

generatePerson()

Generates a complete fictitious person object.

generatePerson();
// {
//   name: "Camila Santos Lima",
//   cpf: "123.456.789-09",
//   email: "camila.santos.lima.392@example.com.br",
//   phone: "(21) 99876-5432",
//   address: {
//     street: "Rua das Acacias",
//     number: "742",
//     neighborhood: "Boa Vista",
//     city: "Rio de Janeiro",
//     state: "RJ",
//     zipCode: "20000-000"
//   }
// }

generateCompany()

Generates a complete fictitious company object.

generateCompany();
// {
//   companyName: "Pioneira Logistica S.A.",
//   cnpj: "12.345.678/0001-95",
//   email: "rafael.mendes.costa.9012@demo.test",
//   phone: "(31) 97654-3210",
//   address: {
//     street: "Rua Monte Alegre",
//     number: "88",
//     neighborhood: "Santa Luzia",
//     city: "Belo Horizonte",
//     state: "MG",
//     zipCode: "30100-000"
//   }
// }

Online Tools

These generators are also available online for free at Utinix as related demos and utilities:

• CPF Generator: https://utinix.com/pt/gerador-cpf
• CNPJ Generator: https://utinix.com/pt/gerador-cnpj
• Fake Address Generator: https://utinix.com/pt/endereco-ficticio
• Fake Company Generator: https://utinix.com/pt/gerador-empresa-ficticia

Testing

Run the automated test suite with Node.js:

npm test

The tests use the built-in node --test runner and do not require external libraries.

License

MIT