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

package/dist/index.js

@@ -6,22 +6,103 @@ import { Command } from "commander";
 // src/handlers.ts
 import { readFileSync } from "fs";
 
-// src/commands/cep.ts
+// src/commands/brcode.ts
 import {
-  CEP_OFFICIAL_SOURCE_URL,
-  formatCep,
-  stripCep,
-  validateCep
+  BRCODE_OFFICIAL_SOURCE_URL,
+  parseBrCode,
+  validateBrCode
 } from "@br-validators/core";
 
 // src/constants.ts
-var SUPPORTED_TYPES = ["cnpj", "cpf", "cep", "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,
   USAGE: 2
 };
 
+// src/commands/brcode.ts
+function resolveInput(value, fileContent) {
+  const input = value ?? fileContent?.trim();
+  if (!input) {
+    return null;
+  }
+  return input;
+}
+function printBrCodeResult(result, options, io = { stdout: [], stderr: [] }) {
+  if (options.json) {
+    io.stdout.push(
+      JSON.stringify(
+        result.ok ? {
+          ok: true,
+          value: result.value,
+          format: result.format,
+          merchantName: result.merchantName,
+          merchantCity: result.merchantCity,
+          ...result.amount ? { amount: result.amount } : {},
+          ...result.txid ? { txid: result.txid } : {},
+          ...result.pixKey ? { pixKey: result.pixKey, pixKeyType: result.pixKeyType } : {},
+          ...result.pixInitiationUrl ? { pixInitiationUrl: result.pixInitiationUrl } : {},
+          ...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");
+    io.stdout.push(`merchantName: ${result.merchantName}`);
+    io.stdout.push(`merchantCity: ${result.merchantCity}`);
+    if (result.amount) {
+      io.stdout.push(`amount: ${result.amount}`);
+    }
+    if (result.txid) {
+      io.stdout.push(`txid: ${result.txid}`);
+    }
+    if (result.pixKey) {
+      io.stdout.push(`pixKey: ${result.pixKey}`);
+      io.stdout.push(`pixKeyType: ${result.pixKeyType}`);
+    }
+    if (result.pixInitiationUrl) {
+      io.stdout.push(`pixInitiationUrl: ${result.pixInitiationUrl}`);
+    }
+    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 runBrCodeCommand(action, input, options, io = { stdout: [], stderr: [] }) {
+  const source = options.source ? BRCODE_OFFICIAL_SOURCE_URL : void 0;
+  const result = action === "validate" ? validateBrCode(input) : parseBrCode(input);
+  return printBrCodeResult(result, { json: options.json, quiet: options.quiet, source }, io);
+}
+function runBrCode(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing BR Code payload. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  return runBrCodeCommand(action, input, options, io);
+}
+
+// src/commands/cep.ts
+import {
+  CEP_OFFICIAL_SOURCE_URL,
+  formatCep,
+  stripCep,
+  validateCep
+} from "@br-validators/core";
+
 // src/output.ts
 function printValidation(result, options, io = { stdout: [], stderr: [] }) {
   if (options.json) {
@@ -55,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));
@@ -81,7 +202,7 @@ function printStrip(value, options, io = { stdout: [] }) {
 }
 
 // src/commands/cep.ts
-function resolveInput(value, fileContent) {
+function resolveInput2(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -105,7 +226,7 @@ function runCepCommand(action, input, options, io = { stdout: [], stderr: [] })
   }
 }
 function runCep(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput(value, options.file);
+  const input = resolveInput2(value, options.file);
   if (input === null) {
     io.stderr.push("Missing CEP value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -113,6 +234,238 @@ function runCep(action, value, options, io = { stdout: [], stderr: [] }) {
   return runCepCommand(action, input, options, io);
 }
 
+// src/commands/telefone.ts
+import {
+  TELEFONE_OFFICIAL_SOURCE_URL,
+  formatTelefone,
+  stripTelefone,
+  validateTelefone
+} from "@br-validators/core";
+function resolveInput3(value, fileContent) {
+  const input = value ?? fileContent?.trim();
+  if (!input) {
+    return null;
+  }
+  return input;
+}
+function printTelefoneValidation(result, options, io = { stdout: [], stderr: [] }) {
+  if (options.json) {
+    io.stdout.push(
+      JSON.stringify(
+        result.ok ? {
+          ok: true,
+          value: result.value,
+          tipo: result.tipo,
+          format: result.format,
+          ...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.tipo})`);
+    io.stdout.push(`value: ${result.value}`);
+    io.stdout.push(`format: ${result.format}`);
+    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 runTelefoneCommand(action, input, options, io = { stdout: [], stderr: [] }) {
+  const source = options.source ? TELEFONE_OFFICIAL_SOURCE_URL : void 0;
+  switch (action) {
+    case "validate":
+      return printTelefoneValidation(validateTelefone(input), { json: options.json, quiet: options.quiet, source }, io);
+    case "format":
+      return printFormat(formatTelefone(input), { json: options.json, quiet: options.quiet }, io);
+    case "strip":
+      return printStrip(stripTelefone(input), { json: options.json }, io);
+    default: {
+      const _exhaustive = action;
+      io.stderr.push(`Unknown action: ${_exhaustive}`);
+      return EXIT.USAGE;
+    }
+  }
+}
+function runTelefone(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput3(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing telephone value. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  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,
@@ -120,7 +473,7 @@ import {
   stripCnpj,
   validateCnpj
 } from "@br-validators/core";
-function resolveInput2(value, fileContent) {
+function resolveInput8(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -144,7 +497,7 @@ function runCnpjCommand(action, input, options, io = { stdout: [], stderr: [] })
   }
 }
 function runCnpj(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput2(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;
@@ -159,7 +512,7 @@ import {
   stripCpf,
   validateCpf
 } from "@br-validators/core";
-function resolveInput3(value, fileContent) {
+function resolveInput9(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -183,7 +536,7 @@ function runCpfCommand(action, input, options, io = { stdout: [], stderr: [] })
   }
 }
 function runCpf(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput3(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;
@@ -199,7 +552,7 @@ import {
   stripPlaca,
   validatePlaca
 } from "@br-validators/core";
-function resolveInput4(value, fileContent) {
+function resolveInput10(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -225,7 +578,7 @@ function runPlacaCommand(action, input, options, io = { stdout: [], stderr: [] }
   }
 }
 function runPlaca(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput4(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;
@@ -240,7 +593,7 @@ import {
   stripPisPasep,
   validatePisPasep
 } from "@br-validators/core";
-function resolveInput5(value, fileContent) {
+function resolveInput11(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -264,7 +617,7 @@ function runPisPasepCommand(action, input, options, io = { stdout: [], stderr: [
   }
 }
 function runPisPasep(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput5(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;
@@ -279,7 +632,7 @@ import {
   formatPixKey,
   validatePixKey
 } from "@br-validators/core";
-function resolveInput6(value, fileContent) {
+function resolveInput12(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -354,7 +707,7 @@ function runPixCommand(action, input, options, io = { stdout: [], stderr: [] })
   }
 }
 function runPix(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput6(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;
@@ -373,7 +726,7 @@ import {
   stripLinhaDigitavel,
   validateBoleto
 } from "@br-validators/core";
-function resolveInput7(value, fileContent) {
+function resolveInput13(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -497,7 +850,7 @@ function runBoletoCommand(action, input, options, direction, io = { stdout: [],
   }
 }
 function runBoleto(action, value, options, direction, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput7(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;
@@ -513,7 +866,7 @@ import {
   stripCartaoCredito,
   validateCartaoCredito
 } from "@br-validators/core";
-function resolveInput8(value, fileContent) {
+function resolveInput14(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -589,7 +942,7 @@ function runCartaoCommand(action, input, options, io = { stdout: [], stderr: []
   }
 }
 function runCartao(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput8(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;
@@ -599,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 resolveInput9(value, fileContent) {
+function resolveInput15(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -622,76 +980,249 @@ function resolveUf(uf) {
   }
   return null;
 }
-function printIeValidation(result, options, io = { stdout: [], stderr: [] }) {
+function isSpRuralRoute(uf, input) {
+  return uf === "SP" && isSpRuralIeInput(input);
+}
+function printIeValidation(result, options, io = { stdout: [], stderr: [] }) {
+  if (options.json) {
+    io.stdout.push(
+      JSON.stringify(
+        result.ok ? {
+          ok: true,
+          value: result.value,
+          uf: result.uf,
+          format: result.format,
+          ...options.rural ? { produtorRural: true } : {},
+          ...options.source ? { source: options.source } : {}
+        } : {
+          ok: false,
+          code: result.code,
+          message: result.message,
+          ...result.uf ? { uf: result.uf } : {}
+        },
+        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.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) {
+      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}`);
+  if (result.uf) {
+    io.stderr.push(`uf: ${result.uf}`);
+  }
+  return EXIT.INVALID;
+}
+function runIeCommand(action, input, options, io = { stdout: [], stderr: [] }) {
+  const uf = resolveUf(options.uf);
+  if (!uf) {
+    io.stderr.push(`Missing or invalid --uf. Use one of: ${IE_SUPPORTED_UFS.join(", ")}.`);
+    return EXIT.USAGE;
+  }
+  const rural = isSpRuralRoute(uf, input);
+  const source = options.source ? rural ? getIeProdutorRuralOfficialSourceUrl() : getIeOfficialSourceUrl(uf) : void 0;
+  switch (action) {
+    case "validate":
+      return printIeValidation(
+        rural ? validateIeProdutorRural(uf, input) : validateInscricaoEstadual(input, { uf }),
+        { json: options.json, quiet: options.quiet, source, rural },
+        io
+      );
+    case "format":
+      return printFormat(
+        rural ? formatIeProdutorRural(input) : formatInscricaoEstadual(input, { uf }),
+        { json: options.json, quiet: options.quiet },
+        io
+      );
+    case "strip":
+      return printStrip(rural ? stripIeSpRural(input) : stripInscricaoEstadual(input), { json: options.json }, io);
+    default: {
+      const _exhaustive = action;
+      io.stderr.push(`Unknown action: ${_exhaustive}`);
+      return EXIT.USAGE;
+    }
+  }
+}
+function runIe(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput15(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing IE value. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  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.ok ? {
-          ok: true,
-          value: result.value,
-          uf: result.uf,
-          format: result.format,
-          ...options.source ? { source: options.source } : {}
-        } : {
-          ok: false,
-          code: result.code,
-          message: result.message,
-          ...result.uf ? { uf: result.uf } : {}
-        },
-        null,
-        2
-      )
-    );
+    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 (${result.uf})`);
+    io.stdout.push("valid: yes");
     io.stdout.push(`value: ${result.value}`);
-    io.stdout.push(`format: ${result.format}`);
-    if (options.source) {
-      io.stdout.push(`source: ${options.source}`);
-    }
+    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}`);
-  if (result.uf) {
-    io.stderr.push(`uf: ${result.uf}`);
-  }
   return EXIT.INVALID;
 }
-function runIeCommand(action, input, options, io = { stdout: [], stderr: [] }) {
-  const uf = resolveUf(options.uf);
-  if (!uf) {
-    io.stderr.push(`Missing or invalid --uf. Use one of: ${IE_SUPPORTED_UFS.join(", ")}.`);
+function runSanitize(type, value, options, io = { stdout: [], stderr: [] }) {
+  if (!isSanitizableType(type)) {
+    io.stderr.push(`Unsupported sanitize type: ${type}`);
     return EXIT.USAGE;
   }
-  const source = options.source ? getIeOfficialSourceUrl(uf) : void 0;
-  switch (action) {
-    case "validate":
-      return printIeValidation(validateInscricaoEstadual(input, { uf }), { json: options.json, quiet: options.quiet, source }, io);
-    case "format":
-      return printFormat(formatInscricaoEstadual(input, { uf }), { json: options.json, quiet: options.quiet }, io);
-    case "strip":
-      return printStrip(stripInscricaoEstadual(input), { json: options.json }, io);
-    default: {
-      const _exhaustive = action;
-      io.stderr.push(`Unknown action: ${_exhaustive}`);
-      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);
 }
-function runIe(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput9(value, options.file);
-  if (input === null) {
-    io.stderr.push("Missing IE value. Pass an argument or use --file.");
+
+// 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;
   }
-  return runIeCommand(action, input, options, io);
+  const value = generate(type, buildGenerateOptions(options));
+  return printGenerate(value, options, io);
 }
 
 // src/commands/list.ts
@@ -777,6 +1308,48 @@ function handleCepCli(action, value, opts, io = { stdout: [], stderr: [] }) {
     io
   );
 }
+function handleTelefoneCli(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 runTelefone(
+    action,
+    value,
+    {
+      json: Boolean(opts.json),
+      quiet: Boolean(opts.quiet),
+      source: Boolean(opts.source),
+      file: fileContent
+    },
+    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) {
@@ -906,6 +1479,90 @@ 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) {
+    const content = readInputFile(opts.file, io);
+    if (content === null) {
+      return EXIT.USAGE;
+    }
+    fileContent = content;
+  }
+  return runBrCode(
+    action,
+    value,
+    {
+      json: Boolean(opts.json),
+      quiet: Boolean(opts.quiet),
+      source: Boolean(opts.source),
+      file: fileContent
+    },
+    io
+  );
+}
 function handleIeCli(action, value, opts, io = { stdout: [], stderr: [] }) {
   let fileContent;
   if (opts.file) {
@@ -928,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);
@@ -966,6 +1677,54 @@ function createProgram() {
       writeCliIo(io);
     });
   }
+  const telefone = program.command("telefone").description("Telefone \u2014 Brazilian fixo/celular (Anatel DDD)");
+  for (const action of ["validate", "format", "strip"]) {
+    telefone.command(action).description(`${action} a Brazilian telephone number`).argument("[value]", "Telephone value (raw or masked)").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 = handleTelefoneCli(action, value, opts, io);
+      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) => {
+      const io = { stdout: [], stderr: [] };
+      process.exitCode = handleBrCodeCli(action, value, opts, io);
+      writeCliIo(io);
+    });
+  }
   const placa = program.command("placa").description("Placa \u2014 legacy + Mercosul (CONTRAN)");
   for (const action of ["validate", "format", "strip", "convert"]) {
     placa.command(action).description(`${action} a license plate`).argument("[value]", "Placa value (raw or masked)").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) => {
@@ -1053,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,6 +1,6 @@
 {
   "name": "@br-validators/cli",
-  "version": "0.10.0-alpha.1",
+  "version": "0.12.0-alpha.0",
   "description": "Terminal CLI for Brazilian document validation — CPF, CNPJ, CEP, IE, PIX, boleto, and more",
   "license": "MIT",
   "type": "module",
@@ -29,7 +29,7 @@
   },
   "dependencies": {
     "commander": "^13.1.0",
-    "@br-validators/core": "0.10.0-alpha.0"
+    "@br-validators/core": "0.12.0-alpha.0"
   },
   "devDependencies": {
     "@types/node": "^22.15.21",
@@ -44,6 +44,8 @@
   ],
   "scripts": {
     "build": "tsup",
+    "pretest": "pnpm run build",
+    "pretest:coverage": "pnpm run build",
     "pretypecheck": "pnpm --filter @br-validators/core build",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",