@br-validators/core 0.12.0-alpha.2 → 1.0.0

package/README.md

@@ -1,110 +1,63 @@
 # @br-validators/core
 
-100% open-source Brazilian document validators (MIT). Pure TypeScript — no HTTP lookups, no frameworks.
+> **The** Brazilian document validation library for TypeScript.  
+> Validate, format, and generate CPF, CNPJ (including the new alphanumeric format), NF-e, BR Code PIX, boleto, IE (all 27 states), and 15+ more — zero dependencies, fully typed, never throws.
 
-**npm:** [`@br-validators/core`](https://www.npmjs.com/package/@br-validators/core)  
-**Repo:** [github.com/AlexandreZanata/br-validators](https://github.com/AlexandreZanata/br-validators)  
-**Playground:** [doc-raiz-playground.vercel.app](https://doc-raiz-playground.vercel.app/)
-
-> The unscoped name `br-validators` on npm is a **different package**. Use **`@br-validators/core`**.
-
----
-
-## Install
+[![npm](https://img.shields.io/npm/v/@br-validators/core)](https://www.npmjs.com/package/@br-validators/core)
+[![MIT](https://img.shields.io/badge/license-MIT-blue)](https://github.com/AlexandreZanata/br-validators/blob/main/LICENSE)
+[![Node ≥ 18](https://img.shields.io/badge/node-%3E%3D18-brightgreen)]()
 
 ```bash
 npm install @br-validators/core
 ```
 
-Requires Node ≥ 18. ESM only (`"type": "module"`).
+**Try it now → [doc-raiz-playground.vercel.app](https://doc-raiz-playground.vercel.app)**  
+**CLI → `npm install -g @br-validators/cli`**
 
----
+> ⚠️ The unscoped `br-validators` on npm is a different package. Use **`@br-validators/core`**.
 
-## Platform APIs
+---
 
-Cross-cutting helpers that **compose existing validators** — never duplicate check-digit logic.
+## Why this library
 
-| API | Import | Purpose |
-|-----|--------|---------|
-| **`detect()`** | `@br-validators/core/detect` | Classify raw input (priority router over all shipped types) |
-| **`sanitize()`** | `@br-validators/core/sanitize` | ETL fixes → validate (returns `fixes[]`) |
-| **`generate()`** | `@br-validators/core/generate` | Synthetic **test fixtures** only (`seed` for reproducibility) |
+Every Brazilian SaaS eventually reinvents CPF validation — usually wrong.  
+`@br-validators/core` implements each algorithm from its **official primary source**
+(Receita Federal, Bacen, CONTRAN, TSE, SEFAZ, FEBRABAN, Anatel) so you don't have to.
 
-```typescript
-import { detect, sanitize, generate } from '@br-validators/core';
-import { validateCpf } from '@br-validators/core/cpf';
+- ✅ **CNPJ alfanumérico** — new RFB format (effective July 2026), ready now
+- ✅ **18+ document types** — CPF, CNPJ, CEP, NF-e chave, BR Code PIX, boleto (cobrança + arrecadação), CNH, RENAVAM, placa, PIS/PASEP, PIX key, cartão de crédito, IE (27 UFs), IE produtor rural, título de eleitor, telefone, + platform APIs above
+- ✅ **Zero runtime dependencies** — pure TypeScript logic, no HTTP calls
+- ✅ **Never throws** — every function returns `{ ok: true, value } | { ok: false, message, code }`
+- ✅ **Tree-shakeable** — subpath imports per document type
+- ✅ **ESM only**, Node ≥ 18, works in browser, Bun, Deno
 
-// Auto-detect document type
-detect('123.456.789-09');
-// → { type: 'cpf', ok: true, value: '12345678909', format: 'numeric' }
+---
 
-detect('110042490114', { uf: 'SP' });
-// → { type: 'inscricao-estadual', ok: true, ... }
+## Quick start
 
-// Messy ETL input → canonical + fix audit trail
-sanitize(' 123.456.789-09 ', 'cpf');
-// → { ok: true, value: '12345678909', fixes: ['trimmed', 'removed_non_digits'] }
+```typescript
+import { validateCpf, formatCpf } from '@br-validators/core';
 
-sanitize('110.042.490.114', 'inscricao-estadual', { uf: 'SP' });
-// → { ok: true, value: '110042490114', fixes: [...] }
+validateCpf('123.456.789-09');
+// { ok: true, value: '12345678909' }
 
-// Synthetic valid documents for tests (never production IDs)
-const cpf = generate('cpf', { seed: 42 });
-validateCpf(cpf).ok; // true
+formatCpf('12345678909');
+// { ok: true, formatted: '123.456.789-09' }
 
-generate('cnpj', { format: 'alphanumeric', masked: true, seed: 7 });
-generate('placa', { format: 'mercosul', seed: 3 });
+validateCpf('111.111.111-11');
+// { ok: false, message: 'CPF with all identical digits is invalid', code: 'KNOWN_INVALID_PATTERN' }
 ```
 
-**Detect notes:** 11-digit bucket tries CPF → CNH → PIS (RENAVAM equivalent DV may classify as `pis-pasep`). IE detection requires `{ uf }`. 48-digit boleto arrecadação is skipped.
-
-**Generate policy:** 9 types — CPF, CNPJ, CEP, placa, PIS, RENAVAM, CNH, telefone, cartão. Excludes boleto, NF-e chave, IE, BR Code, PIX.
-
----
-
-## Per-type validators
-
-Every module exposes `validate*`, `format*`, `strip*` (where applicable). All return `ValidationResult` — **never throw** on invalid input.
-
-| Subpath | Key functions | Golden vector |
-|---------|---------------|---------------|
-| `./cnpj` | `validateCnpj`, `formatCnpj`, `stripCnpj` | `12ABC34501DE35` (alphanumeric) |
-| `./cpf` | `validateCpf`, `formatCpf`, `stripCpf` | `12345678909` |
-| `./cep` | `validateCep`, `formatCep`, `stripCep` | `01310100` |
-| `./telefone` | `validateTelefone`, `formatTelefone`, `stripTelefone` | `11999999999` (celular) |
-| `./cnh` | `validateCnh`, `formatCnh`, `stripCnh` | `62472927637` (11 digits, no CPF mask) |
-| `./renavam` | `validateRenavam`, `formatRenavam`, `stripRenavam` | `63977791104` |
-| `./titulo-eleitor` | `validateTituloEleitor`, `formatTituloEleitor`, `stripTituloEleitor` | `004356870906` |
-| `./nfe-chave` | `validateNfeChave`, `parseNfeChave`, `formatNfeChave` | `52060433009911002506550120000007800267301615` |
-| `./brcode` | `validateBrCode`, `parseBrCode` | EMV PIX payload (CRC16) |
-| `./placa` | `validatePlaca`, `formatPlaca`, `convertPlacaToMercosul` | `ABC1D23` (Mercosul), `ABC1234` (legacy) |
-| `./pis-pasep` | `validatePisPasep`, `formatPisPasep`, `stripPisPasep` | `10027230888` |
-| `./pix` | `validatePixKey`, `formatPixKey`, `detectPixKeyType` | `pix@bcb.gov.br` |
-| `./boleto` | `validateBoleto`, `formatBoleto`, `convertLinhaToCodigoBarras` | Situação 1 + 2 (FEBRABAN) |
-| `./cartao-credito` | `validateCartaoCredito`, `passesLuhn`, `detectCardBrand` | `4111111111111111` |
-| `./inscricao-estadual` | `validateInscricaoEstadual`, `formatInscricaoEstadual` | `110042490114` (SP) — **27 UFs**, `{ uf }` required |
-| `./inscricao-estadual-produtor-rural` | `validateIeProdutorRural`, `validateIeSpRural` | `P011004243002` (SP Regra II) |
-
-Tree-shaking via subpaths:
+### CNPJ — numeric and alphanumeric (new RFB format)
 
 ```typescript
-import { validateCnpj } from '@br-validators/core/cnpj';
-import { validateNfeChave } from '@br-validators/core/nfe-chave';
-import { validateTituloEleitor } from '@br-validators/core/titulo-eleitor';
-import { validateBrCode } from '@br-validators/core/brcode';
-import { validateInscricaoEstadual } from '@br-validators/core/inscricao-estadual';
-import { validateIeProdutorRural } from '@br-validators/core/inscricao-estadual-produtor-rural';
-```
+import { validateCnpj, formatCnpj } from '@br-validators/core/cnpj';
 
----
-
-## Examples
-
-### CNPJ (numeric + alphanumeric)
-
-```typescript
-import { validateCnpj, formatCnpj } from '@br-validators/core';
+// Numeric (current format)
+validateCnpj('11.222.333/0001-81');
+// { ok: true, value: '11222333000181', format: 'numeric' }
 
+// Alphanumeric (new format — effective July 2026)
 validateCnpj('12ABC34501DE35');
 // { ok: true, value: '12ABC34501DE35', format: 'alphanumeric' }
 
@@ -112,105 +65,231 @@ formatCnpj('12ABC34501DE35');
 // { ok: true, formatted: '12.ABC.345/01DE-35' }
 ```
 
-### Inscrição Estadual (all 27 UFs)
+### Auto-detect document type
 
 ```typescript
-import { validateInscricaoEstadual } from '@br-validators/core/inscricao-estadual';
+import { detect } from '@br-validators/core';
+
+detect('123.456.789-09');
+// { type: 'cpf', ok: true, value: '12345678909' }
+
+detect('ABC1D23');
+// { type: 'placa', ok: true, format: 'mercosul' }
+
+detect('110042490114', { uf: 'SP' });
+// { type: 'inscricao-estadual', ok: true }
+```
 
-validateInscricaoEstadual('110042490114', { uf: 'SP' });
-validateInscricaoEstadual('0730000100109', { uf: 'DF' });
-// getIeOfficialSourceUrl('SP') → SEFAZ primary URL
+### Generate valid documents for tests
+
+```typescript
+import { generate } from '@br-validators/core';
+
+generate('cpf', { seed: 42 });           // reproducible, always valid
+generate('cnpj', { format: 'alphanumeric', masked: true });
+generate('placa', { format: 'mercosul' });
+generate('renavam');
+generate('cnh');
+generate('inscricao-estadual', { uf: 'SP', seed: 42 });
+generate('titulo-eleitor', { uf: 'SC', seed: 42 });
+generate('cartao-credito', { brand: 'visa', seed: 42 });
+generate('pix', { seed: 42 });           // EVP UUID — Bacen DICT
+generate('nfe-chave', { seed: 42 });     // MOC §2.2.6 modulo-11 DV
+generate('brcode', { seed: 42 });        // static PIX EMV + CRC16
+generate('boleto', { masked: true });    // FEBRABAN cobrança Situação 1
+generate('boleto-arrecadacao');          // FEBRABAN Layout v7
+generate('inscricao-estadual-produtor-rural', { masked: true }); // SP SINTEGRA Bloco II
 ```
 
-### SP produtor rural (`P` prefix)
+> `generate()` is for test fixtures and seed data only — never use in production.  
+> Alphanumeric CPF: `generate('cpf', { format: 'alphanumeric' })` throws `CPF_ALPHA_SPEC_PENDING` until RFB publishes the official algorithm ([OFFICIAL-SOURCES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/OFFICIAL-SOURCES.md)).
+
+### ETL / data cleanup
 
 ```typescript
-import { validateIeProdutorRural } from '@br-validators/core/inscricao-estadual-produtor-rural';
+import { sanitize } from '@br-validators/core';
+
+sanitize(' 123.456.789-09 ', 'cpf');
+// { ok: true, value: '12345678909', fixes: ['trimmed', 'removed_non_digits'] }
 
-validateIeProdutorRural('SP', 'P-01100424.3/002');
-// { ok: true, value: 'P011004243002', ... }
+sanitize('110.042.490.114', 'inscricao-estadual', { uf: 'SP' });
+// { ok: true, value: '110042490114', fixes: [...] }
 ```
 
-### NF-e / NFC-e chave de acesso (44 digits)
+### NF-e chave de acesso (44 digits)
 
 ```typescript
 import { validateNfeChave, parseNfeChave } from '@br-validators/core/nfe-chave';
 
 const result = validateNfeChave('52060433009911002506550120000007800267301615');
-// { ok: true, parsed: { cUF, cnpj, mod, serie, nNF, ... }, uf: 'GO' }
+// { ok: true, parsed: { cUF: '52', cnpj: '33009911002506', mod: '55', ... }, uf: 'GO' }
 ```
 
 ### BR Code (PIX QR payload)
 
 ```typescript
-import { validateBrCode } from '@br-validators/core/brcode';
-
-validateBrCode('00020126580014br.gov.bcb.pix0136...63041D3D');
-// { ok: true, pixKey, merchantName, merchantCity, ... }
+import {
+  buildStaticPixBrCode,
+  parseBrCode,
+  validateBrCode,
+} from '@br-validators/core/brcode';
+
+// Permanent static QR (no amount — payer sets value at payment time)
+const payload = buildStaticPixBrCode({
+  pixKey: 'pix@bcb.gov.br',
+  merchantName: 'Fulano de Tal',
+  merchantCity: 'BRASILIA',
+});
+validateBrCode(payload).ok; // true
+
+// Fixed-value static QR
+buildStaticPixBrCode({
+  pixKey: 'pix@bcb.gov.br',
+  merchantName: 'Fulano de Tal',
+  merchantCity: 'BRASILIA',
+  amount: '10.50',
+});
+
+parseBrCode(payload);
+// { ok: true, pixKey, pixKeyType, merchantName, merchantCity, amount, txid }
 ```
 
-### Boleto (linha digitável ↔ código de barras)
+**Playground:** [doc-raiz-playground.vercel.app/pix](https://doc-raiz-playground.vercel.app/pix) renders the QR image from `buildStaticPixBrCode` output. Official sources: [Bacen Manual BR Code](https://www.bcb.gov.br/content/estabilidadefinanceira/spb_docs/ManualBRCode.pdf) · [Manual de Padrões PIX](https://www.bcb.gov.br/content/estabilidadefinanceira/pix/Regulamento_Pix/II_ManualdePadroesparaIniciacaodoPix.pdf).
+
+### Boleto — cobrança + arrecadação
 
 ```typescript
-import { validateBoleto, convertLinhaToCodigoBarras } from '@br-validators/core/boleto';
+import { validateBoleto, validateArrecadacao } from '@br-validators/core/boleto';
 
 validateBoleto('03399.02579 08991.834006 71742.301014 6 14500000099668');
+// cobrança Situação 1/2 — FEBRABAN FB-0061/2021
+
+validateArrecadacao('846300000003812345678906123456789015234567890129');
+// arrecadação 48-digit — FEBRABAN Layout v7
 ```
 
----
+### Platform APIs — mask, compare, batch, diff
 
-## Official sources
+```typescript
+import { mask, compare, batch, diff } from '@br-validators/core';
 
-Every algorithm cites a primary government or standards body source (RFB, Bacen, CONTRAN, TSE, SEFAZ, FEBRABAN, ISO, Correios, Anatel, SIPREV).
+mask('12345678909', 'cpf');
+// { ok: true, formatted: '123.456.789-09' }
 
-Full index: [docs/OFFICIAL-SOURCES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/OFFICIAL-SOURCES.md)
+compare('123.456.789-09', '12345678909', 'cpf');
+// { equal: true }
 
-Per-type constants: `CNPJ_OFFICIAL_SOURCE_URL`, `NFE_CHAVE_OFFICIAL_SOURCE_URL`, `IE_OFFICIAL_SOURCE_URLS`, `BRCODE_OFFICIAL_SOURCE_URL`, etc.
+batch(['12345678909', 'invalid'], 'cpf');
+// { valid: [...], invalid: [...], summary: { total: 2, valid: 1, invalid: 1 } }
 
-Golden test vectors: `tests/vectors/*.official.json` in the repo.
+diff('12345678909', '12345678901', 'cpf');
+// { changed: true, fields: [{ field: 'dv', a: '09', b: '01' }] }
+```
 
----
+Per-type rules and official sources: [docs/OFFICIAL-SOURCES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/OFFICIAL-SOURCES.md) · API contract: [docs/LIBRARY-API.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/LIBRARY-API.md)
+
+### Form handler (React / Next.js)
+
+```typescript
+'use client';
+import { validateCnpj, formatCnpj } from '@br-validators/core/cnpj';
+import { useState } from 'react';
+
+export function CnpjField() {
+  const [input, setInput] = useState('');
+  const result = input ? validateCnpj(input) : null;
+  const formatted = result?.ok ? formatCnpj(result.value) : null;
+
+  return (
+    <div>
+      <input value={input} onChange={e => setInput(e.target.value)} />
+      {formatted?.ok && <p>✅ {formatted.formatted}</p>}
+      {result && !result.ok && <p>❌ {result.message}</p>}
+    </div>
+  );
+}
+```
 
-## API reference
+### Shell / CI
 
-| Doc | Content |
-|-----|---------|
-| [LIBRARY-API.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/LIBRARY-API.md) | Full signatures + platform APIs |
-| [VALIDATION-RULES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/VALIDATION-RULES.md) | Business rules (BR-* IDs) |
-| [DELIVERY-SURFACES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/DELIVERY-SURFACES.md) | Library + CLI + playground matrix |
+```bash
+br-validators cnpj validate "$CNPJ" --quiet || exit 1
+br-validators ie validate "$IE" --uf SP --json
+br-validators detect '123.456.789-09' --json
+br-validators generate cpf --seed 42 --masked
+br-validators generate pix --seed 42
+br-validators generate nfe-chave --seed 42
+br-validators generate brcode --seed 42
+br-validators generate boleto --masked --seed 42
+br-validators generate boleto-arrecadacao --seed 42
+br-validators generate inscricao-estadual-produtor-rural --masked --seed 42
+```
 
 ---
 
-## CLI companion
+## All supported types
+
+| Document | Subpath import | CLI | Playground |
+|---|---|---|---|
+| CPF | `@br-validators/core/cpf` | `br-validators cpf …` | `/cpf` |
+| CNPJ (numeric + alphanumeric) | `@br-validators/core/cnpj` | `br-validators cnpj …` | `/cnpj` |
+| CEP | `@br-validators/core/cep` | `br-validators cep …` | `/cep` |
+| Telefone | `@br-validators/core/telefone` | `br-validators telefone …` | `/telefone` |
+| CNH | `@br-validators/core/cnh` | `br-validators cnh …` | `/cnh` |
+| RENAVAM | `@br-validators/core/renavam` | `br-validators renavam …` | `/renavam` |
+| Título de Eleitor | `@br-validators/core/titulo-eleitor` | `br-validators titulo-eleitor …` | `/titulo-eleitor` |
+| Placa (Mercosul + legada) | `@br-validators/core/placa` | `br-validators placa …` | `/placa` |
+| PIS / PASEP / NIS | `@br-validators/core/pis-pasep` | `br-validators pis-pasep …` | `/pis` |
+| PIX key | `@br-validators/core/pix` | `br-validators pix …` | `/pix` |
+| BR Code (PIX QR payload + builder) | `@br-validators/core/brcode` | `br-validators brcode …` | `/brcode` |
+| Boleto cobrança (Situação 1 + 2) | `@br-validators/core/boleto` | `br-validators boleto …` | `/boleto` |
+| Boleto arrecadação (48/44) | `@br-validators/core/boleto` | `br-validators boleto …` | `/boleto` |
+| NF-e / NFC-e chave (44 digits) | `@br-validators/core/nfe-chave` | `br-validators nfe-chave …` | `/nfe-chave` |
+| Cartão de crédito (Luhn) | `@br-validators/core/cartao-credito` | `br-validators cartao …` | `/cartao-credito` |
+| Inscrição Estadual (27 UFs) | `@br-validators/core/inscricao-estadual` | `br-validators ie … --uf SP` | `/ie` |
+| IE Produtor Rural | `@br-validators/core/inscricao-estadual-produtor-rural` | `br-validators ie …` (auto `P`) | `/ie` |
+| **detect()** | `@br-validators/core/detect` | `br-validators detect …` | `/detect` |
+| **sanitize()** | `@br-validators/core/sanitize` | `br-validators sanitize …` | `/sanitize` |
+| **mask()** | `@br-validators/core/mask` | — | via per-type `format` |
+| **compare()** | `@br-validators/core/compare` | — | — |
+| **batch()** | `@br-validators/core/batch` | — | — |
+| **diff()** | `@br-validators/core/diff` | — | — |
+| **generate()** | `@br-validators/core/generate` | `br-validators generate …` | `/generate` |
+| **buildStaticPixBrCode()** | `@br-validators/core/brcode` | — | `/pix` (QR panel) |
+
+Full official sources per type: [docs/OFFICIAL-SOURCES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/OFFICIAL-SOURCES.md)
 
-```bash
-npm install -g @br-validators/cli
+---
 
-br-validators list
-br-validators cnpj validate 12ABC34501DE35 --json
-br-validators nfe-chave validate 52060433009911002506550120000007800267301615 --json
-br-validators titulo-eleitor validate 004356870906
-br-validators brcode validate '<emv-payload>'
-br-validators ie validate 110042490114 --uf SP
+## Tree-shaking
 
-# Platform APIs
-br-validators detect '123.456.789-09' --json
-br-validators sanitize cpf ' 123.456.789-09 ' --json
-br-validators generate cpf --seed 42 --masked --json
+```typescript
+// Only ships the CPF module — nothing else
+import { validateCpf } from '@br-validators/core/cpf';
+
+// Only ships NF-e module
+import { parseNfeChave } from '@br-validators/core/nfe-chave';
 ```
 
 ---
 
-## Related packages (monorepo)
+## Related packages
 
 | Package | Status |
-|---------|--------|
-| `@br-validators/cli` | Published — terminal CLI |
-| `@br-validators/zod` | Workspace — Zod schemas (not on npm yet) |
-| `@br-validators/react-hook-form` | Workspace — RHF resolvers (not on npm yet) |
+|---|---|
+| [`@br-validators/cli`](https://www.npmjs.com/package/@br-validators/cli) | Published |
+| [`@br-validators/zod`](https://www.npmjs.com/package/@br-validators/zod) | Published — Zod 3/4 schemas |
+| [`@br-validators/react-hook-form`](https://www.npmjs.com/package/@br-validators/react-hook-form) | Published — RHF resolvers |
+
+---
+
+## Contributing
+
+Issues, corrections, and new document types are welcome.  
+See [CONTRIBUTING.md](https://github.com/AlexandreZanata/br-validators/blob/main/CONTRIBUTING.md) and open `good first issue` items.
 
 ---
 
 ## License
 
-MIT
+[MIT](https://github.com/AlexandreZanata/br-validators/blob/main/LICENSE) — permanently free and open source.

package/dist/batch.d.ts

@@ -0,0 +1,28 @@
+import { P as PlatformDocumentType, a as PlatformOptions } from './types-MXifBcV5.js';
+import { V as ValidationErrorCode } from './validation-result-BaI2Xder.js';
+import './index-BEJFgDXj.js';
+
+type BatchValidEntry = {
+    index: number;
+    input: string;
+    value: string;
+};
+type BatchInvalidEntry = {
+    index: number;
+    input: string;
+    code: ValidationErrorCode;
+    message: string;
+};
+type BatchSummary = {
+    total: number;
+    valid: number;
+    invalid: number;
+};
+type BatchResult = {
+    valid: BatchValidEntry[];
+    invalid: BatchInvalidEntry[];
+    summary: BatchSummary;
+};
+declare function batch(inputs: readonly string[], type: PlatformDocumentType, options?: PlatformOptions): BatchResult;
+
+export { type BatchInvalidEntry, type BatchResult, type BatchSummary, type BatchValidEntry, batch };

package/dist/batch.js

@@ -0,0 +1,29 @@
+export { batch } from './chunk-N2WVO3GF.js';
+import './chunk-I66ZRSEN.js';
+import './chunk-AO6UTQ4A.js';
+import './chunk-JLCQ7MGC.js';
+import './chunk-3LMDBXU6.js';
+import './chunk-DAR6VOMT.js';
+import './chunk-CSVGWTCG.js';
+import './chunk-665E36SC.js';
+import './chunk-CDNOUZEI.js';
+import './chunk-AU6TW3GH.js';
+import './chunk-N6RQICAP.js';
+import './chunk-E2EFGMWA.js';
+import './chunk-V7UJ55KW.js';
+import './chunk-H3MLGGFI.js';
+import './chunk-P2KNN6ZR.js';
+import './chunk-63G7QO73.js';
+import './chunk-ANWQBKGN.js';
+import './chunk-TE6NSONR.js';
+import './chunk-YNVMVDFN.js';
+import './chunk-YYHS5WQN.js';
+import './chunk-4SNBZFS5.js';
+import './chunk-UCJPSJN5.js';
+import './chunk-CSRBRKXY.js';
+import './chunk-FBARVLLP.js';
+import './chunk-OTZHMJYE.js';
+import './chunk-EB3G4IG6.js';
+import './chunk-NUQSMT4Y.js';
+//# sourceMappingURL=batch.js.map
+//# sourceMappingURL=batch.js.map

package/dist/batch.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"batch.js"}

package/dist/boleto.d.ts

@@ -1,5 +1,5 @@
-import { b as BoletoValidationResult, V as ValidationErrorCode, B as BoletoInputKind, F as FormatResult } from './validation-result-BhQE-1_O.js';
-export { a as BoletoSituacao, i as CodigoBarras, D as DocumentFormat, L as LinhaDigitavel } from './validation-result-BhQE-1_O.js';
+import { y as CobrancaBoletoValidationResult, V as ValidationErrorCode, B as BoletoInputKind, b as BoletoValidationResult, F as FormatResult } from './validation-result-BaI2Xder.js';
+export { a as BoletoSituacao, i as CodigoBarras, D as DocumentFormat, L as LinhaDigitavel } from './validation-result-BaI2Xder.js';
 
 /**
  * FEBRABAN bank boleto (cobrança) — linha digitável + código de barras.
@@ -20,6 +20,10 @@ declare const BOLETO_GOLDEN_LINHA_SITUACAO2_STRIPPED = "988012345167890123457678
 declare const BOLETO_GOLDEN_CODIGO_BARRAS_SITUACAO2 = "98807607469480001121234567890123456789012345";
 declare const BOLETO_OFFICIAL_SOURCE_URL = "https://cmsarquivos.febraban.org.br/Arquivos/documentos/PDF/Conven%C3%A7%C3%A3o%20da%20Cobran%C3%A7a%20-%2005_02_2021_f.pdf";
 declare const BOLETO_LAYOUTS_PORTAL_URL = "https://portal.febraban.org.br/pagina/3425/33/pt-br/layout-febraban";
+declare const BOLETO_ARRECADACAO_LINHA_LENGTH = 48;
+declare const BOLETO_ARRECADACAO_CODIGO_BARRAS_LENGTH = 44;
+declare const BOLETO_ARRECADACAO_PRODUCT_ID = "8";
+declare const BOLETO_ARRECADACAO_OFFICIAL_SOURCE_URL = "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";
 
 /**
  * Modulo 10 — linha digitável field DVs (Anexo IX).
@@ -52,7 +56,7 @@ declare function formatLinhaDigitavel(stripped: string): string;
  */
 
 declare function stripLinhaDigitavel(input: string): string;
-declare function validateLinhaDigitavel(input: string): BoletoValidationResult;
+declare function validateLinhaDigitavel(input: string): CobrancaBoletoValidationResult;
 
 /**
  * Código de barras validation — modulo 11 general DV (Anexo X).
@@ -60,7 +64,7 @@ declare function validateLinhaDigitavel(input: string): BoletoValidationResult;
  */
 
 declare function stripCodigoBarras(input: string): string;
-declare function validateCodigoBarras(input: string): BoletoValidationResult;
+declare function validateCodigoBarras(input: string): CobrancaBoletoValidationResult;
 
 /**
  * Due-date factor semantic validation (Situação 1 only).
@@ -93,6 +97,55 @@ type ValorDocumentoValidationResult = {
 };
 declare function validateValorDocumento(value: string): ValorDocumentoValidationResult;
 
+/**
+ * FEBRABAN arrecadação modulo 11 — Layout v7 §09–10.
+ * @see BOLETO_ARRECADACAO_OFFICIAL_SOURCE_URL
+ *
+ * Multipliers 2,3,4,5,6,7,8,9,2,3,4… from right; remainder 0|1 → DV 0; remainder 10 → DV 1.
+ */
+declare function computeArrecadacaoModulo11Dv(digits: string): number;
+declare function isArrecadacaoValueType(valueType: string): valueType is ArrecadacaoValueType;
+type ArrecadacaoValueType = '6' | '7' | '8' | '9';
+declare function getArrecadacaoDvCalculator(valueType: string): (digits: string) => number;
+
+/**
+ * Boleto arrecadação — FEBRABAN Layout v7 (48-digit linha + 44-digit código de barras).
+ * @see docs/use-cases/UC-007-validate-boleto.md
+ * @see BOLETO_ARRECADACAO_OFFICIAL_SOURCE_URL
+ */
+
+type ArrecadacaoInputKind = 'arrecadacao-linha' | 'arrecadacao-codigo-barras';
+type ArrecadacaoValidationResult = {
+    ok: true;
+    value: string;
+    inputKind: ArrecadacaoInputKind;
+    format: 'arrecadacao';
+    segment: string;
+    valueType: ArrecadacaoValueType;
+} | {
+    ok: false;
+    code: ValidationErrorCode;
+    message: string;
+    inputKind?: ArrecadacaoInputKind;
+};
+declare function stripArrecadacao(input: string): string;
+declare function linhaArrecadacaoToCodigoBarras(linha: string): string;
+declare function validateArrecadacaoLinha(input: string): ArrecadacaoValidationResult;
+declare function validateArrecadacaoCodigoBarras(input: string): ArrecadacaoValidationResult;
+declare function validateArrecadacao(input: string): ArrecadacaoValidationResult;
+declare function isValidArrecadacao(input: string): boolean;
+/** @internal Golden vector helper — builds valid barcode then linha. */
+declare function buildArrecadacaoGoldenPair(options: {
+    segment: string;
+    valueType: ArrecadacaoValueType;
+    value: string;
+    company: string;
+    free: string;
+}): {
+    barcode: string;
+    linha: string;
+};
+
 /**
  * Boleto validation — linha digitável + código de barras (FEBRABAN cobrança).
  * @see docs/use-cases/UC-007-validate-boleto.md
@@ -110,4 +163,4 @@ declare function convertCodigoBarrasToLinhaDigitavel(input: string): BoletoValid
 
 declare function formatBoleto(input: string): FormatResult;
 
-export { BOLETO_CODE_ISPB_HOLDER, BOLETO_CODIGO_BARRAS_LENGTH, BOLETO_CURRENCY_ISPB, BOLETO_CURRENCY_REAL, BOLETO_GOLDEN_CODIGO_BARRAS, BOLETO_GOLDEN_CODIGO_BARRAS_BB, BOLETO_GOLDEN_CODIGO_BARRAS_SITUACAO2, BOLETO_GOLDEN_LINHA_BB_STRIPPED, BOLETO_GOLDEN_LINHA_MASKED, BOLETO_GOLDEN_LINHA_SITUACAO2_STRIPPED, BOLETO_GOLDEN_LINHA_STRIPPED, BOLETO_LAYOUTS_PORTAL_URL, BOLETO_LINHA_LENGTH, BOLETO_OFFICIAL_SOURCE_URL, BoletoInputKind, type BoletoSituacaoCode, type BoletoSituacaoKind, BoletoValidationResult, type DetectedBoletoInputKind, type FatorVencimentoValidationResult, type ValidateBoletoOptions, ValidationErrorCode, type ValorDocumentoValidationResult, applyLinhaDigitavelMask, computeModulo10FieldDv, computeModulo11BarcodeDv, convertCodigoBarrasToLinhaDigitavel, convertCodigoBarrasToLinhaDigits, convertLinhaToCodigoBarras, convertLinhaToCodigoBarrasDigits, detectBoletoInputKind, detectBoletoSituacao, formatBoleto, formatLinhaDigitavel, isValidBoleto, stripCodigoBarras, stripLinhaDigitavel, validateBoleto, validateCodigoBarras, validateFatorVencimento, validateLinhaDigitavel, validateValorDocumento };
+export { type ArrecadacaoInputKind, type ArrecadacaoValidationResult, type ArrecadacaoValueType, BOLETO_ARRECADACAO_CODIGO_BARRAS_LENGTH, BOLETO_ARRECADACAO_LINHA_LENGTH, BOLETO_ARRECADACAO_OFFICIAL_SOURCE_URL, BOLETO_ARRECADACAO_PRODUCT_ID, BOLETO_CODE_ISPB_HOLDER, BOLETO_CODIGO_BARRAS_LENGTH, BOLETO_CURRENCY_ISPB, BOLETO_CURRENCY_REAL, BOLETO_GOLDEN_CODIGO_BARRAS, BOLETO_GOLDEN_CODIGO_BARRAS_BB, BOLETO_GOLDEN_CODIGO_BARRAS_SITUACAO2, BOLETO_GOLDEN_LINHA_BB_STRIPPED, BOLETO_GOLDEN_LINHA_MASKED, BOLETO_GOLDEN_LINHA_SITUACAO2_STRIPPED, BOLETO_GOLDEN_LINHA_STRIPPED, BOLETO_LAYOUTS_PORTAL_URL, BOLETO_LINHA_LENGTH, BOLETO_OFFICIAL_SOURCE_URL, BoletoInputKind, type BoletoSituacaoCode, type BoletoSituacaoKind, BoletoValidationResult, type DetectedBoletoInputKind, type FatorVencimentoValidationResult, type ValidateBoletoOptions, ValidationErrorCode, type ValorDocumentoValidationResult, applyLinhaDigitavelMask, buildArrecadacaoGoldenPair, computeModulo10FieldDv as computeArrecadacaoModulo10Dv, computeArrecadacaoModulo11Dv, computeModulo10FieldDv, computeModulo11BarcodeDv, convertCodigoBarrasToLinhaDigitavel, convertCodigoBarrasToLinhaDigits, convertLinhaToCodigoBarras, convertLinhaToCodigoBarrasDigits, detectBoletoInputKind, detectBoletoSituacao, formatBoleto, formatLinhaDigitavel, getArrecadacaoDvCalculator, isArrecadacaoValueType, isValidArrecadacao, isValidBoleto, linhaArrecadacaoToCodigoBarras, stripArrecadacao, stripCodigoBarras, stripLinhaDigitavel, validateArrecadacao, validateArrecadacaoCodigoBarras, validateArrecadacaoLinha, validateBoleto, validateCodigoBarras, validateFatorVencimento, validateLinhaDigitavel, validateValorDocumento };

package/dist/boleto.js

@@ -1,5 +1,8 @@
-export { formatBoleto } from './chunk-FXLVNCG3.js';
-export { BOLETO_CODE_ISPB_HOLDER, BOLETO_CODIGO_BARRAS_LENGTH, BOLETO_CURRENCY_ISPB, BOLETO_CURRENCY_REAL, BOLETO_GOLDEN_CODIGO_BARRAS, BOLETO_GOLDEN_CODIGO_BARRAS_BB, BOLETO_GOLDEN_CODIGO_BARRAS_SITUACAO2, BOLETO_GOLDEN_LINHA_BB_STRIPPED, BOLETO_GOLDEN_LINHA_MASKED, BOLETO_GOLDEN_LINHA_SITUACAO2_STRIPPED, BOLETO_GOLDEN_LINHA_STRIPPED, BOLETO_LAYOUTS_PORTAL_URL, BOLETO_LINHA_LENGTH, BOLETO_OFFICIAL_SOURCE_URL, applyLinhaDigitavelMask, computeModulo10FieldDv, computeModulo11BarcodeDv, convertCodigoBarrasToLinhaDigitavel, convertCodigoBarrasToLinhaDigits, convertLinhaToCodigoBarras, convertLinhaToCodigoBarrasDigits, detectBoletoInputKind, detectBoletoSituacao, formatLinhaDigitavel, isValidBoleto, stripCodigoBarras, stripLinhaDigitavel, validateBoleto, validateCodigoBarras, validateFatorVencimento, validateLinhaDigitavel, validateValorDocumento } from './chunk-4W4OKLSZ.js';
-import './chunk-MSLJF2FM.js';
+import './chunk-KBNWI6GE.js';
+export { formatBoleto } from './chunk-XWHGXSQV.js';
+export { convertCodigoBarrasToLinhaDigitavel, convertLinhaToCodigoBarras, isValidBoleto, validateBoleto, validateFatorVencimento, validateValorDocumento } from './chunk-AU6TW3GH.js';
+export { buildArrecadacaoGoldenPair, computeArrecadacaoModulo11Dv, getArrecadacaoDvCalculator, isArrecadacaoValueType, isValidArrecadacao, linhaArrecadacaoToCodigoBarras, stripArrecadacao, stripCodigoBarras, validateArrecadacao, validateArrecadacaoCodigoBarras, validateArrecadacaoLinha, validateCodigoBarras } from './chunk-N6RQICAP.js';
+export { BOLETO_ARRECADACAO_CODIGO_BARRAS_LENGTH, BOLETO_ARRECADACAO_LINHA_LENGTH, BOLETO_ARRECADACAO_OFFICIAL_SOURCE_URL, BOLETO_ARRECADACAO_PRODUCT_ID, BOLETO_CODE_ISPB_HOLDER, BOLETO_CODIGO_BARRAS_LENGTH, BOLETO_CURRENCY_ISPB, BOLETO_CURRENCY_REAL, BOLETO_GOLDEN_CODIGO_BARRAS, BOLETO_GOLDEN_CODIGO_BARRAS_BB, BOLETO_GOLDEN_CODIGO_BARRAS_SITUACAO2, BOLETO_GOLDEN_LINHA_BB_STRIPPED, BOLETO_GOLDEN_LINHA_MASKED, BOLETO_GOLDEN_LINHA_SITUACAO2_STRIPPED, BOLETO_GOLDEN_LINHA_STRIPPED, BOLETO_LAYOUTS_PORTAL_URL, BOLETO_LINHA_LENGTH, BOLETO_OFFICIAL_SOURCE_URL, applyLinhaDigitavelMask, computeModulo10FieldDv as computeArrecadacaoModulo10Dv, computeModulo10FieldDv, computeModulo11BarcodeDv, convertCodigoBarrasToLinhaDigits, convertLinhaToCodigoBarrasDigits, detectBoletoInputKind, detectBoletoSituacao, formatLinhaDigitavel, stripLinhaDigitavel, validateLinhaDigitavel } from './chunk-E2EFGMWA.js';
+import './chunk-NUQSMT4Y.js';
 //# sourceMappingURL=boleto.js.map
 //# sourceMappingURL=boleto.js.map

package/dist/brcode.d.ts

@@ -1,5 +1,5 @@
-import { p as PixKey, q as PixKeyType, V as ValidationErrorCode, d as BrCodeValidationResult } from './validation-result-BhQE-1_O.js';
-export { c as BrCodePayload } from './validation-result-BhQE-1_O.js';
+import { p as PixKey, q as PixKeyType, V as ValidationErrorCode, d as BrCodeValidationResult } from './validation-result-BaI2Xder.js';
+export { c as BrCodePayload } from './validation-result-BaI2Xder.js';
 
 /** Bacen Manual BR Code — EMV-QRCPS-MPM TLV + CRC16-CCITT */
 declare const BRCODE_OFFICIAL_SOURCE_URL = "https://www.bcb.gov.br/content/estabilidadefinanceira/spb_docs/ManualBRCode.pdf";
@@ -24,6 +24,18 @@ declare function verifyBrCodeCrc(payload: string): {
     message: string;
 };
 
+type StaticPixBrCodeInput = {
+    pixKey: string;
+    merchantName: string;
+    merchantCity: string;
+    /** Omit for permanent static QR (payer sets amount). Decimal with up to 2 fraction digits. */
+    amount?: string;
+    /** Defaults to `***` per Manual de Padrões PIX static QR. */
+    txid?: string;
+};
+/** Build static PIX BR Code EMV payload. Validate output with `validateBrCode`. */
+declare function buildStaticPixBrCode(input: StaticPixBrCodeInput): string;
+
 type BrCodeParsedFields = {
     merchantName: string;
     merchantCity: string;
@@ -76,4 +88,4 @@ declare function isValidBrCode(input: string): boolean;
 declare function parseBrCode(input: string): BrCodeValidationResult;
 declare function validateBrCode(input: string): BrCodeValidationResult;
 
-export { BRCODE_GOLDEN_COMPOSITE, BRCODE_GOLDEN_DYNAMIC_URL, BRCODE_GOLDEN_STATIC_CPF, BRCODE_GOLDEN_STATIC_EMAIL, BRCODE_GOLDEN_STATIC_EVP, BRCODE_OFFICIAL_SOURCE_URL, BRCODE_PIX_INITIATION_MANUAL_URL, type BrCodeParseResult, type BrCodeParsedFields, BrCodeValidationResult, PixKeyType, type TlvField, type TlvParseResult, computeCrc16Ccitt, findPixMerchantAccount, findTlvField, isValidBrCode, normalizeBrCodePayload, parseBrCode, parseBrCodePayload, parseTlvSequence, validateBrCode, verifyBrCodeCrc };
+export { BRCODE_GOLDEN_COMPOSITE, BRCODE_GOLDEN_DYNAMIC_URL, BRCODE_GOLDEN_STATIC_CPF, BRCODE_GOLDEN_STATIC_EMAIL, BRCODE_GOLDEN_STATIC_EVP, BRCODE_OFFICIAL_SOURCE_URL, BRCODE_PIX_INITIATION_MANUAL_URL, type BrCodeParseResult, type BrCodeParsedFields, BrCodeValidationResult, PixKeyType, type StaticPixBrCodeInput, type TlvField, type TlvParseResult, buildStaticPixBrCode, computeCrc16Ccitt, findPixMerchantAccount, findTlvField, isValidBrCode, normalizeBrCodePayload, parseBrCode, parseBrCodePayload, parseTlvSequence, validateBrCode, verifyBrCodeCrc };