@mcpassure/mcp-anvisa-bulario 0.0.1 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MCPAssure Brasil
+
+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.en.md

@@ -0,0 +1,196 @@
+**[🇧🇷 Português (BR)](./README.md) · 🇺🇸 English**
+
+---
+
+# @mcpassure/mcp-anvisa-bulario
+
+**MCPAssure Catalog — Wave 1** — MCP server for querying the ANVISA Electronic Drug Information Database (Bulário Eletrônico).
+
+Enables AI agents (Claude, GPT, Copilot) to query drug leaflets (bulas), active ingredients, therapeutic classes, and other metadata for medications registered in Brazil, with structured responses and efficient caching.
+
+[![CI](https://github.com/mcpassure/mcp-anvisa-bulario/actions/workflows/ci.yml/badge.svg)](https://github.com/mcpassure/mcp-anvisa-bulario/actions)
+[![npm](https://img.shields.io/npm/v/@mcpassure/mcp-anvisa-bulario)](https://www.npmjs.com/package/@mcpassure/mcp-anvisa-bulario)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+---
+
+## Quick install
+
+```bash
+npx -y @mcpassure/mcp-anvisa-bulario
+```
+
+On first install, `postinstall` downloads the Playwright Chromium browser (~150MB). This is required by the HTTP transport (see [Requirements](#requirements)).
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "anvisa-bulario": {
+      "command": "npx",
+      "args": ["-y", "@mcpassure/mcp-anvisa-bulario"]
+    }
+  }
+}
+```
+
+### VS Code / Claude Code
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "anvisa-bulario": {
+        "command": "npx",
+        "args": ["-y", "@mcpassure/mcp-anvisa-bulario"]
+      }
+    }
+  }
+}
+```
+
+---
+
+## Available Tools
+
+| Tool | Description |
+|---|---|
+| `buscar_por_nome` | Search by trade name (nome comercial) |
+| `buscar_por_principio_ativo` | Search by INN/DCB active ingredient (princípio ativo) |
+| `buscar_por_classe_terapeutica` | Search by therapeutic class |
+| `filtrar_por_tarja` | Filter by controlled-substance tier (LIVRE/OTC, VERMELHA/Rx, PRETA/special-control) |
+| `consultar_bula` | Retrieve full drug data + leaflet PDF links (bula) |
+| `listar_apresentacoes` | List commercial presentations/packaging of a medication |
+
+---
+
+## Available Prompts
+
+| Prompt | Description |
+|---|---|
+| `verificar_medicamento_completo` | Consolidates trade name, active ingredient, class, controlled-substance tier, presentations, and (optionally) leaflet for a search term |
+| `comparar_tarjas_por_classe` | Groups medications of a therapeutic class by controlled-substance tier |
+| `analisar_apresentacoes` | Groups a medication's presentations by dosage strength, pharmaceutical form, or manufacturer |
+
+---
+
+## Available Resources
+
+| URI | Type | Description |
+|---|---|---|
+| `bulario://tarjas` | `application/json` | Regulatory taxonomy of controlled-substance tiers (RDC 357/2020, Ordinance 344/98) |
+| `bulario://classes_terapeuticas` | `application/json` | List of main indexed therapeutic classes |
+| `bulario://scope` | `text/markdown` | MCP scope (PT/EN): what it does/doesn't do, regulatory disclaimer |
+
+---
+
+## Demo
+
+![Demo](./.github/assets/demo.gif)
+
+To run locally:
+
+```bash
+npm run demo
+```
+
+---
+
+## Understanding Brazilian drug tiers (Tarja)
+
+Brazil uses a **tarja** (literally "stripe/band") system to classify medication control requirements — there is no direct English equivalent:
+
+| Tarja | English equivalent | Control level |
+|---|---|---|
+| **Sem Tarja** | OTC / Over-the-counter | No prescription required |
+| **Tarja Amarela** (Yellow-banded) | Prescription-only (mild control) | Antibiotics and similar — prescription required, receipt not retained |
+| **Tarja Vermelha** (Red-banded) | Prescription-only (standard) | Receipt retained by pharmacy |
+| **Tarja Preta** (Black-banded) | **Controlled substance** — Brazilian Ordinance SVS/MS 344/1998 | Special-control prescription; covers psychotropics, narcotics, precursors |
+
+> ⚠️ **Tarja Preta** is the strictest tier. Medications in this category include benzodiazepines, opioids, barbiturates, and other substances under Brazil's controlled substance ordinance (Portaria 344/98). Misuse is a criminal offense under Brazilian law.
+
+---
+
+## Environment variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `MCPASSURE_CACHE_PATH` | `~/.cache/mcpassure-anvisa/cache.db` | SQLite cache file path |
+| `MCPASSURE_MAX_RETRIES` | `3` | Retry attempts on API failure |
+| `MCPASSURE_BASE_DELAY_MS` | `1000` | Base delay for exponential backoff (ms) |
+| `MCPASSURE_REQUEST_TIMEOUT_MS` | `10000` | HTTP request timeout (ms) |
+| `MCPASSURE_ANVISA_BASE_URL` | `https://consultas.anvisa.gov.br` | ANVISA API base URL |
+| `MCPASSURE_DEGRADED_THRESHOLD_DAYS` | `30` | Days after which cached data is flagged as degraded |
+| `MCPASSURE_STATUS_HEARTBEAT` | `false` | Enable heartbeat for status page |
+| `MCPASSURE_STATUS_PAGE_URL` | `https://status.mcpassure.com.br/api/v1/heartbeat/anvisa-bulario` | Heartbeat endpoint URL |
+
+---
+
+## Requirements
+
+- **Node.js >= 22.0.0**
+- **Playwright Chromium** (~150MB) — installed automatically by `postinstall`. Required because the ANVISA API is behind Cloudflare since 2026, blocking Node's native fetch.
+- **+150-250MB RAM** at runtime (Chromium in background). First call has ~2-3s overhead (Chromium boot + warm-up). Subsequent calls: ~100-300ms.
+
+If the Chromium postinstall fails (firewall, corporate policy, etc.), install manually:
+
+```bash
+npx playwright install chromium
+```
+
+---
+
+## Development
+
+```bash
+nvm use            # uses Node 22 as per .nvmrc
+npm install        # installs deps and downloads Playwright Chromium
+
+# Run in dev mode (stdio)
+npm run dev
+
+# Validate
+npm run typecheck
+npm run lint
+npm run test
+npm run test:integration:offline
+npm run canary
+```
+
+## Architecture
+
+- **Local SQLite** (`better-sqlite3`) as primary cache with 24h TTL
+- **Source pattern** with cascading sources: `anvisa-api` → `anvisa-dados-abertos` (v1.1+) → `anvisa-portal` (v1.2+)
+- **Repository pattern** decoupling domain from sources
+- **HTTP transport via Playwright** — real headless Chromium with clean UA and webdriver masking. Lazy-initialized browser singleton, page reused between requests. Required to bypass ANVISA's Cloudflare barrier.
+- **Optional status page hook** via `MCPASSURE_STATUS_HEARTBEAT`
+- **Daily canary** validates source accessibility and data patterns
+
+---
+
+## ⚠️ Medical disclaimer
+
+This MCP server is a **pharmaceutical reference tool** based on public ANVISA data. **It does not replace evaluation, diagnosis, or prescription by a licensed healthcare professional.** Drug information should always be used under professional supervision.
+
+Data comes from the ANVISA Electronic Drug Information Database (`consultas.anvisa.gov.br`), an official public source. This server does not store personal data and never processes PHI/PII.
+
+---
+
+## Dependencies
+
+This release uses current versions (audited 2026-05-13). For history or exceptions, see `DEPS.md`.
+
+Automated audit runs every Monday at 09:00 UTC (`deps-audit` workflow).
+
+## License
+
+MIT — see [LICENSE](LICENSE)
+
+Maintained by [MCPAssure Brasil](https://github.com/mcpassure). See [CONTRIBUTING.md](CONTRIBUTING.md), [SECURITY.md](SECURITY.md), and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
+
+---
+
+Part of the [MCPAssure](https://github.com/mcpassure) catalog — curated MCP examples for Brazilian healthcare.

package/README.md

@@ -1,5 +1,192 @@
-# @mcpassure/mcp-anvisa-bulario
-
-Reserved namespace. MCP server for ANVISA Bulario Eletronico, coming soon as part of the MCPAssure catalog.
-
-See https://mcpassure.com.br
+**🇧🇷 Português (BR) · [🇺🇸 English](./README.en.md)**
+
+---
+
+# @mcpassure/mcp-anvisa-bulario
+
+**Catálogo MCPAssure — Onda 1** — MCP server para consulta ao Bulário Eletrônico da ANVISA.
+
+Permite que agentes de IA (Claude, GPT, Copilot) consultem bulas, princípios ativos, classes terapêuticas e demais metadados de medicamentos registrados no Brasil com resposta estruturada e cache eficiente.
+
+[![CI](https://github.com/mcpassure/mcp-anvisa-bulario/actions/workflows/ci.yml/badge.svg)](https://github.com/mcpassure/mcp-anvisa-bulario/actions)
+[![npm](https://img.shields.io/npm/v/@mcpassure/mcp-anvisa-bulario)](https://www.npmjs.com/package/@mcpassure/mcp-anvisa-bulario)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+---
+
+## Instalação rápida
+
+```bash
+npx -y @mcpassure/mcp-anvisa-bulario
+```
+
+Na primeira instalação, o `postinstall` baixa o Chromium do Playwright
+(~150MB). Isso é requerido pelo transport HTTP (ver [Requisitos](#requisitos)).
+
+### Claude Desktop
+
+Adicione ao `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "anvisa-bulario": {
+      "command": "npx",
+      "args": ["-y", "@mcpassure/mcp-anvisa-bulario"]
+    }
+  }
+}
+```
+
+### VS Code / Claude Code
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "anvisa-bulario": {
+        "command": "npx",
+        "args": ["-y", "@mcpassure/mcp-anvisa-bulario"]
+      }
+    }
+  }
+}
+```
+
+---
+
+## Tools disponíveis
+
+| Tool | Descrição |
+|---|---|
+| `buscar_por_nome` | Busca por nome comercial do medicamento |
+| `buscar_por_principio_ativo` | Busca por DCB/DCI (princípio ativo) |
+| `buscar_por_classe_terapeutica` | Busca por classe terapêutica |
+| `filtrar_por_tarja` | Lista medicamentos por tipo de tarja (LIVRE, VERMELHA, PRETA) |
+| `consultar_bula` | Retorna dados completos + links da bula (PDF) |
+| `listar_apresentacoes` | Lista apresentações/embalagens de um medicamento |
+
+---
+
+## Prompts disponíveis
+
+| Prompt | Descrição |
+|---|---|
+| `verificar_medicamento_completo` | Consolida nome, princípio ativo, classe, tarja, apresentações e (opcional) bula para um termo de busca |
+| `comparar_tarjas_por_classe` | Agrupa medicamentos de uma classe terapêutica por tarja regulatória |
+| `analisar_apresentacoes` | Agrupa apresentações de um medicamento por concentração, forma farmacêutica ou fabricante |
+
+---
+
+## Resources disponíveis
+
+| URI | Tipo | Descrição |
+|---|---|---|
+| `bulario://tarjas` | `application/json` | Taxonomia regulatória de tarjas (RDC 357/2020, Portaria 344/98) |
+| `bulario://classes_terapeuticas` | `application/json` | Lista das principais classes terapêuticas indexadas |
+| `bulario://scope` | `text/markdown` | Escopo do MCP (PT/EN), o que faz/não faz, disclaimer regulatório |
+
+---
+
+## Demo
+
+![Demo](./.github/assets/demo.gif)
+
+Para rodar localmente:
+
+```bash
+npm run demo
+```
+
+---
+
+## Variáveis de ambiente
+
+| Variável | Padrão | Descrição |
+|---|---|---|
+| `MCPASSURE_CACHE_PATH` | `~/.cache/mcpassure-anvisa/cache.db` | Caminho do banco SQLite de cache |
+| `MCPASSURE_MAX_RETRIES` | `3` | Tentativas em caso de falha da API |
+| `MCPASSURE_BASE_DELAY_MS` | `1000` | Delay base para backoff exponencial (ms) |
+| `MCPASSURE_REQUEST_TIMEOUT_MS` | `10000` | Timeout de requisição HTTP (ms) |
+| `MCPASSURE_ANVISA_BASE_URL` | `https://consultas.anvisa.gov.br` | Base URL da API ANVISA |
+| `MCPASSURE_DEGRADED_THRESHOLD_DAYS` | `30` | Dias após os quais dados são considerados degradados |
+| `MCPASSURE_STATUS_HEARTBEAT` | `false` | Habilita heartbeat para status page |
+| `MCPASSURE_STATUS_PAGE_URL` | `https://status.mcpassure.com.br/api/v1/heartbeat/anvisa-bulario` | URL do heartbeat |
+
+---
+
+## Requisitos
+
+- **Node.js >= 22.0.0**
+- **Chromium do Playwright** (~150MB) — instalado automaticamente pelo
+  `postinstall`. Requerido porque a API ANVISA está atrás de Cloudflare desde
+  2026, bloqueando fetch nativo do Node. Ver
+  [`DIAGNOSTICO_ANVISA_CLOUDFLARE_2026-05-13.md`](DIAGNOSTICO_ANVISA_CLOUDFLARE_2026-05-13.md)
+  para detalhes técnicos.
+- **+150-250MB de RAM** em runtime (Chromium em background quando o MCP
+  estiver ativo). Primeira chamada tem ~2-3s de overhead (boot do Chromium
+  + warm-up). Chamadas subsequentes: ~100-300ms.
+
+Se o postinstall do Chromium falhar (firewall, política corporativa, etc.),
+rode manualmente:
+
+```bash
+npx playwright install chromium
+```
+
+---
+
+## Desenvolvimento
+
+```bash
+nvm use            # usa Node 22 conforme .nvmrc
+npm install        # instala deps e baixa Chromium do Playwright
+
+# Rodar em modo dev (stdio)
+npm run dev
+
+# Validar
+npm run typecheck
+npm run lint
+npm run test
+npm run test:integration:offline
+npm run canary
+```
+
+## Arquitetura
+
+- **SQLite local** (`better-sqlite3`) como cache primário com TTL 24h
+- **Source pattern** com cascata de fontes: `anvisa-api` → `anvisa-dados-abertos` (v1.1+) → `anvisa-portal` (v1.2+)
+- **Repository pattern** desacoplando domínio das fontes
+- **HTTP transport via Playwright** — Chromium real (headless) com UA limpo
+  e mascaramento de webdriver. Browser singleton lazy-initialized, page
+  reutilizada entre requests. Necessário para contornar a barreira Cloudflare
+  da ANVISA (ver diagnóstico).
+- **Status page hook** opcional via `MCPASSURE_STATUS_HEARTBEAT`
+- **Canário diário** valida acessibilidade e padrões da fonte oficial
+
+---
+
+## ⚠️ Disclaimer médico
+
+Este servidor MCP é uma **fonte de consulta farmacêutica** baseada em dados públicos da ANVISA. **Não substitui avaliação, diagnóstico ou prescrição por profissional de saúde habilitado.** Informações sobre medicamentos devem ser utilizadas com acompanhamento profissional.
+
+Os dados são provenientes do Bulário Eletrônico da ANVISA (`consultas.anvisa.gov.br`), que é fonte pública oficial. Este servidor não armazena dados pessoais e não processa PHI/PII em nenhum momento.
+
+---
+
+## Dependências
+
+Esta versão usa versões correntes (auditadas em 2026-05-13). Para histórico ou exceções, ver `DEPS.md`.
+
+Auditoria automática roda toda segunda às 09:00 UTC (`deps-audit` workflow).
+
+## Licença
+
+MIT — veja [LICENSE](LICENSE)
+
+Mantido pela [MCPAssure Brasil](https://github.com/mcpassure). Consulte [CONTRIBUTING.md](CONTRIBUTING.md), [SECURITY.md](SECURITY.md) e [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
+
+---
+
+Parte do catálogo [MCPAssure](https://github.com/mcpassure) — exemplos de curadoria de MCPs para saúde brasileira.

package/dist/cache/sqlite-cache.d.ts

@@ -0,0 +1,13 @@
+import type { CacheStore } from "./types.js";
+export declare class SqliteCache implements CacheStore {
+    private readonly db;
+    constructor(dbPath: string);
+    get<T>(key: string): {
+        value: T;
+        data_da_base: string;
+    } | null;
+    set<T>(key: string, value: T, ttlSeconds: number, data_da_base?: string): void;
+    invalidate(key: string): void;
+    close(): void;
+}
+//# sourceMappingURL=sqlite-cache.d.ts.map

package/dist/cache/sqlite-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-cache.d.ts","sourceRoot":"","sources":["../../src/cache/sqlite-cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,qBAAa,WAAY,YAAW,UAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;gBAE3B,MAAM,EAAE,MAAM;IA0B1B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAmB9D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IAU9E,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK7B,KAAK,IAAI,IAAI;CAGd"}

package/dist/cache/sqlite-cache.js

@@ -0,0 +1,58 @@
+import fs from "node:fs";
+import path from "node:path";
+import Database from "better-sqlite3";
+export class SqliteCache {
+    db;
+    constructor(dbPath) {
+        const dir = path.dirname(dbPath);
+        fs.mkdirSync(dir, { recursive: true });
+        this.db = new Database(dbPath);
+        this.db.exec(`
+      PRAGMA journal_mode=WAL;
+      CREATE TABLE IF NOT EXISTS cache (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL,
+        expires_at INTEGER NOT NULL,
+        data_da_base TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
+      );
+    `);
+        // Migration: add data_da_base column to existing databases that don't have it
+        try {
+            this.db.exec(`ALTER TABLE cache ADD COLUMN data_da_base TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))`);
+        }
+        catch {
+            // Column already exists — expected on fresh databases or after first migration
+        }
+    }
+    get(key) {
+        const now = Math.floor(Date.now() / 1000);
+        const stmt = this.db.prepare("SELECT value, expires_at, data_da_base FROM cache WHERE key = ? AND expires_at > ?");
+        const row = stmt.get(key, now);
+        if (!row)
+            return null;
+        try {
+            return {
+                value: JSON.parse(row.value),
+                data_da_base: row.data_da_base,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    set(key, value, ttlSeconds, data_da_base) {
+        const expiresAt = Math.floor(Date.now() / 1000) + ttlSeconds;
+        const serialized = JSON.stringify(value);
+        const dataBase = data_da_base ?? new Date().toISOString();
+        const stmt = this.db.prepare("INSERT OR REPLACE INTO cache (key, value, expires_at, data_da_base) VALUES (?, ?, ?, ?)");
+        stmt.run(key, serialized, expiresAt, dataBase);
+    }
+    invalidate(key) {
+        const stmt = this.db.prepare("DELETE FROM cache WHERE key = ?");
+        stmt.run(key);
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=sqlite-cache.js.map

package/dist/cache/sqlite-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-cache.js","sourceRoot":"","sources":["../../src/cache/sqlite-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAKtC,MAAM,OAAO,WAAW;IACL,EAAE,CAAoB;IAEvC,YAAY,MAAc;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvC,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAE/B,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;KAQZ,CAAC,CAAC;QAEH,8EAA8E;QAC9E,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,IAAI,CACV,yGAAyG,CAC1G,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,+EAA+E;QACjF,CAAC;IACH,CAAC;IAED,GAAG,CAAI,GAAW;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,oFAAoF,CACrF,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAA0B,CAAC;QAExD,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAEtB,IAAI,CAAC;YACH,OAAO;gBACL,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAM;gBACjC,YAAY,EAAE,GAAG,CAAC,YAAY;aAC/B,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,UAAkB,EAAE,YAAqB;QACrE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,UAAU,CAAC;QAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,YAAY,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,yFAAyF,CAC1F,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC;QAChE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/cache/types.d.ts

@@ -0,0 +1,17 @@
+export interface CacheStore {
+    get<T>(key: string): {
+        value: T;
+        data_da_base: string;
+    } | null;
+    set<T>(key: string, value: T, ttlSeconds: number, data_da_base?: string): void;
+    invalidate(key: string): void;
+    close(): void;
+}
+export declare const DEFAULT_TTLS: {
+    readonly searchResults: 3600;
+    readonly medicamentoDetalhes: 86400;
+    readonly categorias: 604800;
+    readonly bulaLink: 86400;
+};
+export type TtlConfig = typeof DEFAULT_TTLS;
+//# sourceMappingURL=types.d.ts.map

package/dist/cache/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/E,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,YAAY,CAAC"}

package/dist/cache/types.js

@@ -0,0 +1,7 @@
+export const DEFAULT_TTLS = {
+    searchResults: 3_600,
+    medicamentoDetalhes: 86_400,
+    categorias: 604_800,
+    bulaLink: 86_400,
+};
+//# sourceMappingURL=types.js.map

package/dist/cache/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,aAAa,EAAE,KAAK;IACpB,mBAAmB,EAAE,MAAM;IAC3B,UAAU,EAAE,OAAO;IACnB,QAAQ,EAAE,MAAM;CACR,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+export type Config = {
+    cachePath: string;
+    maxRetries: number;
+    baseDelayMs: number;
+    requestTimeoutMs: number;
+    anvisaBaseUrl: string;
+    degradedThresholdDays: number;
+    statusPageEnabled: boolean;
+    statusPageUrl: string;
+};
+export declare function loadConfig(): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,MAAM,GAAG;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAgB,UAAU,IAAI,MAAM,CAkBnC"}

package/dist/config.js

@@ -0,0 +1,17 @@
+import os from "node:os";
+import path from "node:path";
+export function loadConfig() {
+    return {
+        cachePath: process.env.MCPASSURE_CACHE_PATH ??
+            path.join(os.homedir(), ".cache", "mcpassure-anvisa", "cache.db"),
+        maxRetries: Number.parseInt(process.env.MCPASSURE_MAX_RETRIES ?? "3", 10),
+        baseDelayMs: Number.parseInt(process.env.MCPASSURE_BASE_DELAY_MS ?? "1000", 10),
+        requestTimeoutMs: Number.parseInt(process.env.MCPASSURE_REQUEST_TIMEOUT_MS ?? "10000", 10),
+        anvisaBaseUrl: process.env.MCPASSURE_ANVISA_BASE_URL ?? "https://consultas.anvisa.gov.br",
+        degradedThresholdDays: Number.parseInt(process.env.MCPASSURE_DEGRADED_THRESHOLD_DAYS ?? "30", 10),
+        statusPageEnabled: process.env.MCPASSURE_STATUS_HEARTBEAT === "true",
+        statusPageUrl: process.env.MCPASSURE_STATUS_PAGE_URL ??
+            "https://status.mcpassure.com.br/api/v1/heartbeat/anvisa-bulario",
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAa7B,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,SAAS,EACP,OAAO,CAAC,GAAG,CAAC,oBAAoB;YAChC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE,UAAU,CAAC;QACnE,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,GAAG,EAAE,EAAE,CAAC;QACzE,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,MAAM,EAAE,EAAE,CAAC;QAC/E,gBAAgB,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,OAAO,EAAE,EAAE,CAAC;QAC1F,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,iCAAiC;QACzF,qBAAqB,EAAE,MAAM,CAAC,QAAQ,CACpC,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,IAAI,EACrD,EAAE,CACH;QACD,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,MAAM;QACpE,aAAa,EACX,OAAO,CAAC,GAAG,CAAC,yBAAyB;YACrC,iEAAiE;KACpE,CAAC;AACJ,CAAC"}

package/dist/domain/repository.d.ts

@@ -0,0 +1,47 @@
+import type { CacheStore } from "../cache/types.js";
+import type { Apresentacao, BulaLink, BularioSource, MedicamentoDetalhes, MedicamentoResumo, SearchByClasseTerapeuticaParams, SearchByNameParams, SearchByPrincipalAtivoParams, SearchByTarjaParams } from "../sources/types.js";
+export type Meta = {
+    data_da_base: string;
+    fonte: string;
+    defasagem_dias: number;
+    modo: "cache_local" | "online";
+    status?: "ok" | "stale";
+};
+export type ResponseWithMeta<T> = {
+    data: T;
+    _meta: Meta;
+};
+export declare class AllSourcesFailedError extends Error {
+    readonly failures: Array<{
+        source: string;
+        error: Error;
+    }>;
+    constructor(failures: Array<{
+        source: string;
+        error: Error;
+    }>);
+}
+export interface IBularioRepository {
+    searchByName(params: SearchByNameParams): Promise<ResponseWithMeta<MedicamentoResumo[]>>;
+    searchByPrincipalAtivo(params: SearchByPrincipalAtivoParams): Promise<ResponseWithMeta<MedicamentoResumo[]>>;
+    searchByClasseTerapeutica(params: SearchByClasseTerapeuticaParams): Promise<ResponseWithMeta<MedicamentoResumo[]>>;
+    searchByTarja(params: SearchByTarjaParams): Promise<ResponseWithMeta<MedicamentoResumo[]>>;
+    getDetalhes(numProcesso: string): Promise<ResponseWithMeta<MedicamentoDetalhes>>;
+    getApresentacoes(numProcesso: string): Promise<ResponseWithMeta<Apresentacao[]>>;
+    getBulaLink(idBulaProtegido: string): Promise<ResponseWithMeta<BulaLink>>;
+}
+export declare class BularioRepository implements IBularioRepository {
+    private readonly cache;
+    private readonly sources;
+    private readonly degradedThresholdDays;
+    constructor(cache: CacheStore, sources: BularioSource[], degradedThresholdDays?: number);
+    searchByName(params: SearchByNameParams): Promise<ResponseWithMeta<MedicamentoResumo[]>>;
+    searchByPrincipalAtivo(params: SearchByPrincipalAtivoParams): Promise<ResponseWithMeta<MedicamentoResumo[]>>;
+    searchByClasseTerapeutica(params: SearchByClasseTerapeuticaParams): Promise<ResponseWithMeta<MedicamentoResumo[]>>;
+    searchByTarja(params: SearchByTarjaParams): Promise<ResponseWithMeta<MedicamentoResumo[]>>;
+    getDetalhes(numProcesso: string): Promise<ResponseWithMeta<MedicamentoDetalhes>>;
+    getApresentacoes(numProcesso: string): Promise<ResponseWithMeta<Apresentacao[]>>;
+    getBulaLink(idBulaProtegido: string): Promise<ResponseWithMeta<BulaLink>>;
+    private _withCache;
+}
+//# sourceMappingURL=repository.d.ts.map

package/dist/domain/repository.d.ts.map

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