br_validators 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2a8eb5df36f0aae424cad2f9f7be8d3ca4b319d144b58023af72d61a94a597bc
-  data.tar.gz: 6cbba05d5a095be1b04d0d9b0e5aa63116fca27cd0b2eb2902fc7a66a844a7b7
+  metadata.gz: 6f48e272ba459e1e9962ac199162b257eea94025b41c02c64501a663c71058b3
+  data.tar.gz: 3c194886a75d84f28c23b4a62414383735ba70509ef25f2d960fc23996efdcc7
 SHA512:
-  metadata.gz: aa4a7ece5360498679b28eeef9b8dea03c73e24c2742bc7f6a669a2e97f8a5453bf0ee313dec7f5804f8ca3c34d4e7c57a24b56710ab1e23f583c5c0c90b11d0
-  data.tar.gz: f97f6579ff6a8333b86bff8da5eb6d279defa9aca7641b1eedc51e794b9884092d245ecacaaa45f68719d925246e7242e827daa8957e28886af5b262745a0642
+  metadata.gz: 1fa44a6062e29f87a87fdca434a07b7cada13d7b091b06cfc21c1cb98de331ef0c44add691368d2d651703f209349d41478cdae03736e6bd566358caf26298f9
+  data.tar.gz: cd6d9864713501561878ceff7c9a505de1f6791dcd6fb61001a224dbe762bf8c863b40d1f9414f891634c540ba19c149524547ee612372616cfbbf8cff59854a

data/CHANGELOG.md

