sih-br-mcp 0.12.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sidney Bissoli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,101 @@
+# sih-br-mcp
+
+Servidor MCP (Model Context Protocol) para análise das internações hospitalares do
+SUS (SIH/SUS, AIH reduzida) com foco em ICSAP — internações por condições sensíveis
+à atenção primária. Doze ferramentas sobre cubos anuais de 1992 a 2025 (causas por
+capítulo/grupo CID, séries mensais, ICSAP por município, taxas por 100 mil), com a
+proveniência da safra em cada resposta.
+
+## De onde vêm os dados
+
+Este servidor é **consumidor** do canal público `sih/cubos/` do projeto
+[healthbr-data](https://github.com/SidneyBissoli/healthbr-data):
+
+```
+Ministério da Saúde / DATASUS (RD<UF><AAMM>.dbc, FTP)
+  → healthbr-data sih/rd/ (Parquet 1:1, manifesto com MD5 e data de download)
+  → healthbr-data pipeline sih-cubos (scripts/pipeline/sih-cubos/build-aggregations.R)
+  → https://data.sidneybissoli.com/sih/cubos/  (cubos + sidecar por ano + manifest.json + tables/)
+  → este servidor (cache local sob demanda, SHA-256 conferido contra o manifesto)
+```
+
+Até 08/09/2026 o builder dos cubos vivia aqui (`scripts/build-aggregations.R`,
+`rebuild-cubes.yml`); desde então o produtor é o healthbr-data e este repositório
+não gera nem publica cubo nenhum (CONTEXT.md, decisão 27). A receita completa está
+em `healthbr-data/scripts/pipeline/sih-cubos/README.md` e no card
+[`sih-cubos`](https://github.com/SidneyBissoli/healthbr-data/blob/master/guides/dataset-cards/sih-cubos-README.md).
+
+- **Cubos:** baixados por ano, só os que a chamada pede, para
+  `~/.cache/sih-br-mcp/cubos/` (`SIH_CACHE_DIR`), com o sidecar
+  `sih_provenance_<ano>.json` ao lado. `SIH_CUBES_BASE_URL` aponta outro canal;
+  `SIH_CUBES_CACHE=off` desliga (smoke e golden usam).
+- **Frescor:** `src/freshness.ts` compara o sidecar com `sih/rd/manifest-summary.json`
+  e avisa quando um cubo está atrás do espelho; quem reconstrói é o produtor
+  (`rebuild-sih-cubes.yml`, toda terça e após cada manutenção do espelho).
+- **Tabelas de classificação** (`src/data/`): cópias do contrato publicado em
+  `sih/cubos/tables/`; `npm run tables:check` confere o SHA-256 contra o manifesto
+  (roda no CI). Nunca edite aqui — a fonte é o produtor.
+- **População** (`pop_uf.parquet`, `pop_uf_agregado.parquet`, `pop_municipios.parquet`):
+  desde a 0.12.0 vem do mesmo canal, assinada no bloco `population` do `manifest.json`
+  (produtor: `build-population.R` + `build-sih-population.yml` do healthbr-data — IBGE,
+  Projeção 2024 por UF; DATASUS POPBR/POPSVS por município). As ferramentas de taxa
+  (`get_hospitalization_rates`, `compare_icsap_trends` com `rate_per_10k`) e
+  `get_available_years` baixam os três arquivos para o cache na primeira chamada,
+  com SHA-256 conferido; uma pasta de dados que já tenha `pop_uf.parquet` tem
+  precedência (fixture, build local). A proveniência da população responde com o
+  `built_at` do manifesto.
+
+## Uso
+
+Pacote no npm: [`sih-br-mcp`](https://www.npmjs.com/package/sih-br-mcp) (Node 22+).
+Ele não embarca dado nenhum — cubos, tabelas e população vêm do canal na primeira
+chamada e ficam no cache local.
+
+```bash
+npx -y sih-br-mcp           # stdio
+```
+
+Configuração num cliente MCP (Claude Desktop, Claude Code):
+
+```json
+{ "mcpServers": { "sih": { "command": "npx", "args": ["-y", "sih-br-mcp"] } } }
+```
+
+A partir do código-fonte:
+
+```bash
+npm install
+npm run build
+node dist/index.js          # stdio
+```
+
+Variáveis: `SIH_DATA_DIR` (pasta com cubos já prontos, em vez do cache),
+`SIH_CACHE_DIR`, `SIH_CUBES_BASE_URL`, `SIH_CUBES_CACHE=off`,
+`SIH_FRESHNESS_CHECK=off`.
+
+## Verificação
+
+```bash
+npm ci && npm run build
+npm run smoke:stdio         # superfície das ferramentas × baselines/surface-stdio.json
+npm run golden:tools        # 12 ferramentas byte a byte × baselines/golden-tools.json (fixture 2023/RR)
+npm run freshness:selftest  # frescor offline sobre um trecho versionado do manifesto
+npm run cache:selftest      # cache local (download + SHA-256) contra um canal falso
+npm run tables:check        # tabelas de src/data × manifesto do canal
+```
+
+O CI (`.github/workflows/ci.yml`) roda tudo isso em Node 22 e 24. A fixture
+`tests/fixtures/sih/` é uma cópia real dos cubos de 2023/RR gerados pelo builder
+(hoje no healthbr-data) — é o que torna medível qualquer bump.
+
+## Documentação
+
+- `CONTEXT.md` — decisões arquiteturais numeradas (a 27 é a migração do produtor).
+- `docs/analise-001` (janela de competências), `analise-002` (era CID-9, 1992–1997),
+  `analise-003` (lista ICSAP em CID-9 derivada), `plan-002` (DuckDB Node Neo),
+  `plan-003` (rebuild automático, hoje no healthbr-data), `tool-specifications.md`.
+
+## Licença
+
+MIT (`LICENSE`). Os dados são do Ministério da Saúde / DATASUS; a redistribuição em
+Parquet e os cubos derivados são do healthbr-data (CC-BY-4.0).

package/dist/cache.d.ts

@@ -0,0 +1,108 @@
+export declare const CUBES_BASE_URL: string;
+export declare const CUBES_CACHE_ENABLED: boolean;
+export type CubeKind = "causas" | "series" | "icsap";
+export interface CubesManifestFile {
+    name: string;
+    size_bytes: number;
+    sha256: string;
+}
+export interface CubesManifestYear {
+    built_at: string | null;
+    builder_version: string | null;
+    records_in_cube: number | null;
+    window_complete: boolean | null;
+    ufs: number | null;
+    manifest_last_updated: string | null;
+    files: Record<CubeKind | "provenance", CubesManifestFile>;
+}
+export type PopulationKind = "pop_uf" | "pop_uf_agregado" | "pop_municipios";
+/**
+ * >= 1.2.0 (2026-09-08, sih:populacao-no-canal): os denominadores populacionais
+ * publicados ao lado dos cubos pelo build-sih-population.yml do healthbr-data
+ * (build-population.R): pop_uf (IBGE, Projeção 2024, UF × sexo × idade simples,
+ * 2000..último cubo FECHADO), pop_municipios (DATASUS POPBR/POPSVS 1991–2024),
+ * pop_uf_agregado (soma por UF, 1991–1999) e o sidecar pop_provenance.json.
+ */
+export interface CubesManifestPopulation {
+    built_at: string | null;
+    builder_version: string | null;
+    /** Último ano de pop_uf = último cubo FECHADO do SIH (regra do CONTEXT.md). */
+    last_year: number | null;
+    rule?: string | null;
+    sources?: Array<{
+        file: string;
+        name: string;
+        agency?: string | null;
+        url?: string | null;
+        years?: string | null;
+    }>;
+    files: Record<PopulationKind | "provenance", CubesManifestFile>;
+}
+export interface CubesManifest {
+    manifest_version: string;
+    dataset: string;
+    generated_at: string;
+    base_url: string;
+    /** >= 1.1.0 (2026-09-08): quem gerou — repositório e pipeline do produtor. */
+    producer?: {
+        repository?: string;
+        pipeline?: string;
+        workflow?: string | null;
+        run_url?: string | null;
+    };
+    /** >= 1.1.0: tabelas de classificação publicadas em tables/, com SHA-256 — src/data/ é cópia (scripts/tables-check.mjs). */
+    tables?: Record<string, CubesManifestFile>;
+    /** >= 1.2.0: denominadores populacionais; null/ausente em manifesto anterior à população (não é erro do canal). */
+    population?: CubesManifestPopulation | null;
+    years: Record<string, CubesManifestYear>;
+}
+export declare function cubesCacheDir(): string;
+/** Anos com os três cubos presentes numa pasta. */
+export declare function yearsPresent(dir: string): number[];
+/** Os três arquivos de população presentes numa pasta (o sidecar é opcional). */
+export declare function populationPresent(dir: string): boolean;
+/**
+ * Manifesto do canal: remoto (timeout curto), senão a cópia em disco da última
+ * vez, senão null. Memoizado por 10 min. Nunca lança.
+ */
+export declare function loadCubesManifest(opts?: {
+    timeoutMs?: number;
+}): Promise<{
+    manifest: CubesManifest | null;
+    source: "remote" | "disk" | "none";
+}>;
+export declare function publishedYears(manifest: CubesManifest | null): number[];
+/** Só para testes: injeta um manifesto e zera a memoização. */
+export declare function setCubesManifestForTests(manifest: CubesManifest | null): void;
+/**
+ * O manifesto já carregado nesta execução (memoizado), sem ir à rede — para
+ * quem é síncrono, como populationProvenance(): depois de ensurePopulation()
+ * o memo está cheio; com o cache desligado (fixture, golden) fica null.
+ */
+export declare function cachedCubesManifest(): CubesManifest | null;
+/** Um ano completo = três cubos + sidecar, todos verificados. Idempotente e sem corrida. */
+export declare function ensureYear(dir: string, year: number, manifest: CubesManifest, log?: (msg: string) => void): Promise<void>;
+/**
+ * Garante os anos pedidos na pasta; `null` = todos os anos publicados (chamada
+ * sem ano explícito varre a série inteira). Devolve o que baixou e o que não
+ * existe no canal. Falha de rede num ano lança — o handler decide a mensagem.
+ */
+export declare function ensureYears(dir: string, years: number[] | null, log?: (msg: string) => void): Promise<{
+    downloaded: number[];
+    unavailable: number[];
+}>;
+/**
+ * Garante os denominadores populacionais (três Parquet + pop_provenance.json)
+ * na pasta, baixados do canal e verificados como um ano de cubos. Idempotente
+ * (arquivo presente com o tamanho do manifesto não baixa) e sem corrida.
+ * `available = false` quando o manifesto do canal não tem o bloco `population`
+ * (manifesto anterior a 1.2.0) — o handler responde "sem denominador", não
+ * "erro do canal". Falha de rede lança — o handler decide a mensagem.
+ */
+export declare function ensurePopulation(dir: string, log?: (msg: string) => void): Promise<{
+    downloaded: string[];
+    available: boolean;
+}>;
+/** Anos que uma chamada de ferramenta pede, lidos dos argumentos; null = não diz. */
+export declare function yearsFromArgs(args: unknown): number[] | null;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

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

package/dist/cache.js

@@ -0,0 +1,270 @@
+/**
+ * Cache local dos cubos — item (c) de `sih:cubos-frescor` (2026-09-06).
+ *
+ * Os cubos anuais (`sih_{causas,series,icsap}_<ano>.parquet` + sidecar) são
+ * publicados pela pipeline sih-cubos do healthbr-data (rebuild-sih-cubes.yml;
+ * até 08/09/2026 o produtor era o rebuild-cubes.yml deste repositório) em
+ * `sih/cubos/` do bucket, servido em https://data.sidneybissoli.com/sih/cubos/
+ * com um `manifest.json` (tamanho e SHA-256 por arquivo e por tabela de
+ * classificação; healthbr-data scripts/pipeline/sih-cubos/cubes-manifest.mjs). O pacote npm
+ * NÃO embarca cubo nenhum (~60 MB por ano): quando a pasta de dados do
+ * projeto não tem cubos, o servidor usa `~/.cache/sih-br-mcp/cubos/` e baixa
+ * de lá só os anos que a chamada pede, verificando SHA-256 antes de aceitar.
+ *
+ * Variáveis de ambiente:
+ *   SIH_CUBES_CACHE=off      desliga tudo (smoke e golden usam: o baseline não
+ *                            pode depender de rede — ver docs/plan-003).
+ *   SIH_CACHE_DIR=<pasta>    onde guardar (padrão ~/.cache/sih-br-mcp/cubos).
+ *   SIH_CUBES_BASE_URL=<url> outro canal (espelho, teste local).
+ *
+ * O que NÃO faz: não apaga nada, não atualiza cubo já presente (quem decide
+ * que um cubo está atrás é o frescor, `src/freshness.ts`; a reposição é
+ * apagar o arquivo do cache e chamar de novo).
+ */
+import { createHash } from "node:crypto";
+import { createWriteStream, existsSync, mkdirSync, readFileSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+export const CUBES_BASE_URL = (process.env.SIH_CUBES_BASE_URL ?? "https://data.sidneybissoli.com/sih/cubos/").replace(/\/?$/, "/");
+export const CUBES_CACHE_ENABLED = process.env.SIH_CUBES_CACHE !== "off";
+const CUBE_KINDS = ["causas", "series", "icsap"];
+const POPULATION_KINDS = ["pop_uf", "pop_uf_agregado", "pop_municipios"];
+export function cubesCacheDir() {
+    return process.env.SIH_CACHE_DIR ? resolve(process.env.SIH_CACHE_DIR) : join(homedir(), ".cache", "sih-br-mcp", "cubos");
+}
+/** Anos com os três cubos presentes numa pasta. */
+export function yearsPresent(dir) {
+    if (!existsSync(dir))
+        return [];
+    const years = new Set();
+    for (let y = 1990; y <= 2100; y++) {
+        if (CUBE_KINDS.every((k) => existsSync(join(dir, `sih_${k}_${y}.parquet`))))
+            years.add(y);
+    }
+    return [...years].sort((a, b) => a - b);
+}
+/** Os três arquivos de população presentes numa pasta (o sidecar é opcional). */
+export function populationPresent(dir) {
+    return existsSync(dir) && POPULATION_KINDS.every((k) => existsSync(join(dir, `${k}.parquet`)));
+}
+// ---------------------------------------------------------------------------
+// Manifesto
+const MANIFEST_TTL_MS = 10 * 60 * 1000;
+let manifestMemo = null;
+function parseManifest(text) {
+    try {
+        const m = JSON.parse(text);
+        if (!m || typeof m !== "object" || typeof m.years !== "object")
+            return null;
+        return m;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Manifesto do canal: remoto (timeout curto), senão a cópia em disco da última
+ * vez, senão null. Memoizado por 10 min. Nunca lança.
+ */
+export async function loadCubesManifest(opts = {}) {
+    if (manifestMemo && Date.now() - manifestMemo.at < MANIFEST_TTL_MS)
+        return manifestMemo;
+    const diskPath = join(cubesCacheDir(), "manifest.json");
+    let manifest = null;
+    let source = "none";
+    try {
+        const res = await fetch(CUBES_BASE_URL + "manifest.json", { signal: AbortSignal.timeout(opts.timeoutMs ?? 8000) });
+        if (res.ok) {
+            const text = await res.text();
+            manifest = parseManifest(text);
+            if (manifest) {
+                source = "remote";
+                try {
+                    mkdirSync(cubesCacheDir(), { recursive: true });
+                    writeFileSync(diskPath, text);
+                }
+                catch {
+                    /* cache em disco é conveniência */
+                }
+            }
+        }
+    }
+    catch {
+        /* rede indisponível: cai para o disco */
+    }
+    if (!manifest && existsSync(diskPath)) {
+        manifest = parseManifest(readFileSync(diskPath, "utf8"));
+        if (manifest)
+            source = "disk";
+    }
+    manifestMemo = { at: Date.now(), manifest, source };
+    return manifestMemo;
+}
+export function publishedYears(manifest) {
+    if (!manifest)
+        return [];
+    return Object.keys(manifest.years).map(Number).filter((y) => Number.isFinite(y)).sort((a, b) => a - b);
+}
+/** Só para testes: injeta um manifesto e zera a memoização. */
+export function setCubesManifestForTests(manifest) {
+    manifestMemo = manifest ? { at: Date.now(), manifest, source: "remote" } : null;
+}
+/**
+ * O manifesto já carregado nesta execução (memoizado), sem ir à rede — para
+ * quem é síncrono, como populationProvenance(): depois de ensurePopulation()
+ * o memo está cheio; com o cache desligado (fixture, golden) fica null.
+ */
+export function cachedCubesManifest() {
+    return manifestMemo?.manifest ?? null;
+}
+// ---------------------------------------------------------------------------
+// Download com verificação
+async function sha256File(path) {
+    const { createReadStream } = await import("node:fs");
+    return new Promise((res, rej) => {
+        const h = createHash("sha256");
+        createReadStream(path).on("data", (d) => h.update(d)).on("end", () => res(h.digest("hex"))).on("error", rej);
+    });
+}
+async function downloadVerified(file, dir, timeoutMs) {
+    // ?v=<sha256>: os objetos do canal são reescritos NO LUGAR a cada rebuild e a
+    // borda do domínio guarda cópia pelo Cache-Control do objeto — sem isto, um
+    // consumidor recebia o cubo do build anterior (HIT, Age 15 h) enquanto o
+    // manifesto já assinava o novo, e a verificação abaixo falhava (2026-09-08,
+    // sih_series_2023: 36.047 bytes servidos vs 36.352 no manifesto). A query
+    // entra na chave de cache: versão nova = URL nova = nunca a cópia velha.
+    const url = `${CUBES_BASE_URL}${file.name}?v=${file.sha256.slice(0, 16)}`;
+    const final = join(dir, file.name);
+    const tmp = `${final}.part-${process.pid}`;
+    const res = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
+    if (!res.ok || !res.body)
+        throw new Error(`${url}: HTTP ${res.status}`);
+    await pipeline(Readable.fromWeb(res.body), createWriteStream(tmp));
+    const size = statSync(tmp).size;
+    if (size !== file.size_bytes) {
+        unlinkSync(tmp);
+        throw new Error(`${file.name}: ${size} bytes recebidos, manifesto diz ${file.size_bytes}`);
+    }
+    const digest = await sha256File(tmp);
+    if (digest !== file.sha256) {
+        unlinkSync(tmp);
+        throw new Error(`${file.name}: SHA-256 não confere com o manifesto`);
+    }
+    renameSync(tmp, final);
+}
+const inFlight = new Map();
+/** Um ano completo = três cubos + sidecar, todos verificados. Idempotente e sem corrida. */
+export function ensureYear(dir, year, manifest, log = () => { }) {
+    const entry = manifest.years[String(year)];
+    if (!entry)
+        return Promise.reject(new Error(`ano ${year} não está no canal ${CUBES_BASE_URL}`));
+    const have = inFlight.get(year);
+    if (have)
+        return have;
+    const p = (async () => {
+        mkdirSync(dir, { recursive: true });
+        const wanted = [...CUBE_KINDS.map((k) => entry.files[k]), entry.files.provenance].filter(Boolean);
+        for (const f of wanted) {
+            const path = join(dir, f.name);
+            if (existsSync(path) && statSync(path).size === f.size_bytes)
+                continue;
+            const t0 = Date.now();
+            log(`baixando ${f.name} (${(f.size_bytes / 1e6).toFixed(1)} MB) de ${CUBES_BASE_URL}`);
+            await downloadVerified(f, dir, 10 * 60 * 1000);
+            log(`  ${f.name} ok em ${((Date.now() - t0) / 1000).toFixed(1)} s (SHA-256 confere)`);
+        }
+    })().finally(() => inFlight.delete(year));
+    inFlight.set(year, p);
+    return p;
+}
+/**
+ * Garante os anos pedidos na pasta; `null` = todos os anos publicados (chamada
+ * sem ano explícito varre a série inteira). Devolve o que baixou e o que não
+ * existe no canal. Falha de rede num ano lança — o handler decide a mensagem.
+ */
+export async function ensureYears(dir, years, log) {
+    const { manifest } = await loadCubesManifest();
+    if (!manifest)
+        throw new Error(`manifesto dos cubos indisponível (${CUBES_BASE_URL}manifest.json) e sem cópia local`);
+    const present = new Set(yearsPresent(dir));
+    const wanted = (years ?? publishedYears(manifest)).filter((y) => !present.has(y));
+    const downloaded = [];
+    const unavailable = [];
+    for (const y of wanted) {
+        if (!manifest.years[String(y)]) {
+            unavailable.push(y);
+            continue;
+        }
+        await ensureYear(dir, y, manifest, log);
+        downloaded.push(y);
+    }
+    return { downloaded, unavailable };
+}
+let populationInFlight = null;
+/**
+ * Garante os denominadores populacionais (três Parquet + pop_provenance.json)
+ * na pasta, baixados do canal e verificados como um ano de cubos. Idempotente
+ * (arquivo presente com o tamanho do manifesto não baixa) e sem corrida.
+ * `available = false` quando o manifesto do canal não tem o bloco `population`
+ * (manifesto anterior a 1.2.0) — o handler responde "sem denominador", não
+ * "erro do canal". Falha de rede lança — o handler decide a mensagem.
+ */
+export function ensurePopulation(dir, log = () => { }) {
+    if (populationInFlight)
+        return populationInFlight;
+    const p = (async () => {
+        const { manifest } = await loadCubesManifest();
+        if (!manifest)
+            throw new Error(`manifesto dos cubos indisponível (${CUBES_BASE_URL}manifest.json) e sem cópia local`);
+        const pop = manifest.population;
+        if (!pop || !pop.files)
+            return { downloaded: [], available: false };
+        mkdirSync(dir, { recursive: true });
+        const wanted = [...POPULATION_KINDS.map((k) => pop.files[k]), pop.files.provenance].filter(Boolean);
+        const downloaded = [];
+        for (const f of wanted) {
+            const path = join(dir, f.name);
+            if (existsSync(path) && statSync(path).size === f.size_bytes)
+                continue;
+            const t0 = Date.now();
+            log(`baixando ${f.name} (${(f.size_bytes / 1e6).toFixed(1)} MB) de ${CUBES_BASE_URL}`);
+            await downloadVerified(f, dir, 10 * 60 * 1000);
+            log(`  ${f.name} ok em ${((Date.now() - t0) / 1000).toFixed(1)} s (SHA-256 confere)`);
+            downloaded.push(f.name);
+        }
+        return { downloaded, available: true };
+    })().finally(() => {
+        populationInFlight = null;
+    });
+    populationInFlight = p;
+    return p;
+}
+/** Anos que uma chamada de ferramenta pede, lidos dos argumentos; null = não diz. */
+export function yearsFromArgs(args) {
+    if (!args || typeof args !== "object")
+        return null;
+    const a = args;
+    const out = new Set();
+    const push = (v) => {
+        if (Array.isArray(v))
+            v.forEach(push);
+        else if (typeof v === "number" && Number.isFinite(v))
+            out.add(v);
+        else if (typeof v === "string" && /^\d{4}$/.test(v))
+            out.add(Number(v));
+    };
+    push(a.year);
+    push(a.years);
+    if (typeof a.start_year === "number" && typeof a.end_year === "number" && a.end_year >= a.start_year) {
+        for (let y = a.start_year; y <= a.end_year; y++)
+            out.add(y);
+    }
+    else {
+        push(a.start_year);
+        push(a.end_year);
+    }
+    return out.size ? [...out].sort((x, y) => x - y) : null;
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClI,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,2CAA2C,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACnI,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,KAAK,CAAC;AAGzE,MAAM,UAAU,GAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAmB7D,MAAM,gBAAgB,GAAqB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;AAiC3F,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;AAC3H,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,8EAA8E;AAC9E,YAAY;AAEZ,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACvC,IAAI,YAAY,GAA8F,IAAI,CAAC;AAEnH,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAC;QAC5C,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC5E,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAI,GAA2B,EAAE;IACvE,IAAI,YAAY,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,EAAE,GAAG,eAAe;QAAE,OAAO,YAAY,CAAC;IACxF,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,EAAE,eAAe,CAAC,CAAC;IACxD,IAAI,QAAQ,GAAyB,IAAI,CAAC;IAC1C,IAAI,MAAM,GAA+B,MAAM,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,cAAc,GAAG,eAAe,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;QACnH,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,GAAG,QAAQ,CAAC;gBAClB,IAAI,CAAC;oBACH,SAAS,CAAC,aAAa,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBAChD,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBAChC,CAAC;gBAAC,MAAM,CAAC;oBACP,mCAAmC;gBACrC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yCAAyC;IAC3C,CAAC;IACD,IAAI,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QACzD,IAAI,QAAQ;YAAE,MAAM,GAAG,MAAM,CAAC;IAChC,CAAC;IACD,YAAY,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACpD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAA8B;IAC3D,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACzG,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,wBAAwB,CAAC,QAA8B;IACrE,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAClF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,YAAY,EAAE,QAAQ,IAAI,IAAI,CAAC;AACxC,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAE3B,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IACrD,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC9B,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC/B,gBAAgB,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC/G,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,IAAuB,EAAE,GAAW,EAAE,SAAiB;IACrF,8EAA8E;IAC9E,4EAA4E;IAC5E,yEAAyE;IACzE,4EAA4E;IAC5E,0EAA0E;IAC1E,yEAAyE;IACzE,MAAM,GAAG,GAAG,GAAG,cAAc,GAAG,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,GAAG,KAAK,SAAS,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACzE,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,UAAU,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACxE,MAAM,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAgD,CAAC,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/G,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAChC,IAAI,IAAI,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7B,UAAU,CAAC,GAAG,CAAC,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,mCAAmC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3B,UAAU,CAAC,GAAG,CAAC,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,uCAAuC,CAAC,CAAC;IACvE,CAAC;IACD,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;AAElD,4FAA4F;AAC5F,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,IAAY,EAAE,QAAuB,EAAE,GAAG,GAA0B,GAAG,EAAE,GAAE,CAAC;IAClH,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,IAAI,sBAAsB,cAAc,EAAE,CAAC,CAAC,CAAC;IAChG,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;QACpB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,MAAM,MAAM,GAAwB,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvH,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,UAAU;gBAAE,SAAS;YACvE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,cAAc,EAAE,CAAC,CAAC;YACvF,MAAM,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAC/C,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC;QACxF,CAAC;IACH,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1C,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACtB,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,KAAsB,EAAE,GAA2B;IAChG,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAC/C,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,cAAc,kCAAkC,CAAC,CAAC;IACtH,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,CAAC,KAAK,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QACD,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QACxC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;AACrC,CAAC;AAED,IAAI,kBAAkB,GAAiE,IAAI,CAAC;AAE5F;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,GAAG,GAA0B,GAAG,EAAE,GAAE,CAAC;IACjF,IAAI,kBAAkB;QAAE,OAAO,kBAAkB,CAAC;IAClD,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,cAAc,kCAAkC,CAAC,CAAC;QACtH,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC;QAChC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK;YAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACpE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,MAAM,MAAM,GAAwB,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACzH,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,UAAU;gBAAE,SAAS;YACvE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACtB,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,cAAc,EAAE,CAAC,CAAC;YACvF,MAAM,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAC/C,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC;YACtF,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;QAChB,kBAAkB,GAAG,IAAI,CAAC;IAC5B,CAAC,CAAC,CAAC;IACH,kBAAkB,GAAG,CAAC,CAAC;IACvB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,CAAC,GAAG,IAA+B,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,MAAM,IAAI,GAAG,CAAC,CAAU,EAAE,EAAE;QAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;aACjC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;aAC5D,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC;IACF,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACb,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACd,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;QACrG,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,EAAE;YAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QACnB,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC"}

package/dist/data/brazil-regions.json

@@ -0,0 +1,68 @@
+{
+    "metadata": {
+        "source": "IBGE",
+        "total_regions": 5,
+        "total_ufs": 27
+    },
+    "regions": [
+        {
+            "code": "N",
+            "name_pt": "Norte",
+            "name_en": "North",
+            "ufs": ["AC", "AM", "AP", "PA", "RO", "RR", "TO"]
+        },
+        {
+            "code": "NE",
+            "name_pt": "Nordeste",
+            "name_en": "Northeast",
+            "ufs": ["AL", "BA", "CE", "MA", "PB", "PE", "PI", "RN", "SE"]
+        },
+        {
+            "code": "SE",
+            "name_pt": "Sudeste",
+            "name_en": "Southeast",
+            "ufs": ["ES", "MG", "RJ", "SP"]
+        },
+        {
+            "code": "S",
+            "name_pt": "Sul",
+            "name_en": "South",
+            "ufs": ["PR", "RS", "SC"]
+        },
+        {
+            "code": "CO",
+            "name_pt": "Centro-Oeste",
+            "name_en": "Central-West",
+            "ufs": ["DF", "GO", "MS", "MT"]
+        }
+    ],
+    "ufs": [
+        { "code": "AC", "ibge_code": "12", "name": "Acre", "region": "N", "capital": "Rio Branco" },
+        { "code": "AL", "ibge_code": "27", "name": "Alagoas", "region": "NE", "capital": "Maceió" },
+        { "code": "AM", "ibge_code": "13", "name": "Amazonas", "region": "N", "capital": "Manaus" },
+        { "code": "AP", "ibge_code": "16", "name": "Amapá", "region": "N", "capital": "Macapá" },
+        { "code": "BA", "ibge_code": "29", "name": "Bahia", "region": "NE", "capital": "Salvador" },
+        { "code": "CE", "ibge_code": "23", "name": "Ceará", "region": "NE", "capital": "Fortaleza" },
+        { "code": "DF", "ibge_code": "53", "name": "Distrito Federal", "region": "CO", "capital": "Brasília" },
+        { "code": "ES", "ibge_code": "32", "name": "Espírito Santo", "region": "SE", "capital": "Vitória" },
+        { "code": "GO", "ibge_code": "52", "name": "Goiás", "region": "CO", "capital": "Goiânia" },
+        { "code": "MA", "ibge_code": "21", "name": "Maranhão", "region": "NE", "capital": "São Luís" },
+        { "code": "MG", "ibge_code": "31", "name": "Minas Gerais", "region": "SE", "capital": "Belo Horizonte" },
+        { "code": "MS", "ibge_code": "50", "name": "Mato Grosso do Sul", "region": "CO", "capital": "Campo Grande" },
+        { "code": "MT", "ibge_code": "51", "name": "Mato Grosso", "region": "CO", "capital": "Cuiabá" },
+        { "code": "PA", "ibge_code": "15", "name": "Pará", "region": "N", "capital": "Belém" },
+        { "code": "PB", "ibge_code": "25", "name": "Paraíba", "region": "NE", "capital": "João Pessoa" },
+        { "code": "PE", "ibge_code": "26", "name": "Pernambuco", "region": "NE", "capital": "Recife" },
+        { "code": "PI", "ibge_code": "22", "name": "Piauí", "region": "NE", "capital": "Teresina" },
+        { "code": "PR", "ibge_code": "41", "name": "Paraná", "region": "S", "capital": "Curitiba" },
+        { "code": "RJ", "ibge_code": "33", "name": "Rio de Janeiro", "region": "SE", "capital": "Rio de Janeiro" },
+        { "code": "RN", "ibge_code": "24", "name": "Rio Grande do Norte", "region": "NE", "capital": "Natal" },
+        { "code": "RO", "ibge_code": "11", "name": "Rondônia", "region": "N", "capital": "Porto Velho" },
+        { "code": "RR", "ibge_code": "14", "name": "Roraima", "region": "N", "capital": "Boa Vista" },
+        { "code": "RS", "ibge_code": "43", "name": "Rio Grande do Sul", "region": "S", "capital": "Porto Alegre" },
+        { "code": "SC", "ibge_code": "42", "name": "Santa Catarina", "region": "S", "capital": "Florianópolis" },
+        { "code": "SE", "ibge_code": "28", "name": "Sergipe", "region": "NE", "capital": "Aracaju" },
+        { "code": "SP", "ibge_code": "35", "name": "São Paulo", "region": "SE", "capital": "São Paulo" },
+        { "code": "TO", "ibge_code": "17", "name": "Tocantins", "region": "N", "capital": "Palmas" }
+    ]
+}