@br-validators/core 1.3.0 → 1.5.0

package/dist/sanitize.js

@@ -1,13 +1,13 @@
-export { sanitize } from './chunk-ZTDLGGYE.js';
+export { sanitize } from './chunk-ZYWBWXTJ.js';
 import './chunk-GWAYWBHN.js';
 import './chunk-GVK6IMBF.js';
 import './chunk-NT3TNF3R.js';
-import './chunk-AO6UTQ4A.js';
+import './chunk-XHDRWM46.js';
 import './chunk-JLCQ7MGC.js';
 import './chunk-3LMDBXU6.js';
 import './chunk-OOUEURR7.js';
-import './chunk-XHDRWM46.js';
 import './chunk-665E36SC.js';
+import './chunk-AO6UTQ4A.js';
 import './chunk-CDNOUZEI.js';
 import './chunk-VKG7UEN5.js';
 import './chunk-RRVGW333.js';

package/dist/transparencia-snapshots.d.ts

@@ -0,0 +1,61 @@
+import { b as DatasetChanges, c as DatasetVerification } from './types-CBIZxgfG.js';
+
+type TransparenciaDeliveryMode = 'query-adapter' | 'bulk-embed-candidate' | 'out-of-scope';
+interface TransparenciaEndpoint {
+    id: string;
+    path: string;
+    domain: string;
+    delivery: TransparenciaDeliveryMode;
+    description: string;
+}
+interface TransparenciaSnapshotsRegistry {
+    capturadoEm: string;
+    swaggerOk: boolean;
+    openapiOk: boolean;
+    cadastroUrl: string;
+    adapterPackage: string;
+    endpoints: readonly TransparenciaEndpoint[];
+}
+interface TransparenciaSnapshotsDataVersion {
+    id: 'transparencia-snapshots';
+    nome: string;
+    fonte: string;
+    endpoints: string[];
+    capturadoEm: string;
+    atualizadoEm: string;
+    contagens: {
+        endpoints: number;
+        queryAdapter: number;
+    };
+    alteracoes: DatasetChanges;
+    verificacao: DatasetVerification;
+    documentacao: string;
+}
+
+/**
+ * Portal da Transparência endpoint registry — offline metadata (no live API in core).
+ * @see docs/OFFICIAL-SOURCES.md#portal-transparencia
+ */
+
+declare function getTransparenciaRegistry(): TransparenciaSnapshotsRegistry;
+declare function getTransparenciaEndpoints(): readonly TransparenciaEndpoint[];
+declare function getTransparenciaEndpointPorId(id: string): TransparenciaEndpoint | undefined;
+declare function getTransparenciaEndpointsPorDominio(domain: string): readonly TransparenciaEndpoint[];
+declare function getTransparenciaQueryAdapterEndpoints(): readonly TransparenciaEndpoint[];
+
+/**
+ * Normalize identifiers for Transparência adapter queries — delegates to core strip helpers.
+ * @see docs/ADAPTERS-TRANSPARENCIA-RFC.md
+ */
+declare function normalizeTransparenciaCpf(input: string): string;
+declare function normalizeTransparenciaCnpj(input: string): string;
+
+declare const TRANSPARENCIA_SWAGGER_URL = "https://api.portaldatransparencia.gov.br/swagger-ui/index.html";
+declare const TRANSPARENCIA_OPENAPI_URL = "https://api.portaldatransparencia.gov.br/v3/api-docs";
+declare const TRANSPARENCIA_CADASTRO_URL = "https://portaldatransparencia.gov.br/";
+declare const TRANSPARENCIA_ADAPTER_PACKAGE = "@br-validators/adapters-transparencia";
+declare const TRANSPARENCIA_GOLDEN_CEIS_PATH = "/api-de-dados/ceis";
+
+declare const TRANSPARENCIA_SNAPSHOTS_DATA_VERSION: TransparenciaSnapshotsDataVersion;
+
+export { TRANSPARENCIA_ADAPTER_PACKAGE, TRANSPARENCIA_CADASTRO_URL, TRANSPARENCIA_GOLDEN_CEIS_PATH, TRANSPARENCIA_OPENAPI_URL, TRANSPARENCIA_SNAPSHOTS_DATA_VERSION, TRANSPARENCIA_SWAGGER_URL, type TransparenciaDeliveryMode, type TransparenciaEndpoint, type TransparenciaSnapshotsDataVersion, type TransparenciaSnapshotsRegistry, getTransparenciaEndpointPorId, getTransparenciaEndpoints, getTransparenciaEndpointsPorDominio, getTransparenciaQueryAdapterEndpoints, getTransparenciaRegistry, normalizeTransparenciaCnpj, normalizeTransparenciaCpf };

package/dist/transparencia-snapshots.js

