@br-validators/core 1.0.0 → 1.1.0

package/README.md

@@ -29,6 +29,7 @@ Every Brazilian SaaS eventually reinvents CPF validation — usually wrong.
 - ✅ **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
+- ✅ **Reference data** — IBGE, Bacen banks, DDD lookup with weekly freshness ([DATA-FRESHNESS.md](../../docs/DATA-FRESHNESS.md))
 - ✅ **ESM only**, Node ≥ 18, works in browser, Bun, Deno
 
 ---

package/dist/bancos.d.ts

@@ -0,0 +1,41 @@
+import { b as DatasetChanges, c as DatasetVerification } from './types-CBIZxgfG.js';
+
+interface Banco {
+    codigo: string;
+    ispb: string;
+    nome: string;
+    nomeReduzido: string;
+    participaCompe: boolean;
+}
+interface BancosDataVersion {
+    id: 'bancos';
+    nome: string;
+    fonte: string;
+    endpoints: string[];
+    capturadoEm: string;
+    atualizadoEm: string;
+    contagens: {
+        bancos: number;
+    };
+    alteracoes: DatasetChanges;
+    verificacao: DatasetVerification;
+    documentacao: string;
+}
+
+/**
+ * Bacen STR participant lookup — offline embedded data from official STR CSV.
+ * @see https://www.bcb.gov.br/content/estabilidadefinanceira/str1/ParticipantesSTR.csv
+ */
+
+declare function getBancos(): readonly Banco[];
+declare function getBancoPorCodigo(codigo: string): Banco | undefined;
+declare function getBancoPorIspb(ispb: string): Banco | undefined;
+
+declare const BANCOS_STR_URL = "https://www.bcb.gov.br/content/estabilidadefinanceira/str1/ParticipantesSTR.csv";
+declare const BANCOS_GOLDEN_COMPE_BB = "001";
+declare const BANCOS_GOLDEN_COMPE_ITAU = "341";
+declare const BANCOS_GOLDEN_COMPE_NUBANK = "260";
+
+declare const BANCOS_DATA_VERSION: BancosDataVersion;
+
+export { BANCOS_DATA_VERSION, BANCOS_GOLDEN_COMPE_BB, BANCOS_GOLDEN_COMPE_ITAU, BANCOS_GOLDEN_COMPE_NUBANK, BANCOS_STR_URL, type Banco, type BancosDataVersion, getBancoPorCodigo, getBancoPorIspb, getBancos };