@br-validators/cli 0.12.0-alpha.0 → 0.12.0-alpha.2

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

@@ -1,11 +1,14 @@
 #!/usr/bin/env node
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 
 // src/program.ts
 import { Command } from "commander";
 
-// src/handlers.ts
-import { readFileSync } from "fs";
-
 // src/commands/brcode.ts
 import {
   BRCODE_OFFICIAL_SOURCE_URL,
@@ -1177,7 +1180,7 @@ function runSanitize(type, value, options, io = { stdout: [], stderr: [] }) {
 }
 
 // src/commands/generate.ts
-import { generate } from "@br-validators/core";
+import { generate, isGeneratableCardBrand } from "@br-validators/core";
 var GENERATABLE_TYPES = [
   "cpf",
   "cnpj",
@@ -1187,7 +1190,9 @@ var GENERATABLE_TYPES = [
   "renavam",
   "cnh",
   "telefone",
-  "cartao-credito"
+  "cartao-credito",
+  "inscricao-estadual",
+  "titulo-eleitor"
 ];
 function isGeneratableType(type) {
   return GENERATABLE_TYPES.includes(type);
@@ -1203,6 +1208,12 @@ function buildGenerateOptions(options) {
   if (options.format) {
     core.format = options.format;
   }
+  if (options.uf) {
+    core.uf = options.uf.toUpperCase();
+  }
+  if (options.brand && isGeneratableCardBrand(options.brand)) {
+    core.brand = options.brand;
+  }
   return core;
 }
 function printGenerate(value, options, io = { stdout: [], stderr: [] }) {
@@ -1236,7 +1247,8 @@ function listSupportedTypes(io = { stdout: [] }) {
 // src/handlers.ts
 function readInputFile(path, io) {
   try {
-    return readFileSync(path, "utf8");
+    const fsModule = __require("fs");
+    return fsModule.readFileSync(path, "utf8");
   } catch {
     io.stderr.push(`Cannot read file: ${path}`);
     return null;
@@ -1634,7 +1646,9 @@ function handleGenerateCli(type, opts, io = { stdout: [], stderr: [] }) {
       quiet: Boolean(opts.quiet),
       masked: Boolean(opts.masked),
       format: opts.format,
-      seed: opts.seed
+      seed: opts.seed,
+      uf: opts.uf,
+      brand: opts.brand
     },
     io
   );
@@ -1822,7 +1836,7 @@ function createProgram() {
     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) => {
+  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)).option("--uf <uf>", "State code (required for inscricao-estadual and titulo-eleitor)").option("--brand <brand>", "Card brand (visa, mastercard, amex, elo, hipercard)").action((type, opts) => {
     const io = { stdout: [], stderr: [] };
     process.exitCode = handleGenerateCli(type, opts, io);
     writeCliIo(io);

package/dist/run-captured.d.ts

@@ -0,0 +1,9 @@
+type CliRunResult = {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+};
+/** Run CLI with argv; capture stdout/stderr and exit code (browser-safe — no commander/process.exit). */
+declare function runCaptured(argv: string[]): CliRunResult;
+
+export { type CliRunResult, runCaptured };