@br-validators/core 1.6.1 → 1.7.0

package/README.md

@@ -272,6 +272,7 @@ Embedded JSON from official `.gov.br` sources — **no runtime HTTP**. Each modu
 | Bacen STR banks (COMPE / ISPB) | `@br-validators/core/bancos` | `bancos lookup` · `list` | `/data/bancos` | `getBancos`, `getBancoPorCodigo`, `getBancoPorIspb` | [Bacen Participantes STR](https://www.bcb.gov.br/content/estabilidadefinanceira/str1/ParticipantesSTR.csv) |
 | ANAC public aerodromos | `@br-validators/core/aeroportos` | `aeroportos lookup` | `/data/logistics` | `getAeroportos`, `getAeroportoPorIata`, `getAeroportoPorIcao`, `getAeroportosPorMunicipio` | [ANAC aeródromos públicos CSV](https://www.anac.gov.br/acesso-a-informacao/dados-abertos/areas-de-atuacao/aerodromos/lista-de-aerodromos-publicos/aerodromospublicosv1.csv/@@download/file/aerodromospublicosv1.csv) |
 | ANTAQ port installations | `@br-validators/core/portos` | `portos lookup` | `/data/logistics` | `getPortoPorCodigo`, `searchPortos`, `getPortosPorMunicipio` | [ANTAQ instalações portuárias zip](https://www.gov.br/antaq/pt-br/central-de-conteudos/Instalaesporturias06052025.zip) |
+| ANP fuel prices (LPC) | `@br-validators/core/anp-combustiveis` | — | `/data/logistics` | `getAnpPrecosMedios`, `getAnpPrecosMediosPorIbge`, `getAnpSemanaAtual` | [ANP levantamento LPC](https://www.gov.br/anp/pt-br/assuntos/precos-e-defesa-da-concorrencia/precos/levantamento-de-precos-de-combustiveis-ultimas-semanas-pesquisadas) |
 | TSE ↔ IBGE municipality codes | `@br-validators/core/tse-municipios` | `tse-municipios lookup` | `/data/ibge` (cross-ref) | `getMapeamentoTseIbge`, `getMunicipioIbgePorCodigoTse`, `getCodigosTsePorMunicipio` | [TSE municipio_tse_ibge.zip](https://cdn.tse.jus.br/estatistica/sead/odsele/municipio_tse_ibge/municipio_tse_ibge.zip) |
 | DDD geographic lookup | `@br-validators/core/telefone` | `ddd lookup` | — | `getDddInfo` (extends telefone validator) | [Anatel DDD panel](https://informacoes.anatel.gov.br/paineis/areas-tarifarias/codigos-nacionais) |
 | National holidays | `@br-validators/core/feriados` | `feriados list --year` | `/data/calendar` | `isFeriadoNacional`, `getFeriadosNacionais`, `getProximoDiaUtil` | [Lei 662/1949](https://www.planalto.gov.br/ccivil_03/leis/l0662.htm) + annual Portaria MGI |

package/dist/aeroportos.d.ts

@@ -1,4 +1,4 @@
-import { b as DatasetChanges, c as DatasetVerification } from './types-CBIZxgfG.js';
+import { b as DatasetChanges, c as DatasetVerification } from './types-CCKLomYy.js';
 
 interface Aeroporto {
     iata: string | null;

package/dist/aeroportos.js

@@ -1,4 +1,4 @@
-import { metadata_default } from './chunk-ILKF7HP7.js';
+import { metadata_default } from './chunk-AF5FGAI3.js';
 
 // src/aeroportos/data/aeroportos.json
 var aeroportos_default = [

package/dist/anp-combustiveis.d.ts

@@ -0,0 +1,64 @@
+import { b as DatasetChanges, c as DatasetVerification } from './types-CCKLomYy.js';
+
+declare const ANP_COMBUSTIVEL_VALUES: readonly ["ETHANOL", "GASOLINE_REGULAR", "GASOLINE_PREMIUM", "DIESEL_S500", "DIESEL_S10", "CNG", "LPG_P13"];
+type AnpCombustivel = (typeof ANP_COMBUSTIVEL_VALUES)[number];
+interface AnpSemanaPesquisa {
+    inicio: string;
+    fim: string;
+}
+interface AnpPrecoMedio {
+    semanaInicio: string;
+    semanaFim: string;
+    uf: string;
+    estadoNome: string;
+    municipioNome: string;
+    municipioIbge: number | null;
+    produto: AnpCombustivel;
+    postosPesquisados: number;
+    unidade: string;
+    precoMedio: number;
+    precoMinimo: number;
+    precoMaximo: number;
+    desvioPadrao: number | null;
+    coeficienteVariacao: number | null;
+}
+interface AnpPrecosMediosQuery {
+    uf: string;
+    municipio: string;
+    produto: AnpCombustivel;
+    semanaInicio?: string;
+}
+interface AnpCombustiveisDataVersion {
+    id: 'anp-combustiveis';
+    nome: string;
+    fonte: string;
+    endpoints: string[];
+    capturadoEm: string;
+    atualizadoEm: string;
+    contagens: {
+        semanas: number;
+        precosMedios: number;
+        municipios: number;
+        produtos: number;
+        ufs: number;
+    };
+    alteracoes: DatasetChanges;
+    verificacao: DatasetVerification;
+    documentacao: string;
+}
+
+/**
+ * ANP weekly fuel price survey — offline embedded municipal averages.
+ * @see docs/OFFICIAL-SOURCES.md#anp-combustiveis
+ */
+
+declare function getAnpSemanasPesquisa(): readonly AnpSemanaPesquisa[];
+declare function getAnpSemanaAtual(): AnpSemanaPesquisa | undefined;
+declare function getAnpPrecosMedios(query: AnpPrecosMediosQuery): AnpPrecoMedio | undefined;
+declare function getAnpPrecosMediosPorIbge(codigo: number, produto: AnpCombustivel, semanaInicio?: string): AnpPrecoMedio | undefined;
+
+declare const ANP_LPC_LISTING_URL = "https://www.gov.br/anp/pt-br/assuntos/precos-e-defesa-da-concorrencia/precos/levantamento-de-precos-de-combustiveis-ultimas-semanas-pesquisadas";
+
+declare const ANP_COMBUSTIVEIS_DATA_VERSION: AnpCombustiveisDataVersion;
+
+export { ANP_COMBUSTIVEIS_DATA_VERSION, ANP_COMBUSTIVEL_VALUES, ANP_LPC_LISTING_URL, type AnpCombustiveisDataVersion, type AnpCombustivel, type AnpPrecoMedio, type AnpPrecosMediosQuery, type AnpSemanaPesquisa, getAnpPrecosMedios, getAnpPrecosMediosPorIbge, getAnpSemanaAtual, getAnpSemanasPesquisa };