@@ -3,9 +3,21 @@
 As mudanças de cada versão ficam aqui. O projeto segue o
 [versionamento semântico](https://semver.org/lang/pt-BR/).
 
-## [Não lançado]
+## [0.1.1] - 2026-10-25
 
-- Página para testar os validadores no navegador (https://br-validators-gem.vercel.app).
+### Corrigido
+
+- CNPJ: letras fora do ASCII, como `ı` (i sem ponto) e `ß`, não viram mais letras
+  válidas ao passar para maiúsculas. Antes, `"12abcı3450de60"` passava como válido.
+- Texto com bytes inválidos (UTF-8 quebrado) devolve `false` em vez de levantar
+  `ArgumentError`.
+- Espaços Unicode, como o espaço não separável que vem ao copiar de PDFs e sites,
+  contam como máscara em CPF, CNPJ, CNS e boleto, e são ignorados nas pontas da chave Pix.
+
+### Outros
+
+- Página para testar os validadores no navegador (https://br-validators.vercel.app).
+- Publicação também pelo botão "Run workflow", recusando versão já publicada.
 
 ## [0.1.0] - 2026-10-25
 

data/README.md

@@ -10,8 +10,8 @@ No `Gemfile`:
 gem "br_validators"
 ```
 
-> A versão 0.1.0 está pronta e vai ser publicada no RubyGems em breve. Até lá, use direto
-> do GitHub: `gem "br_validators", github: "PedroPedrassolli/br_validators"`.
+Ou direto: `gem install br_validators`. A gem está publicada no
+[RubyGems](https://rubygems.org/gems/br_validators).
 
 ## O que tem
 
@@ -36,6 +36,11 @@ BrValidators::CNPJ.format("12abc34501de35")     # => "12.ABC.345/01DE-35"
 BrValidators::CNS.format("898000000000436")      # => "898 0000 0000 0436"
 ```
 
+Pontos, hífens e espaços são ignorados em qualquer posição, inclusive o espaço não
+separável que vem junto ao copiar de um PDF ou de um site. Texto corrompido (bytes que
+não são UTF-8 válido) só dá `false`, sem erro. Passe sempre o documento como texto: um
+número inteiro perde os zeros à esquerda (`01234567890` vira `1234567890`).
+
 A chave Pix é um caso à parte: em vez de `format` e `strip`, ela tem `type`, que diz
 o tipo da chave. Ela precisa estar como o Banco Central guarda (sem máscara, e-mail e
 chave aleatória em minúsculas):
@@ -81,7 +86,7 @@ mensagens de erro em português e inglês.
 
 ## Página de teste
 
-Dá para testar cada validador no navegador em https://br-validators-gem.vercel.app. A página
+Dá para testar cada validador no navegador em https://br-validators.vercel.app. A página
 (`public/`) é HTML e JavaScript puro e chama uma função Ruby da Vercel
 (`api/validar.rb`) que usa a própria gem, então as regras ficam num lugar só:
 

data/lib/br_validators/active_model.rb

@@ -25,7 +25,7 @@ module BrValidators
   end
 end
 
-# Um arquivo por validador (o Rails espera uma classe por arquivo).
+# Um arquivo por validador: uma classe por arquivo, como no resto da gem.
 require_relative "validators/cpf_validator"
 require_relative "validators/cnpj_validator"
 require_relative "validators/cns_validator"

data/lib/br_validators/boleto.rb

@@ -19,11 +19,14 @@ module BrValidators
   #   diz que o dígito de cada bloco usa o mesmo módulo do verificador geral.
   #   https://cmsarquivos.febraban.org.br/Arquivos/documentos/PDF/Layout%20-%20C%C3%B3digo%20de%20Barras%20-%20Vers%C3%A3o%207%20-%2001_03_2023_mn.pdf
   module Boleto
-    # Pontos, espaços e hífens que aparecem na linha impressa.
-    MASK = /[.\-\s]/
+    # Pontos, espaços e hífens que aparecem na linha impressa. A linha copiada do
+    # PDF do boleto ou do site do banco costuma vir com espaço não separável, que
+    # [:space:] também pega.
+    MASK = /[.\-[:space:]]/
 
+    # O scrub está explicado no CPF: texto corrompido vira inválido, sem erro.
     def self.strip(value)
-      value.to_s.gsub(MASK, "")
+      value.to_s.scrub.gsub(MASK, "")
     end
 
     # :cobranca, :arrecadacao ou nil se a linha for inválida.

data/lib/br_validators/cnpj.rb

@@ -14,8 +14,9 @@ module BrValidators
   # Fonte: manual do dígito verificador do CNPJ, da Receita Federal.
   # https://www.gov.br/receitafederal/pt-br/centrais-de-conteudo/publicacoes/documentos-tecnicos/cnpj/manual-dv-cnpj.pdf
   module CNPJ
-    # Caracteres de máscara aceitos na entrada: ponto, barra, hífen e espaços.
-    MASK = %r{[./\-\s]}
+    # Caracteres de máscara aceitos na entrada: ponto, barra, hífen e espaços
+    # (inclusive os espaços Unicode, como o não separável).
+    MASK = %r{[./\-[:space:]]}
 
     # 12 caracteres alfanuméricos e 2 dígitos no final.
     PATTERN = /\A[0-9A-Z]{12}\d{2}\z/
@@ -23,8 +24,12 @@ module BrValidators
     # Tira a máscara e passa as letras para maiúsculas:
     # "12.abc.345/01de-35" vira "12ABC34501DE35".
     # A Receita só usa maiúsculas, mas é comum alguém digitar em minúsculas.
+    #
+    # upcase(:ascii) mexe só nas letras de a a z. O upcase normal segue o Unicode e
+    # transforma "ı" (i sem ponto) em "I" e "ß" em "SS", o que faria um texto
+    # errado passar como CNPJ válido. O scrub está explicado no CPF.
     def self.strip(value)
-      value.to_s.gsub(MASK, "").upcase
+      value.to_s.scrub.gsub(MASK, "").upcase(:ascii)
     end
 
     def self.valid?(value)

data/lib/br_validators/cns.rb

@@ -19,11 +19,13 @@ module BrValidators
   # https://rni-docs.anvisa.gov.br/docs/regras_gerais/validacoes/validacaoCNS/
   module CNS
     # O cartão mostra o número em grupos separados por espaço; aceitamos também
-    # pontos e hífens, que às vezes aparecem em sistemas antigos.
-    MASK = /[.\-\s]/
+    # pontos e hífens, que às vezes aparecem em sistemas antigos. Espaços Unicode
+    # (como o não separável) também contam como espaço.
+    MASK = /[.\-[:space:]]/
 
+    # O scrub está explicado no CPF: texto corrompido vira inválido, sem erro.
     def self.strip(value)
-      value.to_s.gsub(MASK, "")
+      value.to_s.scrub.gsub(MASK, "")
     end
 
     def self.valid?(value)

data/lib/br_validators/cpf.rb

@@ -9,12 +9,16 @@ module BrValidators
   # por 11 for 0 ou 1, o dígito é 0; senão, é 11 menos o resto.
   module CPF
     # Caracteres de máscara que aceitamos na entrada: ponto, hífen e espaços.
-    MASK = /[.\-\s]/
+    # [:space:] pega também os espaços Unicode, como o espaço não separável que
+    # vem junto ao copiar um número de um PDF ou de um site.
+    MASK = /[.\-[:space:]]/
 
     # Tira a máscara: "123.456.789-09" vira "12345678909".
     # Não remove letras nem outros símbolos, para que valid? possa recusá-los.
+    # O scrub troca bytes inválidos (texto corrompido) por "�", que nunca passa na
+    # validação; sem ele, o gsub levantaria um erro em vez de devolver false.
     def self.strip(value)
-      value.to_s.gsub(MASK, "")
+      value.to_s.scrub.gsub(MASK, "")
     end
 
     def self.valid?(value)

data/lib/br_validators/pix.rb

@@ -18,6 +18,9 @@ module BrValidators
   module Pix
     MAX_LENGTH = 77
 
+    # Espaços nas pontas, inclusive os Unicode (o strip do Ruby só tira os ASCII).
+    EDGE_SPACES = /\A[[:space:]]+|[[:space:]]+\z/
+
     PHONE = /\A\+[1-9][0-9]\d{1,14}\z/
     EVP = /\A[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\z/
 
@@ -42,8 +45,9 @@ module BrValidators
     # Devolve :cpf, :cnpj, :phone, :email ou :evp, ou nil se a chave for inválida.
     # Só os espaços nas pontas são ignorados: o resto precisa estar exatamente
     # como o DICT guarda (sem máscara, e-mail e chave aleatória em minúsculas).
+    # O scrub está explicado no CPF: texto corrompido vira inválido, sem erro.
     def self.type(value)
-      key = value.to_s.strip
+      key = value.to_s.scrub.gsub(EDGE_SPACES, "")
       return nil if key.size > MAX_LENGTH
 
       found = CHECKS.find { |_type, check| check.call(key) }

data/lib/br_validators/version.rb

@@ -2,5 +2,5 @@
 
 # Versão da gem, lida também pelo gemspec.
 module BrValidators
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/lib/br_validators.rb

@@ -14,6 +14,8 @@ require_relative "br_validators/boleto"
 #   valid?(valor)  -> true ou false
 #   format(valor)  -> o documento com a máscara, ou nil se for inválido
 #   strip(valor)   -> o documento sem a máscara
+# A chave Pix é a exceção: tem valid? e type, mas não format nem strip, porque
+# precisa estar exatamente como o Banco Central guarda. Pix e Boleto têm type.
 module BrValidators
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: br_validators
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Pedro Pedrassolli