validar_brasileiro #

Brazilian document and form validators for Dart and Flutter.

isValid / tryParse mean the value is well-formed and passes a published checksum or format table. They do not mean a government registry issued it.

This package is a from-scratch alternative to validadores, with alphanumeric CNPJ (IN RFB 2.229/2024) and a typed API. It does not clone that package’s fluent Validador.

Check catalog #

Not in this package: Receita/Correios/SENATRAN lookups, alphanumeric CPF (no official spec yet), CNAE/NCM dumps, CRM/OAB.

Install #

dependencies:
  validar_brasileiro: ^0.2.0

Usage #

import 'package:validar_brasileiro/validar_brasileiro.dart';

final cnpj = Cnpj.parse('12.ABC.345/01DE-35');
Cpf.isValid('529.982.247-25'); // true

// Mask even when the checksum is wrong
Cpf.format('12345678901'); // 123.456.789-01

// Why it failed (empty / charset / length / repeated / checksum / format)
switch (Cpf.inspect(value)) {
  case ParseOk(:final value):
    print(value.formatted);
  case ParseFail(:final issue):
    print(issue.name);
}

// TextFormField-style: document rules skip blank; required() owns emptiness
final validator = all([
  required(),
  cnpj(message: 'CNPJ inválido'),
]);

A lone cpf() on an empty field returns null (no error). Mandatory fields must include required().

Digit collection uses the same mask table as the parsers (collectDigits / isMaskChar): space, +, (), ., /, -. Do not strip with RegExp(r'\D').

PIX and phone shape #

PixKey.tryParse auto-detects DICT types: CPF, CNPJ, lowercase email (max 77), +55 mobile, UUID EVP.

When the form already knows the type:

PixKey.cpf(input);
PixKey.phone(input, allowNational: true); // national digits, no +55
PixKey.evp(input, uuidOnly: false); // 8–200 graphic ASCII, not DICT

Phone.tryParse(input, allowCountryCode: false) rejects a leading 55 so 5511999999999 is not treated as SP mobile.

EmailAddress is for signup forms. isPixEmail is for DICT keys (lowercase, max 77).

Local development #

dart pub get
dart format .
dart analyze --fatal-infos
dart test

Pure Dart — Flutter apps can depend on this package without a plugin.

License #

MIT