@@ -0,0 +1,119 @@
+import { metadata_default } from './chunk-RWO34ORS.js';
+import { stripCnpj } from './chunk-EB3G4IG6.js';
+import { stripCpf } from './chunk-UCJPSJN5.js';
+
+// src/transparencia-snapshots/data/endpoints.json
+var endpoints_default = {
+  capturadoEm: "2026-06-23T19:08:25.007Z",
+  swaggerOk: true,
+  openapiOk: true,
+  cadastroUrl: "https://portaldatransparencia.gov.br/",
+  adapterPackage: "@br-validators/adapters-transparencia",
+  endpoints: [
+    {
+      id: "ceis",
+      path: "/api-de-dados/ceis",
+      domain: "sanctions",
+      delivery: "query-adapter",
+      description: "Cadastro de Empresas Inid\xF4neas e Suspensas \u2014 paginated query by CNPJ/CPF"
+    },
+    {
+      id: "cnep",
+      path: "/api-de-dados/cnep",
+      domain: "sanctions",
+      delivery: "query-adapter",
+      description: "Cadastro Nacional de Empresas Punidas \u2014 paginated query by CNPJ/CPF"
+    },
+    {
+      id: "ceaf",
+      path: "/api-de-dados/ceaf",
+      domain: "sanctions",
+      delivery: "query-adapter",
+      description: "Cadastro de Expuls\xF5es da Administra\xE7\xE3o Federal \u2014 paginated query"
+    },
+    {
+      id: "peps",
+      path: "/api-de-dados/peps",
+      domain: "pep",
+      delivery: "query-adapter",
+      description: "Pessoas Expostas Politicamente \u2014 paginated query; no open bulk export in v1"
+    },
+    {
+      id: "bolsa-familia",
+      path: "/api-de-dados/bolsa-familia-beneficios",
+      domain: "social-programs",
+      delivery: "query-adapter",
+      description: "Bolsa Fam\xEDlia benefits \u2014 query by CPF/NIS; adapter only"
+    },
+    {
+      id: "bpc",
+      path: "/api-de-dados/beneficios-por-pessoa",
+      domain: "social-programs",
+      delivery: "query-adapter",
+      description: "BPC and related benefits \u2014 query by CPF/NIS; adapter only"
+    },
+    {
+      id: "auxilio-emergencial",
+      path: "/api-de-dados/auxilio-emergencial",
+      domain: "social-programs",
+      delivery: "query-adapter",
+      description: "Aux\xEDlio Emergencial \u2014 historical query by CPF/NIS; adapter only"
+    },
+    {
+      id: "despesas",
+      path: "/api-de-dados/despesas",
+      domain: "budget",
+      delivery: "out-of-scope",
+      description: "Federal spending \u2014 high volume; out of scope for core embed v1"
+    }
+  ]
+};
+
+// src/transparencia-snapshots/lookup.ts
+var registry = endpoints_default;
+var endpoints = registry.endpoints;
+function getTransparenciaRegistry() {
+  return registry;
+}
+function getTransparenciaEndpoints() {
+  return endpoints;
+}
+function getTransparenciaEndpointPorId(id) {
+  const normalized = id.trim().toLowerCase();
+  if (normalized.length === 0) {
+    return void 0;
+  }
+  return endpoints.find((endpoint) => endpoint.id === normalized);
+}
+function getTransparenciaEndpointsPorDominio(domain) {
+  const normalized = domain.trim().toLowerCase();
+  if (normalized.length === 0) {
+    return [];
+  }
+  return endpoints.filter((endpoint) => endpoint.domain === normalized);
+}
+function getTransparenciaQueryAdapterEndpoints() {
+  return endpoints.filter((endpoint) => endpoint.delivery === "query-adapter");
+}
+
+// src/transparencia-snapshots/normalize.ts
+function normalizeTransparenciaCpf(input) {
+  return stripCpf(input);
+}
+function normalizeTransparenciaCnpj(input) {
+  return stripCnpj(input);
+}
+
+// src/transparencia-snapshots/constants.ts
+var TRANSPARENCIA_SWAGGER_URL = "https://api.portaldatransparencia.gov.br/swagger-ui/index.html";
+var TRANSPARENCIA_OPENAPI_URL = "https://api.portaldatransparencia.gov.br/v3/api-docs";
+var TRANSPARENCIA_CADASTRO_URL = "https://portaldatransparencia.gov.br/";
+var TRANSPARENCIA_ADAPTER_PACKAGE = "@br-validators/adapters-transparencia";
+var TRANSPARENCIA_GOLDEN_CEIS_PATH = "/api-de-dados/ceis";
+
+// src/transparencia-snapshots/version.ts
+var TRANSPARENCIA_SNAPSHOTS_DATA_VERSION = metadata_default;
+
+export { TRANSPARENCIA_ADAPTER_PACKAGE, TRANSPARENCIA_CADASTRO_URL, TRANSPARENCIA_GOLDEN_CEIS_PATH, TRANSPARENCIA_OPENAPI_URL, TRANSPARENCIA_SNAPSHOTS_DATA_VERSION, TRANSPARENCIA_SWAGGER_URL, getTransparenciaEndpointPorId, getTransparenciaEndpoints, getTransparenciaEndpointsPorDominio, getTransparenciaQueryAdapterEndpoints, getTransparenciaRegistry, normalizeTransparenciaCnpj, normalizeTransparenciaCpf };
+//# sourceMappingURL=transparencia-snapshots.js.map
+//# sourceMappingURL=transparencia-snapshots.js.map

