sih-br-mcp 0.12.0

package/dist/data/csap-groups.json

@@ -0,0 +1,262 @@
+{
+    "metadata": {
+        "source": "Portaria MS/SAS nº 221, de 17 de abril de 2008",
+        "description": "Lista Brasileira de Internações por Condições Sensíveis à Atenção Primária",
+        "classification": "CID-10",
+        "total_groups": 19,
+        "url": "https://bvsms.saude.gov.br/bvs/saudelegis/sas/2008/prt0221_17_04_2008.html"
+    },
+    "groups": [
+        {
+            "id": 1,
+            "code": "g01",
+            "name_pt": "Doenças preveníveis por imunização e condições sensíveis",
+            "name_en": "Vaccine-preventable diseases and sensitive conditions",
+            "diagnoses": [
+                { "name": "Coqueluche", "cid10": ["A37"] },
+                { "name": "Difteria", "cid10": ["A36"] },
+                { "name": "Tétano", "cid10": ["A33", "A34", "A35"] },
+                { "name": "Parotidite", "cid10": ["B26"] },
+                { "name": "Rubéola", "cid10": ["B06"] },
+                { "name": "Sarampo", "cid10": ["B05"] },
+                { "name": "Febre Amarela", "cid10": ["A95"] },
+                { "name": "Hepatite B", "cid10": ["B16"] },
+                { "name": "Meningite por Haemophilus", "cid10": ["G00.0"] },
+                { "name": "Meningite Tuberculosa", "cid10": ["A17.0"] },
+                { "name": "Tuberculose miliar", "cid10": ["A19"] },
+                { "name": "Tuberculose Pulmonar", "cid10": ["A15.0", "A15.1", "A15.2", "A15.3", "A16.0", "A16.1", "A16.2", "A15.4", "A15.5", "A15.6", "A15.7", "A15.8", "A15.9", "A16.3", "A16.4", "A16.5", "A16.7", "A16.8", "A16.9", "A17.1", "A17.8", "A17.9"] },
+                { "name": "Outras Tuberculoses", "cid10": ["A18"] },
+                { "name": "Febre reumática", "cid10": ["I00", "I01", "I02"] },
+                { "name": "Sífilis", "cid10": ["A51", "A52", "A53"] },
+                { "name": "Malária", "cid10": ["B50", "B51", "B52", "B53", "B54"] },
+                { "name": "Ascaridíase", "cid10": ["B77"] }
+            ],
+            "cid10_all": ["A33", "A34", "A35", "A36", "A37", "A95", "B05", "B06", "B16", "B26", "G00.0", "A17.0", "A19", "A15", "A16", "A17.1", "A17.8", "A17.9", "A18", "I00", "I01", "I02", "A51", "A52", "A53", "B50", "B51", "B52", "B53", "B54", "B77"]
+        },
+        {
+            "id": 2,
+            "code": "g02",
+            "name_pt": "Gastroenterites infecciosas e complicações",
+            "name_en": "Infectious gastroenteritis and complications",
+            "diagnoses": [
+                { "name": "Desidratação", "cid10": ["E86"] },
+                { "name": "Gastroenterites", "cid10": ["A00", "A01", "A02", "A03", "A04", "A05", "A06", "A07", "A08", "A09"] }
+            ],
+            "cid10_all": ["E86", "A00", "A01", "A02", "A03", "A04", "A05", "A06", "A07", "A08", "A09"]
+        },
+        {
+            "id": 3,
+            "code": "g03",
+            "name_pt": "Anemia",
+            "name_en": "Anemia",
+            "diagnoses": [
+                { "name": "Anemia por deficiência de ferro", "cid10": ["D50"] }
+            ],
+            "cid10_all": ["D50"]
+        },
+        {
+            "id": 4,
+            "code": "g04",
+            "name_pt": "Deficiências nutricionais",
+            "name_en": "Nutritional deficiencies",
+            "diagnoses": [
+                { "name": "Kwashiorkor e outras formas de desnutrição protéico-calórica", "cid10": ["E40", "E41", "E42", "E43", "E44", "E45", "E46"] },
+                { "name": "Outras deficiências nutricionais", "cid10": ["E50", "E51", "E52", "E53", "E54", "E55", "E56", "E58", "E59", "E60", "E61", "E63", "E64"] }
+            ],
+            "cid10_all": ["E40", "E41", "E42", "E43", "E44", "E45", "E46", "E50", "E51", "E52", "E53", "E54", "E55", "E56", "E58", "E59", "E60", "E61", "E63", "E64"]
+        },
+        {
+            "id": 5,
+            "code": "g05",
+            "name_pt": "Infecções de ouvido, nariz e garganta",
+            "name_en": "Ear, nose and throat infections",
+            "diagnoses": [
+                { "name": "Otite média supurativa", "cid10": ["H66"] },
+                { "name": "Nasofaringite aguda (resfriado comum)", "cid10": ["J00"] },
+                { "name": "Sinusite aguda", "cid10": ["J01"] },
+                { "name": "Faringite aguda", "cid10": ["J02"] },
+                { "name": "Amigdalite aguda", "cid10": ["J03"] },
+                { "name": "Infecção aguda das vias aéreas superiores", "cid10": ["J06"] },
+                { "name": "Rinite, nasofaringite e faringite crônicas", "cid10": ["J31"] }
+            ],
+            "cid10_all": ["H66", "J00", "J01", "J02", "J03", "J06", "J31"]
+        },
+        {
+            "id": 6,
+            "code": "g06",
+            "name_pt": "Pneumonias bacterianas",
+            "name_en": "Bacterial pneumonia",
+            "diagnoses": [
+                { "name": "Pneumonia Pneumocócica", "cid10": ["J13"] },
+                { "name": "Pneumonia por Haemophilus influenzae", "cid10": ["J14"] },
+                { "name": "Pneumonia por Streptococcus", "cid10": ["J15.3", "J15.4"] },
+                { "name": "Pneumonia bacteriana não especificada", "cid10": ["J15.8", "J15.9"] },
+                { "name": "Pneumonia lobar não especificada", "cid10": ["J18.1"] }
+            ],
+            "cid10_all": ["J13", "J14", "J15.3", "J15.4", "J15.8", "J15.9", "J18.1"]
+        },
+        {
+            "id": 7,
+            "code": "g07",
+            "name_pt": "Asma",
+            "name_en": "Asthma",
+            "diagnoses": [
+                { "name": "Asma", "cid10": ["J45", "J46"] }
+            ],
+            "cid10_all": ["J45", "J46"]
+        },
+        {
+            "id": 8,
+            "code": "g08",
+            "name_pt": "Doenças pulmonares",
+            "name_en": "Pulmonary diseases",
+            "diagnoses": [
+                { "name": "Bronquite aguda", "cid10": ["J20", "J21"] },
+                { "name": "Bronquite não especificada como aguda ou crônica", "cid10": ["J40"] },
+                { "name": "Bronquite crônica simples e mucopurulenta", "cid10": ["J41"] },
+                { "name": "Bronquite crônica não especificada", "cid10": ["J42"] },
+                { "name": "Enfisema", "cid10": ["J43"] },
+                { "name": "Bronquiectasia", "cid10": ["J47"] },
+                { "name": "Outras doenças pulmonares obstrutivas crônicas", "cid10": ["J44"] }
+            ],
+            "cid10_all": ["J20", "J21", "J40", "J41", "J42", "J43", "J44", "J47"]
+        },
+        {
+            "id": 9,
+            "code": "g09",
+            "name_pt": "Hipertensão",
+            "name_en": "Hypertension",
+            "diagnoses": [
+                { "name": "Hipertensão essencial", "cid10": ["I10"] },
+                { "name": "Doença cardíaca hipertensiva", "cid10": ["I11"] }
+            ],
+            "cid10_all": ["I10", "I11"]
+        },
+        {
+            "id": 10,
+            "code": "g10",
+            "name_pt": "Angina",
+            "name_en": "Angina",
+            "diagnoses": [
+                { "name": "Angina pectoris", "cid10": ["I20"] }
+            ],
+            "cid10_all": ["I20"]
+        },
+        {
+            "id": 11,
+            "code": "g11",
+            "name_pt": "Insuficiência cardíaca",
+            "name_en": "Heart failure",
+            "diagnoses": [
+                { "name": "Insuficiência cardíaca", "cid10": ["I50"] },
+                { "name": "Edema agudo de pulmão", "cid10": ["J81"] }
+            ],
+            "cid10_all": ["I50", "J81"]
+        },
+        {
+            "id": 12,
+            "code": "g12",
+            "name_pt": "Doenças cerebrovasculares",
+            "name_en": "Cerebrovascular diseases",
+            "diagnoses": [
+                { "name": "Doenças cerebrovasculares", "cid10": ["I63", "I64", "I65", "I66", "I67", "I69", "G45", "G46"] }
+            ],
+            "cid10_all": ["I63", "I64", "I65", "I66", "I67", "I69", "G45", "G46"]
+        },
+        {
+            "id": 13,
+            "code": "g13",
+            "name_pt": "Diabetes mellitus",
+            "name_en": "Diabetes mellitus",
+            "diagnoses": [
+                { "name": "Com coma ou cetoacidose", "cid10": ["E10.0", "E10.1", "E11.0", "E11.1", "E12.0", "E12.1", "E13.0", "E13.1", "E14.0", "E14.1"] },
+                { "name": "Com complicações", "cid10": ["E10.2", "E10.3", "E10.4", "E10.5", "E10.6", "E10.7", "E10.8", "E11.2", "E11.3", "E11.4", "E11.5", "E11.6", "E11.7", "E11.8", "E12.2", "E12.3", "E12.4", "E12.5", "E12.6", "E12.7", "E12.8", "E13.2", "E13.3", "E13.4", "E13.5", "E13.6", "E13.7", "E13.8", "E14.2", "E14.3", "E14.4", "E14.5", "E14.6", "E14.7", "E14.8"] },
+                { "name": "Sem complicações específicas", "cid10": ["E10.9", "E11.9", "E12.9", "E13.9", "E14.9"] }
+            ],
+            "cid10_all": ["E10.0", "E10.1", "E10.2", "E10.3", "E10.4", "E10.5", "E10.6", "E10.7", "E10.8", "E10.9", "E11.0", "E11.1", "E11.2", "E11.3", "E11.4", "E11.5", "E11.6", "E11.7", "E11.8", "E11.9", "E12.0", "E12.1", "E12.2", "E12.3", "E12.4", "E12.5", "E12.6", "E12.7", "E12.8", "E12.9", "E13.0", "E13.1", "E13.2", "E13.3", "E13.4", "E13.5", "E13.6", "E13.7", "E13.8", "E13.9", "E14.0", "E14.1", "E14.2", "E14.3", "E14.4", "E14.5", "E14.6", "E14.7", "E14.8", "E14.9"]
+        },
+        {
+            "id": 14,
+            "code": "g14",
+            "name_pt": "Epilepsias",
+            "name_en": "Epilepsy",
+            "diagnoses": [
+                { "name": "Epilepsias", "cid10": ["G40", "G41"] }
+            ],
+            "cid10_all": ["G40", "G41"]
+        },
+        {
+            "id": 15,
+            "code": "g15",
+            "name_pt": "Infecção no rim e trato urinário",
+            "name_en": "Kidney and urinary tract infection",
+            "diagnoses": [
+                { "name": "Nefrite túbulo-intersticial aguda", "cid10": ["N10"] },
+                { "name": "Nefrite túbulo-intersticial crônica", "cid10": ["N11"] },
+                { "name": "Nefrite túbulo-intersticial não especificada", "cid10": ["N12"] },
+                { "name": "Cistite", "cid10": ["N30"] },
+                { "name": "Uretrite", "cid10": ["N34"] },
+                { "name": "Infecção do trato urinário de localização não especificada", "cid10": ["N39.0"] }
+            ],
+            "cid10_all": ["N10", "N11", "N12", "N30", "N34", "N39.0"]
+        },
+        {
+            "id": 16,
+            "code": "g16",
+            "name_pt": "Infecção da pele e tecido subcutâneo",
+            "name_en": "Skin and subcutaneous tissue infection",
+            "diagnoses": [
+                { "name": "Erisipela", "cid10": ["A46"] },
+                { "name": "Impetigo", "cid10": ["L01"] },
+                { "name": "Abscesso cutâneo, furúnculo e carbúnculo", "cid10": ["L02"] },
+                { "name": "Celulite", "cid10": ["L03"] },
+                { "name": "Linfadenite aguda", "cid10": ["L04"] },
+                { "name": "Outras infecções localizadas na pele e tecido subcutâneo", "cid10": ["L08"] }
+            ],
+            "cid10_all": ["A46", "L01", "L02", "L03", "L04", "L08"]
+        },
+        {
+            "id": 17,
+            "code": "g17",
+            "name_pt": "Doença inflamatória dos órgãos pélvicos femininos",
+            "name_en": "Female pelvic inflammatory disease",
+            "diagnoses": [
+                { "name": "Salpingite e ooforite", "cid10": ["N70"] },
+                { "name": "Doença inflamatória do útero, exceto o colo", "cid10": ["N71"] },
+                { "name": "Doença inflamatória do colo do útero", "cid10": ["N72"] },
+                { "name": "Outras doenças inflamatórias pélvicas femininas", "cid10": ["N73"] },
+                { "name": "Doenças da glândula de Bartholin", "cid10": ["N75"] },
+                { "name": "Outras afecções inflamatórias da vagina e da vulva", "cid10": ["N76"] }
+            ],
+            "cid10_all": ["N70", "N71", "N72", "N73", "N75", "N76"]
+        },
+        {
+            "id": 18,
+            "code": "g18",
+            "name_pt": "Úlcera gastrointestinal",
+            "name_en": "Gastrointestinal ulcer",
+            "diagnoses": [
+                { "name": "Úlcera gástrica", "cid10": ["K25"] },
+                { "name": "Úlcera duodenal", "cid10": ["K26"] },
+                { "name": "Úlcera péptica de localização não especificada", "cid10": ["K27"] },
+                { "name": "Úlcera gastrojejunal", "cid10": ["K28"] },
+                { "name": "Hematêmese", "cid10": ["K92.0"] },
+                { "name": "Melena", "cid10": ["K92.1"] },
+                { "name": "Hemorragia gastrointestinal não especificada", "cid10": ["K92.2"] }
+            ],
+            "cid10_all": ["K25", "K26", "K27", "K28", "K92.0", "K92.1", "K92.2"]
+        },
+        {
+            "id": 19,
+            "code": "g19",
+            "name_pt": "Doenças relacionadas ao pré-natal e parto",
+            "name_en": "Prenatal and childbirth-related diseases",
+            "diagnoses": [
+                { "name": "Infecção do trato urinário na gravidez", "cid10": ["O23"] },
+                { "name": "Sífilis congênita", "cid10": ["A50"] },
+                { "name": "Síndrome da rubéola congênita", "cid10": ["P35.0"] }
+            ],
+            "cid10_all": ["O23", "A50", "P35.0"]
+        }
+    ]
+}

