@br-validators/cli 0.11.0-alpha.0 → 0.12.0-alpha.1

package/README.md

@@ -20,45 +20,87 @@ npx @br-validators/cli --help
 
 ---
 
-## Commands
+## Global commands
 
 ```bash
 br-validators list
 br-validators --version
+br-validators --help
+```
+
+---
+
+## Per-type commands
 
+```bash
 br-validators cnpj validate 12ABC34501DE35 --json --source
 br-validators cpf validate 12345678909
 br-validators cep format 01310100
+br-validators telefone validate 11999999999
+br-validators cnh validate 62472927637
+br-validators renavam validate 63977791104
+br-validators titulo-eleitor validate 004356870906
+br-validators nfe-chave validate 52060433009911002506550120000007800267301615 --json
+br-validators nfe-chave parse 52060433009911002506550120000007800267301615 --json
+br-validators brcode validate '<emv-payload>' --json
 br-validators placa validate ABC1D23
 br-validators pis-pasep validate 10027230888
 br-validators pix validate pix@bcb.gov.br
-br-validators boleto validate <linha-ou-barcode>
+br-validators boleto validate '03399.02579 08991.834006 71742.301014 6 14500000099668'
 br-validators cartao validate 4111111111111111
+br-validators cartao-credito validate 4111111111111111
 br-validators ie validate 110042490114 --uf SP --json
+br-validators ie validate P-01100424.3/002 --uf SP   # SP produtor rural (auto-detect)
 ```
 
-### Actions (all types)
+### Actions (per-type)
 
 | Action | Description |
 |--------|-------------|
 | `validate` | Check format + check digits |
 | `format` | Apply official mask |
 | `strip` | Normalize to canonical digits/chars |
+| `parse` | NF-e chave, BR Code |
+| `convert` | Boleto linha ↔ barcode; placa legacy → Mercosul |
+| `detect` | PIX key type; boleto input kind; cartão brand |
+
+---
+
+## Platform commands
+
+| Command | Description |
+|---------|-------------|
+| `detect [value]` | Classify raw input; `--uf` for IE |
+| `sanitize <type> [value]` | ETL fixes + validate; `--uf` for `inscricao-estadual` |
+| `generate <type>` | Synthetic test document; `--seed`, `--masked`, `--format` |
+
+```bash
+br-validators detect '123.456.789-09' --json
+br-validators detect '110042490114' --uf SP --json
+br-validators sanitize cpf ' 123.456.789-09 ' --json
+br-validators sanitize inscricao-estadual '110.042.490.114' --uf SP --json
+br-validators generate cpf --seed 42 --masked --json
+br-validators generate cnpj --format alphanumeric --seed 7 --json
+br-validators generate placa --format mercosul --seed 3
+```
+
+---
 
-### Flags
+## Flags
 
 | Flag | Description |
 |------|-------------|
-| `--json` | JSON output (`ValidationResult`) |
+| `--json` | JSON output |
 | `--quiet` / `-q` | Exit code only (CI) |
 | `--file` / `-f` | Read value from file |
-| `--source` | Print official source URL |
-| `--uf` | Required for IE (27 UFs) |
+| `--source` | Print official source URL (per-type) |
+| `--uf` | Required for IE / detect / sanitize IE |
 
 ### CI
 
 ```bash
 br-validators cnpj validate "$CNPJ" --quiet || exit 1
+br-validators detect "$RAW_INPUT" --json --quiet || exit 1
 ```
 
 ---

package/dist/index.js

@@ -14,7 +14,7 @@ import {
 } from "@br-validators/core";
 
 // src/constants.ts