package/dist/transparencia-snapshots.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transparencia-snapshots/data/endpoints.json","../src/transparencia-snapshots/lookup.ts","../src/transparencia-snapshots/normalize.ts","../src/transparencia-snapshots/constants.ts","../src/transparencia-snapshots/version.ts"],"names":[],"mappings":"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","file":"transparencia-snapshots.js","sourcesContent":["{\n  \"capturadoEm\": \"2026-06-23T19:08:25.007Z\",\n  \"swaggerOk\": true,\n  \"openapiOk\": true,\n  \"cadastroUrl\": \"https://portaldatransparencia.gov.br/\",\n  \"adapterPackage\": \"@br-validators/adapters-transparencia\",\n  \"endpoints\": [\n    {\n      \"id\": \"ceis\",\n      \"path\": \"/api-de-dados/ceis\",\n      \"domain\": \"sanctions\",\n      \"delivery\": \"query-adapter\",\n      \"description\": \"Cadastro de Empresas Inidôneas e Suspensas — paginated query by CNPJ/CPF\"\n    },\n    {\n      \"id\": \"cnep\",\n      \"path\": \"/api-de-dados/cnep\",\n      \"domain\": \"sanctions\",\n      \"delivery\": \"query-adapter\",\n      \"description\": \"Cadastro Nacional de Empresas Punidas — paginated query by CNPJ/CPF\"\n    },\n    {\n      \"id\": \"ceaf\",\n      \"path\": \"/api-de-dados/ceaf\",\n      \"domain\": \"sanctions\",\n      \"delivery\": \"query-adapter\",\n      \"description\": \"Cadastro de Expulsões da Administração Federal — paginated query\"\n    },\n    {\n      \"id\": \"peps\",\n      \"path\": \"/api-de-dados/peps\",\n      \"domain\": \"pep\",\n      \"delivery\": \"query-adapter\",\n      \"description\": \"Pessoas Expostas Politicamente — paginated query; no open bulk export in v1\"\n    },\n    {\n      \"id\": \"bolsa-familia\",\n      \"path\": \"/api-de-dados/bolsa-familia-beneficios\",\n      \"domain\": \"social-programs\",\n      \"delivery\": \"query-adapter\",\n      \"description\": \"Bolsa Família benefits — query by CPF/NIS; adapter only\"\n    },\n    {\n      \"id\": \"bpc\",\n      \"path\": \"/api-de-dados/beneficios-por-pessoa\",\n      \"domain\": \"social-programs\",\n      \"delivery\": \"query-adapter\",\n      \"description\": \"BPC and related benefits — query by CPF/NIS; adapter only\"\n    },\n    {\n      \"id\": \"auxilio-emergencial\",\n      \"path\": \"/api-de-dados/auxilio-emergencial\",\n      \"domain\": \"social-programs\",\n      \"delivery\": \"query-adapter\",\n      \"description\": \"Auxílio Emergencial — historical query by CPF/NIS; adapter only\"\n    },\n    {\n      \"id\": \"despesas\",\n      \"path\": \"/api-de-dados/despesas\",\n      \"domain\": \"budget\",\n      \"delivery\": \"out-of-scope\",\n      \"description\": \"Federal spending — high volume; out of scope for core embed v1\"\n    }\n  ]\n}\n","/**\n * Portal da Transparência endpoint registry — offline metadata (no live API in core).\n * @see docs/OFFICIAL-SOURCES.md#portal-transparencia\n */\n\nimport registryData from './data/endpoints.json';\nimport type { TransparenciaEndpoint, TransparenciaSnapshotsRegistry } from './types.js';\n\nconst registry = registryData as TransparenciaSnapshotsRegistry;\nconst endpoints: readonly TransparenciaEndpoint[] = registry.endpoints;\n\nexport function getTransparenciaRegistry(): TransparenciaSnapshotsRegistry {\n  return registry;\n}\n\nexport function getTransparenciaEndpoints(): readonly TransparenciaEndpoint[] {\n  return endpoints;\n}\n\nexport function getTransparenciaEndpointPorId(id: string): TransparenciaEndpoint | undefined {\n  const normalized = id.trim().toLowerCase();\n  if (normalized.length === 0) {\n    return undefined;\n  }\n  return endpoints.find((endpoint) => endpoint.id === normalized);\n}\n\nexport function getTransparenciaEndpointsPorDominio(domain: string): readonly TransparenciaEndpoint[] {\n  const normalized = domain.trim().toLowerCase();\n  if (normalized.length === 0) {\n    return [];\n  }\n  return endpoints.filter((endpoint) => endpoint.domain === normalized);\n}\n\nexport function getTransparenciaQueryAdapterEndpoints(): readonly TransparenciaEndpoint[] {\n  return endpoints.filter((endpoint) => endpoint.delivery === 'query-adapter');\n}\n","/**\n * Normalize identifiers for Transparência adapter queries — delegates to core strip helpers.\n * @see docs/ADAPTERS-TRANSPARENCIA-RFC.md\n */\n\nimport { stripCnpj } from '../strip/cnpj.js';\nimport { stripCpf } from '../strip/cpf.js';\n\nexport function normalizeTransparenciaCpf(input: string): string {\n  return stripCpf(input);\n}\n\nexport function normalizeTransparenciaCnpj(input: string): string {\n  return stripCnpj(input);\n}\n","export const TRANSPARENCIA_SWAGGER_URL =\n  'https://api.portaldatransparencia.gov.br/swagger-ui/index.html';\n\nexport const TRANSPARENCIA_OPENAPI_URL = 'https://api.portaldatransparencia.gov.br/v3/api-docs';\n\nexport const TRANSPARENCIA_CADASTRO_URL = 'https://portaldatransparencia.gov.br/';\n\nexport const TRANSPARENCIA_ADAPTER_PACKAGE = '@br-validators/adapters-transparencia';\n\nexport const TRANSPARENCIA_GOLDEN_CEIS_PATH = '/api-de-dados/ceis';\n","import transparenciaMetadata from './data/metadata.json';\nimport type { TransparenciaSnapshotsDataVersion } from './types.js';\n\nexport const TRANSPARENCIA_SNAPSHOTS_DATA_VERSION: TransparenciaSnapshotsDataVersion =\n  transparenciaMetadata as TransparenciaSnapshotsDataVersion;\n"]}

