@sam-palumbo/cpf

Validação, formatação e geração de CPF brasileiro.

Instalação

npm install @sam-palumbo/cpf

Uso

import { valida, formata, gera } from '@sam-palumbo/cpf';

// Validação
valida('529.982.247-25'); // true
valida('52998224725');    // true (sem formatação)
valida('111.111.111-11'); // false (sequência inválida)
valida('000.000.000-00'); // false

// Formatação
formata('52998224725');    // '529.982.247-25'
formata('529.982.247-25'); // '529.982.247-25' (idempotente)

// Geração
gera(); // ex: '529.982.247-25' (CPF válido aleatório)

API

valida(cpf: string): boolean

Verifica se o CPF é válido aplicando o algoritmo oficial dos dígitos verificadores.
Aceita CPF com ou sem formatação.

formata(cpf: string): string

Aplica a máscara NNN.NNN.NNN-NN ao CPF.
Lança Error se a entrada não contiver exatamente 11 dígitos.

gera(): string

Gera um CPF matematicamente válido no formato NNN.NNN.NNN-NN.
Útil para testes e fixtures.

Licença

MIT