-var SUPPORTED_TYPES = ["cnpj", "cpf", "cep", "telefone", "brcode", "placa", "pis-pasep", "pix", "boleto", "cartao", "ie"];
+var SUPPORTED_TYPES = ["cnpj", "cpf", "cep", "telefone", "cnh", "renavam", "titulo-eleitor", "nfe-chave", "brcode", "placa", "pis-pasep", "pix", "boleto", "cartao", "ie"];
 var EXIT = {
   OK: 0,
   INVALID: 1,
@@ -136,6 +136,46 @@ function printValidation(result, options, io = { stdout: [], stderr: [] }) {
   io.stderr.push(`message: ${result.message}`);
   return EXIT.INVALID;
 }
+function printNfeChaveValidation(result, options, io = { stdout: [], stderr: [] }) {
+  if (options.json) {
+    io.stdout.push(
+      JSON.stringify(
+        result.ok ? {
+          ok: true,
+          value: result.value,
+          format: result.format,
+          parsed: result.parsed,
+          ...result.uf ? { uf: result.uf } : {},
+          ...options.source ? { source: options.source } : {}
+        } : { ok: false, code: result.code, message: result.message },
+        null,
+        2
+      )
+    );
+    return result.ok ? EXIT.OK : EXIT.INVALID;
+  }
+  if (options.quiet) {
+    return result.ok ? EXIT.OK : EXIT.INVALID;
+  }
+  if (result.ok) {
+    io.stdout.push(`valid: yes (${result.format})`);
+    io.stdout.push(`value: ${result.value}`);
+    io.stdout.push(`cUF: ${result.parsed.cUF}`);
+    io.stdout.push(`cnpj: ${result.parsed.cnpj}`);
+    io.stdout.push(`mod: ${result.parsed.mod}`);
+    if (result.uf) {
+      io.stdout.push(`uf: ${result.uf}`);
+    }
+    if (options.source) {
+      io.stdout.push(`source: ${options.source}`);
+    }
+    return EXIT.OK;
+  }
+  io.stderr.push("valid: no");
+  io.stderr.push(`code: ${result.code}`);
+  io.stderr.push(`message: ${result.message}`);
+  return EXIT.INVALID;
+}
 function printFormat(result, options, io = { stdout: [], stderr: [] }) {
   if (options.json) {
     io.stdout.push(JSON.stringify(result, null, 2));
@@ -267,6 +307,165 @@ function runTelefone(action, value, options, io = { stdout: [], stderr: [] }) {
   return runTelefoneCommand(action, input, options, io);
 }
 
+// src/commands/cnh.ts
+import {
+  CNH_OFFICIAL_SOURCE_URL,
+  formatCnh,
+  stripCnh,
+  validateCnh
+} from "@br-validators/core";
+function resolveInput4(value, fileContent) {
+  const input = value ?? fileContent?.trim();
+  if (!input) {
+    return null;
+  }
+  return input;
+}
+function runCnhCommand(action, input, options, io = { stdout: [], stderr: [] }) {
+  const source = options.source ? CNH_OFFICIAL_SOURCE_URL : void 0;
+  switch (action) {
+    case "validate":
+      return printValidation(validateCnh(input), { json: options.json, quiet: options.quiet, source }, io);
+    case "format":
+      return printFormat(formatCnh(input), { json: options.json, quiet: options.quiet }, io);
+    case "strip":
+      return printStrip(stripCnh(input), { json: options.json }, io);
+    default: {
+      const _exhaustive = action;
+      io.stderr.push(`Unknown action: ${_exhaustive}`);
+      return EXIT.USAGE;
+    }
+  }
+}
+function runCnh(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput4(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing CNH value. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  return runCnhCommand(action, input, options, io);
+}
+
+// src/commands/renavam.ts
+import {
+  RENAVAM_OFFICIAL_SOURCE_URL,
+  formatRenavam,
+  stripRenavam,
+  validateRenavam
+} from "@br-validators/core";
+function resolveInput5(value, fileContent) {
+  const input = value ?? fileContent?.trim();
+  if (!input) {
+    return null;
+  }
+  return input;
+}
+function runRenavamCommand(action, input, options, io = { stdout: [], stderr: [] }) {
+  const source = options.source ? RENAVAM_OFFICIAL_SOURCE_URL : void 0;
+  switch (action) {
+    case "validate":
+      return printValidation(validateRenavam(input), { json: options.json, quiet: options.quiet, source }, io);
+    case "format":
+      return printFormat(formatRenavam(input), { json: options.json, quiet: options.quiet }, io);
+    case "strip":
+      return printStrip(stripRenavam(input), { json: options.json }, io);
+    default: {
+      const _exhaustive = action;
+      io.stderr.push(`Unknown action: ${_exhaustive}`);
+      return EXIT.USAGE;
+    }
+  }
+}
+function runRenavam(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput5(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing RENAVAM value. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  return runRenavamCommand(action, input, options, io);
+}
+
+// src/commands/titulo-eleitor.ts
+import {
+  TITULO_ELEITOR_OFFICIAL_SOURCE_URL,
+  formatTituloEleitor,
+  stripTituloEleitor,
+  validateTituloEleitor
+} from "@br-validators/core";
+function resolveInput6(value, fileContent) {
+  const input = value ?? fileContent?.trim();
+  if (!input) {
+    return null;
+  }
+  return input;
+}
+function runTituloEleitorCommand(action, input, options, io = { stdout: [], stderr: [] }) {
+  const source = options.source ? TITULO_ELEITOR_OFFICIAL_SOURCE_URL : void 0;
+  switch (action) {
+    case "validate":
+      return printValidation(validateTituloEleitor(input), { json: options.json, quiet: options.quiet, source }, io);
+    case "format":
+      return printFormat(formatTituloEleitor(input), { json: options.json, quiet: options.quiet }, io);
+    case "strip":
+      return printStrip(stripTituloEleitor(input), { json: options.json }, io);
+    default: {
+      const _exhaustive = action;
+      io.stderr.push(`Unknown action: ${_exhaustive}`);
+      return EXIT.USAGE;
+    }
+  }
+}
+function runTituloEleitor(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput6(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing T\xEDtulo de Eleitor value. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  return runTituloEleitorCommand(action, input, options, io);
+}
+
+// src/commands/nfe-chave.ts
+import {
+  NFE_CHAVE_OFFICIAL_SOURCE_URL,
+  formatNfeChave,
+  parseNfeChave,
+  stripNfeChave,
+  validateNfeChave
+} from "@br-validators/core";
+function resolveInput7(value, fileContent) {
+  const input = value ?? fileContent?.trim();
+  if (!input) {
+    return null;
+  }
+  return input;
+}
+function runNfeChaveCommand(action, input, options, io = { stdout: [], stderr: [] }) {
+  const source = options.source ? NFE_CHAVE_OFFICIAL_SOURCE_URL : void 0;
+  switch (action) {
+    case "validate":
+      return printValidation(validateNfeChave(input), { json: options.json, quiet: options.quiet, source }, io);
+    case "parse":
+      return printNfeChaveValidation(parseNfeChave(input), { json: options.json, quiet: options.quiet, source }, io);
+    case "format":
+      return printFormat(formatNfeChave(input), { json: options.json, quiet: options.quiet }, io);
+    case "strip":
+      return printStrip(stripNfeChave(input), { json: options.json }, io);
+    default: {
+      const _exhaustive = action;
+      io.stderr.push(`Unknown action: ${_exhaustive}`);
+      return EXIT.USAGE;
+    }
+  }
+}
+function runNfeChave(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput7(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing NF-e chave de acesso value. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  return runNfeChaveCommand(action, input, options, io);
+}
+
 // src/commands/cnpj.ts
 import {
   CNPJ_OFFICIAL_SOURCE_URL,
@@ -274,7 +473,7 @@ import {
   stripCnpj,
   validateCnpj
 } from "@br-validators/core";
-function resolveInput4(value, fileContent) {
+function resolveInput8(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -298,7 +497,7 @@ function runCnpjCommand(action, input, options, io = { stdout: [], stderr: [] })
   }
 }
 function runCnpj(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput4(value, options.file);
+  const input = resolveInput8(value, options.file);
   if (input === null) {
     io.stderr.push("Missing CNPJ value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -313,7 +512,7 @@ import {
   stripCpf,
   validateCpf
 } from "@br-validators/core";
-function resolveInput5(value, fileContent) {
+function resolveInput9(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -337,7 +536,7 @@ function runCpfCommand(action, input, options, io = { stdout: [], stderr: [] })
   }
 }
 function runCpf(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput5(value, options.file);
+  const input = resolveInput9(value, options.file);
   if (input === null) {
     io.stderr.push("Missing CPF value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -353,7 +552,7 @@ import {
   stripPlaca,
   validatePlaca
 } from "@br-validators/core";
-function resolveInput6(value, fileContent) {
+function resolveInput10(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -379,7 +578,7 @@ function runPlacaCommand(action, input, options, io = { stdout: [], stderr: [] }
   }
 }
 function runPlaca(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput6(value, options.file);
+  const input = resolveInput10(value, options.file);
   if (input === null) {
     io.stderr.push("Missing placa value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -394,7 +593,7 @@ import {
   stripPisPasep,
   validatePisPasep
 } from "@br-validators/core";
-function resolveInput7(value, fileContent) {
+function resolveInput11(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -418,7 +617,7 @@ function runPisPasepCommand(action, input, options, io = { stdout: [], stderr: [
   }
 }
 function runPisPasep(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput7(value, options.file);
+  const input = resolveInput11(value, options.file);
   if (input === null) {
     io.stderr.push("Missing PIS/PASEP value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -433,7 +632,7 @@ import {
   formatPixKey,
   validatePixKey
 } from "@br-validators/core";
-function resolveInput8(value, fileContent) {
+function resolveInput12(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -508,7 +707,7 @@ function runPixCommand(action, input, options, io = { stdout: [], stderr: [] })
   }
 }
 function runPix(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput8(value, options.file);
+  const input = resolveInput12(value, options.file);
   if (input === null) {
     io.stderr.push("Missing PIX key value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -527,7 +726,7 @@ import {
   stripLinhaDigitavel,
   validateBoleto
 } from "@br-validators/core";
-function resolveInput9(value, fileContent) {
+function resolveInput13(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -651,7 +850,7 @@ function runBoletoCommand(action, input, options, direction, io = { stdout: [],
   }
 }
 function runBoleto(action, value, options, direction, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput9(value, options.file);
+  const input = resolveInput13(value, options.file);
   if (input === null) {
     io.stderr.push("Missing boleto value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -667,7 +866,7 @@ import {
   stripCartaoCredito,
   validateCartaoCredito
 } from "@br-validators/core";
-function resolveInput10(value, fileContent) {
+function resolveInput14(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -743,7 +942,7 @@ function runCartaoCommand(action, input, options, io = { stdout: [], stderr: []
   }
 }
 function runCartao(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput10(value, options.file);
+  const input = resolveInput14(value, options.file);
   if (input === null) {
     io.stderr.push("Missing credit card PAN value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -753,13 +952,18 @@ function runCartao(action, value, options, io = { stdout: [], stderr: [] }) {
 
 // src/commands/ie.ts
 import {
+  formatIeProdutorRural,
   formatInscricaoEstadual,
   getIeOfficialSourceUrl,
+  getIeProdutorRuralOfficialSourceUrl,
   IE_SUPPORTED_UFS,
+  isSpRuralIeInput,
+  stripIeSpRural,
   stripInscricaoEstadual,
+  validateIeProdutorRural,
   validateInscricaoEstadual
 } from "@br-validators/core";
-function resolveInput11(value, fileContent) {
+function resolveInput15(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -776,6 +980,9 @@ function resolveUf(uf) {
   }
   return null;
 }
+function isSpRuralRoute(uf, input) {
+  return uf === "SP" && isSpRuralIeInput(input);
+}
 function printIeValidation(result, options, io = { stdout: [], stderr: [] }) {
   if (options.json) {
     io.stdout.push(
@@ -785,6 +992,7 @@ function printIeValidation(result, options, io = { stdout: [], stderr: [] }) {
           value: result.value,
           uf: result.uf,
           format: result.format,
+          ...options.rural ? { produtorRural: true } : {},
           ...options.source ? { source: options.source } : {}
         } : {
           ok: false,
@@ -803,6 +1011,9 @@ function printIeValidation(result, options, io = { stdout: [], stderr: [] }) {
   }
   if (result.ok) {
     io.stdout.push(`valid: yes (${result.uf})`);
+    if (options.rural) {
+      io.stdout.push("kind: produtor-rural");
+    }
     io.stdout.push(`value: ${result.value}`);
     io.stdout.push(`format: ${result.format}`);
     if (options.source) {
@@ -824,14 +1035,23 @@ function runIeCommand(action, input, options, io = { stdout: [], stderr: [] }) {
     io.stderr.push(`Missing or invalid --uf. Use one of: ${IE_SUPPORTED_UFS.join(", ")}.`);
     return EXIT.USAGE;
   }
-  const source = options.source ? getIeOfficialSourceUrl(uf) : void 0;
+  const rural = isSpRuralRoute(uf, input);
+  const source = options.source ? rural ? getIeProdutorRuralOfficialSourceUrl() : getIeOfficialSourceUrl(uf) : void 0;
   switch (action) {
     case "validate":
-      return printIeValidation(validateInscricaoEstadual(input, { uf }), { json: options.json, quiet: options.quiet, source }, io);
+      return printIeValidation(
+        rural ? validateIeProdutorRural(uf, input) : validateInscricaoEstadual(input, { uf }),
+        { json: options.json, quiet: options.quiet, source, rural },
+        io
+      );
     case "format":
-      return printFormat(formatInscricaoEstadual(input, { uf }), { json: options.json, quiet: options.quiet }, io);
+      return printFormat(
+        rural ? formatIeProdutorRural(input) : formatInscricaoEstadual(input, { uf }),
+        { json: options.json, quiet: options.quiet },
+        io
+      );
     case "strip":
-      return printStrip(stripInscricaoEstadual(input), { json: options.json }, io);
+      return printStrip(rural ? stripIeSpRural(input) : stripInscricaoEstadual(input), { json: options.json }, io);
     default: {
       const _exhaustive = action;
       io.stderr.push(`Unknown action: ${_exhaustive}`);
@@ -840,7 +1060,7 @@ function runIeCommand(action, input, options, io = { stdout: [], stderr: [] }) {
   }
 }
 function runIe(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput11(value, options.file);
+  const input = resolveInput15(value, options.file);
   if (input === null) {
     io.stderr.push("Missing IE value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -848,6 +1068,163 @@ function runIe(action, value, options, io = { stdout: [], stderr: [] }) {
   return runIeCommand(action, input, options, io);
 }
 
+// src/commands/detect.ts
+import { detect } from "@br-validators/core";
+function resolveInput16(value, fileContent) {
+  const input = value ?? fileContent?.trim();
+  if (!input) {
+    return null;
+  }
+  return input;
+}
+function printDetect(result, options, io = { stdout: [], stderr: [] }) {
+  if (options.json) {
+    io.stdout.push(JSON.stringify(result, null, 2));
+    return result.ok ? EXIT.OK : EXIT.INVALID;
+  }
+  if (options.quiet) {
+    return result.ok ? EXIT.OK : EXIT.INVALID;
+  }
+  if (result.ok) {
+    io.stdout.push(`type: ${result.type}`);
+    io.stdout.push("valid: yes");
+    io.stdout.push(`value: ${result.value}`);
+    if (result.format) {
+      io.stdout.push(`format: ${result.format}`);
+    }
+    if (result.meta) {
+      io.stdout.push(`meta: ${JSON.stringify(result.meta)}`);
+    }
+    return EXIT.OK;
+  }
+  io.stderr.push(`type: ${result.type}`);
+  io.stderr.push("valid: no");
+  io.stderr.push(`code: ${result.code}`);
+  io.stderr.push(`message: ${result.message}`);
+  return EXIT.INVALID;
+}
+function runDetect(value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput16(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing value. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  const uf = options.uf?.toUpperCase();
+  const result = detect(input, uf ? { uf } : {});
+  return printDetect(result, options, io);
+}
+
+// src/commands/sanitize.ts
+import { sanitize } from "@br-validators/core";
+var SANITIZABLE_TYPES = [
+  "cpf",
+  "cnpj",
+  "cep",
+  "placa",
+  "pis-pasep",
+  "telefone",
+  "cnh",
+  "renavam",
+  "titulo-eleitor",
+  "nfe-chave",
+  "boleto",
+  "cartao-credito",
+  "inscricao-estadual",
+  "inscricao-estadual-produtor-rural"
+];
+function isSanitizableType(type) {
+  return SANITIZABLE_TYPES.includes(type);
+}
+function resolveInput17(value, fileContent) {
+  const input = value ?? fileContent?.trim();
+  if (!input) {
+    return null;
+  }
+  return input;
+}
+function printSanitize(result, options, io = { stdout: [], stderr: [] }) {
+  if (options.json) {
+    io.stdout.push(JSON.stringify(result, null, 2));
+    return result.ok ? EXIT.OK : EXIT.INVALID;
+  }
+  if (options.quiet) {
+    return result.ok ? EXIT.OK : EXIT.INVALID;
+  }
+  if (result.ok) {
+    io.stdout.push("valid: yes");
+    io.stdout.push(`value: ${result.value}`);
+    io.stdout.push(`fixes: ${result.fixes.join(", ")}`);
+    return EXIT.OK;
+  }
+  io.stderr.push("valid: no");
+  io.stderr.push(`code: ${result.code}`);
+  io.stderr.push(`message: ${result.message}`);
+  return EXIT.INVALID;
+}
+function runSanitize(type, value, options, io = { stdout: [], stderr: [] }) {
+  if (!isSanitizableType(type)) {
+    io.stderr.push(`Unsupported sanitize type: ${type}`);
+    return EXIT.USAGE;
+  }
+  const input = resolveInput17(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing value. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  const uf = options.uf?.toUpperCase();
+  const result = sanitize(input, type, uf ? { uf } : {});
+  return printSanitize(result, options, io);
+}
+
+// src/commands/generate.ts
+import { generate } from "@br-validators/core";
+var GENERATABLE_TYPES = [
+  "cpf",
+  "cnpj",
+  "cep",
+  "placa",
+  "pis-pasep",
+  "renavam",
+  "cnh",
+  "telefone",
+  "cartao-credito"
+];
+function isGeneratableType(type) {
+  return GENERATABLE_TYPES.includes(type);
+}
+function buildGenerateOptions(options) {
+  const core = {};
+  if (options.masked) {
+    core.masked = true;
+  }
+  if (options.seed !== void 0) {
+    core.seed = options.seed;
+  }
+  if (options.format) {
+    core.format = options.format;
+  }
+  return core;
+}
+function printGenerate(value, options, io = { stdout: [], stderr: [] }) {
+  if (options.json) {
+    io.stdout.push(JSON.stringify({ ok: true, value }, null, 2));
+    return EXIT.OK;
+  }
+  if (options.quiet) {
+    return EXIT.OK;
+  }
+  io.stdout.push(value);
+  return EXIT.OK;
+}
+function runGenerate(type, options, io = { stdout: [], stderr: [] }) {
+  if (!isGeneratableType(type)) {
+    io.stderr.push(`Unsupported generate type: ${type}`);
+    return EXIT.USAGE;
+  }
+  const value = generate(type, buildGenerateOptions(options));
+  return printGenerate(value, options, io);
+}
+
 // src/commands/list.ts
 function listSupportedTypes(io = { stdout: [] }) {
   for (const type of SUPPORTED_TYPES) {
@@ -952,6 +1329,27 @@ function handleTelefoneCli(action, value, opts, io = { stdout: [], stderr: [] })
     io
   );
 }
+function handleCnhCli(action, value, opts, io = { stdout: [], stderr: [] }) {
+  let fileContent;
+  if (opts.file) {
+    const content = readInputFile(opts.file, io);
+    if (content === null) {
+      return EXIT.USAGE;
+    }
+    fileContent = content;
+  }
+  return runCnh(
+    action,
+    value,
+    {
+      json: Boolean(opts.json),
+      quiet: Boolean(opts.quiet),
+      source: Boolean(opts.source),
+      file: fileContent
+    },
+    io
+  );
+}
 function handlePlacaCli(action, value, opts, io = { stdout: [], stderr: [] }) {
   let fileContent;
   if (opts.file) {
@@ -1081,6 +1479,69 @@ function handleCartaoCreditoCli(action, value, opts, io = { stdout: [], stderr:
     io
   );
 }
+function handleRenavamCli(action, value, opts, io = { stdout: [], stderr: [] }) {
+  let fileContent;
+  if (opts.file) {
+    const content = readInputFile(opts.file, io);
+    if (content === null) {
+      return EXIT.USAGE;
+    }
+    fileContent = content;
+  }
+  return runRenavam(
+    action,
+    value,
+    {
+      json: Boolean(opts.json),
+      quiet: Boolean(opts.quiet),
+      source: Boolean(opts.source),
+      file: fileContent
+    },
+    io
+  );
+}
+function handleTituloEleitorCli(action, value, opts, io = { stdout: [], stderr: [] }) {
+  let fileContent;
+  if (opts.file) {
+    const content = readInputFile(opts.file, io);
+    if (content === null) {
+      return EXIT.USAGE;
+    }
+    fileContent = content;
+  }
+  return runTituloEleitor(
+    action,
+    value,
+    {
+      json: Boolean(opts.json),
+      quiet: Boolean(opts.quiet),
+      source: Boolean(opts.source),
+      file: fileContent
+    },
+    io
+  );
+}
+function handleNfeChaveCli(action, value, opts, io = { stdout: [], stderr: [] }) {
+  let fileContent;
+  if (opts.file) {
+    const content = readInputFile(opts.file, io);
+    if (content === null) {
+      return EXIT.USAGE;
+    }
+    fileContent = content;
+  }
+  return runNfeChave(
+    action,
+    value,
+    {
+      json: Boolean(opts.json),
+      quiet: Boolean(opts.quiet),
+      source: Boolean(opts.source),
+      file: fileContent
+    },
+    io
+  );
+}
 function handleBrCodeCli(action, value, opts, io = { stdout: [], stderr: [] }) {
   let fileContent;
   if (opts.file) {
@@ -1124,6 +1585,60 @@ function handleIeCli(action, value, opts, io = { stdout: [], stderr: [] }) {
     io
   );
 }
+function handleDetectCli(value, opts, io = { stdout: [], stderr: [] }) {
+  let fileContent;
+  if (opts.file) {
+    const content = readInputFile(opts.file, io);
+    if (content === null) {
+      return EXIT.USAGE;
+    }
+    fileContent = content;
+  }
+  return runDetect(
+    value,
+    {
+      json: Boolean(opts.json),
+      quiet: Boolean(opts.quiet),
+      uf: opts.uf,
+      file: fileContent
+    },
+    io
+  );
+}
+function handleSanitizeCli(type, value, opts, io = { stdout: [], stderr: [] }) {
+  let fileContent;
+  if (opts.file) {
+    const content = readInputFile(opts.file, io);
+    if (content === null) {
+      return EXIT.USAGE;
+    }
+    fileContent = content;
+  }
+  return runSanitize(
+    type,
+    value,
+    {
+      json: Boolean(opts.json),
+      quiet: Boolean(opts.quiet),
+      uf: opts.uf,
+      file: fileContent
+    },
+    io
+  );
+}
+function handleGenerateCli(type, opts, io = { stdout: [], stderr: [] }) {
+  return runGenerate(
+    type,
+    {
+      json: Boolean(opts.json),
+      quiet: Boolean(opts.quiet),
+      masked: Boolean(opts.masked),
+      format: opts.format,
+      seed: opts.seed
+    },
+    io
+  );
+}
 function writeCliIo(io) {
   for (const line of io.stdout) console.log(line);
   for (const line of io.stderr) console.error(line);
@@ -1170,6 +1685,38 @@ function createProgram() {
       writeCliIo(io);
     });
   }
+  const cnh = program.command("cnh").description("CNH \u2014 Registro Nacional, 11 contiguous digits (CONTRAN / SENATRAN)");
+  for (const action of ["validate", "format", "strip"]) {
+    cnh.command(action).description(`${action} a CNH`).argument("[value]", "CNH value (11 digits or decorated input)").option("--json", "JSON output").option("-q, --quiet", "Exit code only").option("--source", "Include official source URL (validate only)").option("-f, --file <path>", "Read value from file").action((value, opts) => {
+      const io = { stdout: [], stderr: [] };
+      process.exitCode = handleCnhCli(action, value, opts, io);
+      writeCliIo(io);
+    });
+  }
+  const renavam = program.command("renavam").description("RENAVAM \u2014 11-digit vehicle registry code (DENATRAN / SENATRAN)");
+  for (const action of ["validate", "format", "strip"]) {
+    renavam.command(action).description(`${action} a RENAVAM`).argument("[value]", "RENAVAM value (11 digits or optional dash before DV)").option("--json", "JSON output").option("-q, --quiet", "Exit code only").option("--source", "Include official source URL (validate only)").option("-f, --file <path>", "Read value from file").action((value, opts) => {
+      const io = { stdout: [], stderr: [] };
+      process.exitCode = handleRenavamCli(action, value, opts, io);
+      writeCliIo(io);
+    });
+  }
+  const tituloEleitor = program.command("titulo-eleitor").description("T\xEDtulo de Eleitor \u2014 12-digit voter registration (TSE / Wikipedia PT algorithm)");
+  for (const action of ["validate", "format", "strip"]) {
+    tituloEleitor.command(action).description(`${action} a T\xEDtulo de Eleitor`).argument("[value]", "T\xEDtulo de Eleitor value (12 or 13 digits, spaces allowed)").option("--json", "JSON output").option("-q, --quiet", "Exit code only").option("--source", "Include official source URL (validate only)").option("-f, --file <path>", "Read value from file").action((value, opts) => {
+      const io = { stdout: [], stderr: [] };
+      process.exitCode = handleTituloEleitorCli(action, value, opts, io);
+      writeCliIo(io);
+    });
+  }
+  const nfeChave = program.command("nfe-chave").description("NF-e / NFC-e chave de acesso \u2014 44 digits (SEFAZ MOC \xA72.2.6)");
+  for (const action of ["validate", "parse", "format", "strip"]) {
+    nfeChave.command(action).description(`${action} an NF-e chave de acesso`).argument("[value]", "Chave de acesso (44 digits, spaces allowed)").option("--json", "JSON output").option("-q, --quiet", "Exit code only").option("--source", "Include official source URL (validate/parse only)").option("-f, --file <path>", "Read value from file").action((value, opts) => {
+      const io = { stdout: [], stderr: [] };
+      process.exitCode = handleNfeChaveCli(action, value, opts, io);
+      writeCliIo(io);
+    });
+  }
   const brcode = program.command("brcode").description("BR Code \u2014 PIX QR payload (Bacen EMV TLV)");
   for (const action of ["parse", "validate"]) {
     brcode.command(action).description(`${action} a BR Code payload`).argument("[value]", "BR Code payload (Pix Copia e Cola)").option("--json", "JSON output").option("-q, --quiet", "Exit code only").option("--source", "Include official source URL").option("-f, --file <path>", "Read value from file").action((value, opts) => {
@@ -1265,6 +1812,21 @@ function createProgram() {
       writeCliIo(io);
     });
   }
+  program.command("detect").description("Detect document type from raw input").argument("[value]", "Raw value to classify").option("--uf <uf>", "State code for Inscri\xE7\xE3o Estadual detection").option("--json", "JSON output").option("-q, --quiet", "Exit code only").option("-f, --file <path>", "Read value from file").action((value, opts) => {
+    const io = { stdout: [], stderr: [] };
+    process.exitCode = handleDetectCli(value, opts, io);
+    writeCliIo(io);
+  });
+  program.command("sanitize <type> [value]").description("Sanitize messy input then validate").option("--uf <uf>", "State code (required for inscricao-estadual)").option("--json", "JSON output").option("-q, --quiet", "Exit code only").option("-f, --file <path>", "Read value from file").action((type, value, opts) => {
+    const io = { stdout: [], stderr: [] };
+    process.exitCode = handleSanitizeCli(type, value, opts, io);
+    writeCliIo(io);
+  });
+  program.command("generate <type>").description("Generate synthetic valid test document").option("--json", "JSON output").option("-q, --quiet", "Exit code only").option("--masked", "Return masked/formatted output").option("--format <format>", "Format variant (numeric, alphanumeric, legacy, mercosul, celular, fixo)").option("--seed <number>", "Deterministic PRNG seed", (v) => Number(v)).action((type, opts) => {
+    const io = { stdout: [], stderr: [] };
+    process.exitCode = handleGenerateCli(type, opts, io);
+    writeCliIo(io);
+  });
   return program;
 }
 function run(argv) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@br-validators/cli",
-  "version": "0.11.0-alpha.0",
-  "description": "Terminal CLI for Brazilian document validation — CPF, CNPJ, CEP, IE, PIX, boleto, and more",
+  "version": "0.12.0-alpha.1",
+  "description": "CLI for @br-validators/core — CPF, CNPJ, NF-e, IE, PIX, boleto + detect/sanitize/generate",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -18,7 +18,16 @@
     "cli",
     "validator",
     "cpf",
-    "cnpj"
+    "cnpj",
+    "nfe",
+    "cnh",
+    "renavam",
+    "pix",
+    "boleto",
+    "inscricao-estadual",
+    "detect",
+    "sanitize",
+    "generate"
   ],
   "publishConfig": {
     "access": "public",
@@ -29,7 +38,7 @@
   },
   "dependencies": {
     "commander": "^13.1.0",
-    "@br-validators/core": "0.11.0-alpha.0"
+    "@br-validators/core": "0.12.0-alpha.1"
   },
   "devDependencies": {
     "@types/node": "^22.15.21",