package/dist/tse-municipios.d.ts

@@ -0,0 +1,39 @@
+import { b as DatasetChanges, c as DatasetVerification } from './types-CBIZxgfG.js';
+
+interface TseMunicipioMapping {
+    codigoTse: string;
+    ibgeCodigo: number;
+    uf: string;
+    nome: string;
+}
+interface TseMunicipiosDataVersion {
+    id: 'tse-municipios';
+    nome: string;
+    fonte: string;
+    endpoints: string[];
+    capturadoEm: string;
+    atualizadoEm: string;
+    contagens: {
+        municipios: number;
+    };
+    alteracoes: DatasetChanges;
+    verificacao: DatasetVerification;
+    documentacao: string;
+}
+
+/**
+ * TSE ↔ IBGE municipality cross-walk — offline embedded data from official TSE open data.
+ * @see docs/OFFICIAL-SOURCES.md#tse-municipios
+ */
+
+declare function getMapeamentoTseIbge(): readonly TseMunicipioMapping[];
+declare function getMunicipioIbgePorCodigoTse(codigo: string): number | undefined;
+declare function getCodigosTsePorMunicipio(ibgeCodigo: number): readonly string[];
+
+declare const TSE_MUNICIPIO_IBGE_ZIP_URL = "https://cdn.tse.jus.br/estatistica/sead/odsele/municipio_tse_ibge/municipio_tse_ibge.zip";
+declare const TSE_MUNICIPIOS_GOLDEN_IBGE_SAO_PAULO = 3550308;
+declare const TSE_MUNICIPIOS_GOLDEN_CODIGO_TSE_SAO_PAULO = "71072";
+
+declare const TSE_MUNICIPIOS_DATA_VERSION: TseMunicipiosDataVersion;
+
+export { TSE_MUNICIPIOS_DATA_VERSION, TSE_MUNICIPIOS_GOLDEN_CODIGO_TSE_SAO_PAULO, TSE_MUNICIPIOS_GOLDEN_IBGE_SAO_PAULO, TSE_MUNICIPIO_IBGE_ZIP_URL, type TseMunicipioMapping, type TseMunicipiosDataVersion, getCodigosTsePorMunicipio, getMapeamentoTseIbge, getMunicipioIbgePorCodigoTse };