package/dist/db/duckdb.d.ts

@@ -0,0 +1,263 @@
+/**
+ * Módulo de conexão DuckDB para consulta aos cubos de dados Parquet
+ * Suporta múltiplos arquivos Parquet por ano (sih_causas_YYYY.parquet)
+ */
+import { DuckDBConnection } from "@duckdb/node-api";
+/**
+ * Determina qual diretório de dados usar.
+ * - Padrão: data/ (dados reais)
+ * - Teste: data/test/ (somente se SIH_TEST_MODE=1 estiver definido)
+ */
+/**
+ * A pasta de cubos CONFIGURADA (SIH_DATA_DIR ou data/ do projeto), exista
+ * cubo nela ou não. Quem precisa só do sidecar de proveniência — o frescor
+ * num checkout limpo, onde data/*.parquet é gitignored e só o JSON está
+ * versionado — lê daqui; quem precisa de Parquet usa getDataDirectory().
+ */
+export declare function configuredDataDirectory(): string;
+export declare function getDataDirectory(): string;
+/**
+ * Retorna o padrão glob para um tipo de cubo
+ */
+export declare function getParquetPattern(cube: "causas" | "series" | "icsap"): string;
+/**
+ * Lista os anos disponíveis nos dados
+ */
+export declare function getAvailableYears(): number[];
+/**
+ * Inicializa conexão com DuckDB
+ */
+export declare function getDatabase(): Promise<DuckDBConnection>;
+/**
+ * Fecha conexão com o banco
+ */
+export declare function closeDatabase(): Promise<void>;
+/**
+ * Executa query SQL e retorna resultados
+ */
+export declare function query<T = Record<string, unknown>>(sql: string): Promise<T[]>;
+export interface CausasFilters {
+    years?: number[];
+    months?: number[];
+    ufs?: string[];
+    municipalityCodes?: string[];
+    cidChapters?: number[];
+    cidGroups?: string[];
+    sex?: string;
+    ageMin?: number;
+    ageMax?: number;
+    races?: string[];
+    isCsap?: boolean;
+    csapGroups?: string[];
+}
+export interface IcsapFilters {
+    years?: number[];
+    ufs?: string[];
+    municipalityCodes?: string[];
+    csapGroups?: string[];
+    sex?: string;
+    ageMin?: number;
+    ageMax?: number;
+    races?: string[];
+}
+export interface SeriesFilters {
+    yearMonthStart?: string;
+    yearMonthEnd?: string;
+    ufs?: string[];
+    cidChapters?: number[];
+}
+/**
+ * Query no cubo de causas com agregação flexível
+ */
+export declare function queryCausas<T = Record<string, unknown>>(options: {
+    filters?: CausasFilters;
+    groupBy?: string[];
+    metrics?: ("n" | "days" | "value" | "deaths")[];
+    orderBy?: string;
+    limit?: number;
+}): Promise<T[]>;
+/**
+ * Query no cubo de ICSAP com agregação flexível
+ */
+export declare function queryIcsap<T = Record<string, unknown>>(options: {
+    filters?: IcsapFilters;
+    groupBy?: string[];
+    metrics?: ("n" | "n_total" | "days" | "value" | "deaths")[];
+    orderBy?: string;
+    limit?: number;
+    universe?: IcsapUniverse;
+}): Promise<T[]>;
+/**
+ * SQL de agregação do cubo ICSAP com o denominador CERTO.
+ *
+ * O cubo tem uma linha por (estrato × grupo CSAP) e, desde o builder 2.5.0,
+ * uma linha por estrato SEM ICSAP (csap_group nulo, n = 0); em todas,
+ * `n_total` é o total de internações do estrato (year, uf, municipality_code,
+ * cid_revision, sex, age, race). Até a 0.8.0 o servidor somava n_total linha
+ * a linha: o denominador saía multiplicado pelo número de grupos CSAP de cada
+ * estrato e sem os estratos que não tinham ICSAP nenhuma — 2023/RR dava
+ * icsap_percentage 3,65 % quando 9.577/48.480 = 19,75 % (defeito desde a
+ * primeira versão do cubo; achado em 07/09/2026 ao provar a era antiga e
+ * corrigido aqui, no funil, antes do rebuild dos 34 anos). O denominador é
+ * n_total somado sobre os estratos DISTINTOS; o numerador ignora as linhas de
+ * grupo nulo; o filtro por grupo CSAP só vale para o numerador (a fração é
+ * "internações do grupo / todas as internações do estrato").
+ */
+/**
+ * Universo do % ICSAP. "csapaih" (padrão, 0.10.0): como o pacote R csapAIH,
+ * fora do numerador E do denominador as internações com `exclusion` não nula
+ * (procedimento obstétrico, parto, longa permanência — builder >= 2.6.0).
+ * "all": todas as internações. Cubo anterior a 2.6.0 não tem a coluna: com
+ * union_by_name ela vem nula, o que equivale a "all" naquele ano.
+ */
+export type IcsapUniverse = "csapaih" | "all";
+/**
+ * Query no cubo de séries temporais
+ */
+export declare function querySeries<T = Record<string, unknown>>(options: {
+    filters?: SeriesFilters;
+    groupBy?: string[];
+    orderBy?: string;
+}): Promise<T[]>;
+/**
+ * Query para ranking de grupos CSAP
+ */
+export declare function rankCsapGroups<T = Record<string, unknown>>(options: {
+    filters?: IcsapFilters;
+    metric?: "n" | "days" | "value" | "deaths";
+    limit?: number;
+    universe?: IcsapUniverse;
+}): Promise<T[]>;
+/**
+ * Calcula indicadores de ICSAP (percentual)
+ */
+export declare function calculateIcsapIndicators<T = Record<string, unknown>>(options: {
+    filters?: IcsapFilters;
+    groupBy?: string[];
+    universe?: IcsapUniverse;
+}): Promise<T[]>;
+/**
+ * Onde os arquivos de população vivem (0.12.0, sih:populacao-no-canal): a
+ * pasta configurada (SIH_DATA_DIR ou data/ do projeto; nunca data/test/) tem
+ * precedência sempre que tiver pop_uf.parquet — é o caso da fixture do smoke
+ * e do golden e de quem gerou a população à mão; sem nada nela e com o cache
+ * ligado, o cache local, que `ensurePopulation()` (src/cache.ts) enche a
+ * partir do canal sih/cubos/ (pop_uf, pop_uf_agregado, pop_municipios +
+ * pop_provenance.json, assinados no bloco `population` do manifesto).
+ */
+export declare function getPopulationDir(): string;
+/** Padrão de arquivo para dados populacionais (pasta de getPopulationDir()). */
+export declare function getPopulationPattern(type: "municipios" | "uf" | "uf_agregado"): string;
+/** Verifica se algum arquivo de população está disponível em getPopulationDir(). */
+export declare function hasPopulationData(): boolean;
+/** Mensagem única para "sem denominador" — aponta o canal, não um script R. */
+export declare const POPULATION_MISSING_MESSAGE: string;
+/**
+ * Interface para filtros de população
+ */
+export interface PopulationFilters {
+    years?: number[];
+    ufs?: string[];
+    sex?: string;
+    ageMin?: number;
+    ageMax?: number;
+}
+/**
+ * Query população por UF (dados com idade simples)
+ */
+export declare function queryPopulationUf<T = Record<string, unknown>>(options: {
+    filters?: PopulationFilters;
+    groupBy?: string[];
+}): Promise<T[]>;
+/**
+ * Query população agregada por UF (para anos 1991-1999, com faixa etária)
+ */
+export declare function queryPopulationUfAgregado<T = Record<string, unknown>>(options: {
+    years?: number[];
+    ufs?: string[];
+    sex?: string;
+    /** Faixas de AGGREGATED_AGE_GROUPS; sem isto, todas — inclusive a idade ignorada (age_group nulo), que faz parte do total. */
+    ageGroups?: string[];
+    groupBy?: string[];
+}): Promise<T[]>;
+/** Faixas etárias quinquenais de pop_uf_agregado.parquet (1991–1999), na ordem. */
+export declare const AGGREGATED_AGE_GROUPS: string[];
+/**
+ * Faixas de pop_uf_agregado.parquet que cobrem EXATAMENTE [ageMin, ageMax].
+ * Devolve null quando o intervalo não cai nos limites das faixas (ex.: 0–14
+ * serve, 0–17 não): antes de 2000 só há população por faixa quinquenal, e uma
+ * taxa com denominador aproximado seria número errado com cara de certo.
+ * Sem filtro de idade devolve undefined (todas as faixas).
+ */
+export declare function aggregatedAgeGroupsFor(ageMin?: number, ageMax?: number): string[] | null | undefined;
+export interface PopulationCoverage {
+    /** União dos dois arquivos: o que as ferramentas de taxa aceitam. */
+    first_year: number;
+    last_year: number;
+    /** pop_uf.parquet — idade simples por UF e sexo (projeções IBGE, 2000+). */
+    detailed: {
+        first_year: number;
+        last_year: number;
+        source: string;
+        age: string;
+    } | null;
+    /** pop_uf_agregado.parquet — faixa etária quinquenal por UF e sexo (1991–1999). */
+    aggregated: {
+        first_year: number;
+        last_year: number;
+        source: string;
+        age: string;
+        age_groups: string[];
+    } | null;
+}
+/**
+ * Esquece a cobertura memoizada — chamada depois que ensurePopulation() baixa
+ * algum arquivo: uma chamada anterior pode ter memoizado `null` (sem
+ * população) antes do download.
+ */
+export declare function resetPopulationCoverageCache(): void;
+/**
+ * Cobertura populacional, lida dos próprios arquivos — nunca fixada no código.
+ * `first_year`/`last_year` é a união de pop_uf.parquet (idade simples, 2000+;
+ * a regra do CONTEXT.md diz que vai até o último ano de cubo FECHADO do SIH,
+ * e quem a cumpre é o build-population.R do healthbr-data) e de pop_uf_agregado.parquet
+ * (faixa etária, 1991–1999; sih:taxas-1992-1999). Antes de 2000 a taxa por
+ * idade só sai nas faixas do arquivo (aggregatedAgeGroupsFor). Devolve null
+ * sem nenhum dos dois arquivos.
+ */
+export declare function getPopulationCoverage(): Promise<PopulationCoverage | null>;
+/** Qual arquivo de população serve a um ano (null = nenhum). */
+export declare function populationSourceFor(year: number): Promise<"detailed" | "aggregated" | null>;
+/**
+ * Compatibilidade: o intervalo aceito pelas taxas (união dos dois arquivos).
+ * Devolve null sem população.
+ */
+export declare function getPopulationYearRange(): Promise<{
+    first_year: number;
+    last_year: number;
+} | null>;
+/**
+ * Obtém população total para um filtro específico.
+ * Hierarquia de fontes:
+ *   1. pop_uf.parquet (idade simples, anos >= 2000)
+ *   2. pop_uf_agregado.parquet (faixa etária, anos 1991-1999)
+ *   3. pop_municipios.parquet (fallback, agregando por UF)
+ */
+export declare function getPopulation(options: {
+    year: number;
+    uf?: string[];
+    sex?: string;
+    ageMin?: number;
+    ageMax?: number;
+}): Promise<number>;
+/**
+ * Obtém população por UF para um ano.
+ * Usa pop_uf.parquet se disponível, senão agrega pop_municipios.parquet.
+ */
+export declare function getPopulationByUf(options: {
+    year: number;
+    sex?: string;
+    ageMin?: number;
+    ageMax?: number;
+}): Promise<Record<string, number>>;
+//# sourceMappingURL=duckdb.d.ts.map

package/dist/db/duckdb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb.d.ts","sourceRoot":"","sources":["../../src/db/duckdb.ts"],"names":[],"mappings":"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"}