france-data-mcp 0.7.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cyril Turkieh
+
+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,100 @@
+# france-data-mcp
+
+> A TypeScript MCP server that **cross-references and reconciles** 6 French public registries (INSEE SIRENE, FINESS DREES, RPPS / ANS Health Directory, Ameli Health Directory, IGN, DINUM). Detects closed SIRETs not yet propagated by DREES, distinguishes site vs group, exposes data freshness per source.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![CI](https://github.com/cturkieh/france-data-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/cturkieh/france-data-mcp/actions)
+[![MCP](https://img.shields.io/badge/MCP-live-success)](https://france-data-mcp.vercel.app/mcp)
+[![npm](https://img.shields.io/npm/v/france-data-mcp.svg)](https://www.npmjs.com/package/france-data-mcp)
+
+🇬🇧 Short English overview. [Full documentation in French →](README.md)
+
+---
+
+## Install
+
+### Option 1 — Remote URL (claude.ai, Claude Code, Cursor)
+
+`https://france-data-mcp.vercel.app/mcp`
+
+| Client | Config |
+|---|---|
+| **claude.ai** | Settings → Connectors → Add custom connector → URL above |
+| **Claude Code** | `~/.claude.json` → `mcpServers` → `{ "type": "http", "url": "..." }` |
+| **Cursor** | `~/.cursor/mcp.json` → same configuration |
+
+### Option 2 — npm stdio wrapper (native Claude Desktop, other clients)
+
+```json
+{
+  "mcpServers": {
+    "france-data": {
+      "command": "npx",
+      "args": ["-y", "france-data-mcp"]
+    }
+  }
+}
+```
+
+The wrapper forwards stdio → remote HTTPS endpoint. No local DB to provision. Override possible: `FRANCE_DATA_MCP_URL=https://my-mirror.example/mcp`.
+
+Client-by-client setup + self-hosting: [docs/installation-claude.md](docs/installation-claude.md).
+
+---
+
+## What it does
+
+Brings together the most useful French government data sources under a uniform typed API and a single MCP server endpoint, with:
+
+- Typed API (zero `any`), uniform rate-limit handling (exponential retry, `retry-after` aware)
+- Hardened ingestion pipeline (SHA-256 short-circuit, atomic swap, post-swap canary)
+- Cross-source reconciliation FINESS ↔ RPPS ↔ SIRENE — detects closed SIRETs still listed active, M&A renamings not yet propagated, inconsistent company names across registries
+- Honest docs about what each source contains and its gotchas
+
+---
+
+## Tools (25)
+
+- **Territory (4)**: `autocomplete_commune`, `get_commune_by_code`, `geocode_adresse`, `reverse_geocode`
+- **Companies (3)**: `entreprises_in_radius`, `entreprise_by_siren` (+ INSEE SIRENE V3.11 fallback), `etablissement_by_siret`
+- **FINESS healthcare facilities (3)**: `etablissements_finess_in_radius`, `etablissements_finess_by_categorie`, `etablissement_by_finess`
+- **Ameli licensed practitioners (4)**: `professionnels_in_radius`, `professionnels_par_specialite_dept`, `lister_specialites_ameli`, `lister_types_ps_ameli`
+- **RPPS / ANS — all active practitioners (5)**: `professionnels_rpps_in_radius`, `professionnels_rpps_par_dept`, `rpps_dans_etablissement`, `rpps_search_by_name` (fuzzy trigram), `professionnel_by_rpps` (+ live FHIR ANS fallback)
+- **Multi-source cross-checks (6)**: `data_freshness`, `verifier_site_actif`, `compare_raison_sociale_finess_vs_rpps`, `historique_etablissement`, `reconcilier_finess_sirene`, `finess_sirene_coverage_in_radius`
+
+---
+
+## Use cases
+
+- Healthcare territorial analysis (supply mapping, access to care)
+- Market research and competitive intelligence
+- Local journalism with data
+- Civic tech applications
+- Any *"what's around this point?"* query on French open data
+
+---
+
+## Status
+
+✅ **v0.7.2 — in production.** MCP server live at `https://france-data-mcp.vercel.app/mcp`, exposing **25 tools**. ~95K FINESS facilities, ~462K Ameli practitioners, ~2.2M active RPPS practitioners. TypeScript strict, Biome clean, **580 tests passing**. Sentry error monitoring live. See [CHANGELOG](CHANGELOG.md) for the full history.
+
+### Roadmap
+
+- **v0.8** — Composite health tools (`panorama_sante_territoire`, density analytics), INSEE Melodi (commune-level macro series)
+- **v0.9+** — DOM-COM support, INSEE IRIS (infra-communal demographics)
+
+---
+
+## Public limits
+
+- **Rate limit**: 60 req/min per IP on `tools/call` (handshake methods stay free). Over the limit: JSON-RPC error `-32000` with `data.retryAfterSeconds`.
+- **Structured JSON logs** per request: `ts`, `method`, `tool`, `ip_hash` (SHA-256), `duration_ms`, `outcome`. No raw IPs, no tool args persisted (GDPR-friendly).
+- **Sentry error monitoring** on internal 500s (tags `mcp.method`, `mcp.tool`, `mcp.outcome`).
+
+For heavy use, throttle client-side or self-host.
+
+---
+
+## License
+
+MIT for the code. Each data source keeps its own license (mostly Etalab Open License). See [main README](README.md#licence) for attribution requirements.

package/README.md

@@ -0,0 +1,137 @@
+# france-data-mcp
+
+> MCP TypeScript qui **croise et réconcilie** 6 référentiels publics français (INSEE SIRENE, FINESS DREES, RPPS / Annuaire Santé ANS, Annuaire Santé Ameli, IGN, DINUM). Détecte les SIRET fermés invisibles côté DREES, distingue site vs groupe, expose la fraîcheur de chaque source.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![CI](https://github.com/cturkieh/france-data-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/cturkieh/france-data-mcp/actions)
+[![MCP](https://img.shields.io/badge/MCP-live-success)](https://france-data-mcp.vercel.app/mcp)
+[![npm](https://img.shields.io/npm/v/france-data-mcp.svg)](https://www.npmjs.com/package/france-data-mcp)
+
+🇫🇷 Documentation principale en français. [English version →](README.en.md)
+
+---
+
+## Installation
+
+### Option 1 — URL distante (claude.ai, Claude Code, Cursor)
+
+`https://france-data-mcp.vercel.app/mcp`
+
+| Client | Config |
+|---|---|
+| **claude.ai** | Settings → Connectors → Add custom connector → URL ci-dessus |
+| **Claude Code** | `~/.claude.json` → `mcpServers` → `{ "type": "http", "url": "..." }` |
+| **Cursor** | `~/.cursor/mcp.json` → même configuration |
+
+### Option 2 — Wrapper npm stdio (Claude Desktop natif, autres clients)
+
+```json
+{
+  "mcpServers": {
+    "france-data": {
+      "command": "npx",
+      "args": ["-y", "france-data-mcp"]
+    }
+  }
+}
+```
+
+Le wrapper forwarde stdio → endpoint HTTPS distant. Aucune DB locale à provisionner. Override possible : `FRANCE_DATA_MCP_URL=https://mon-miroir.example/mcp`.
+
+Détails par client + self-hosting : [docs/installation-claude.md](docs/installation-claude.md).
+
+---
+
+## Pourquoi ce projet
+
+Les APIs officielles (INSEE, FINESS DREES, RPPS ANS, Annuaire Ameli, IGN, DINUM) existent mais sont **éclatées, sous-documentées et pleines de pièges** : rate limits, formats CSV propriétaires, latence DREES de 1-2 mois, diffusion partielle INSEE, mappings inconsistants Ameli ↔ RPPS.
+
+`france-data-mcp` est **le premier MCP qui croise factuellement ces sources** pour répondre à des questions concrètes — cartographie d'offre de soins, étude de marché territoriale, journalisme local, civic-tech.
+
+---
+
+## Périmètre — 6 sources publiques croisées
+
+- 🗺️ **Territoire** : geo.api.gouv.fr (DINUM, communes), IGN Géoplateforme (géocodage)
+- 🏥 **Santé** : FINESS / DREES (~95 K établissements), Annuaire Santé Ameli (~462 K libéraux), RPPS / ANS (~2,2 M PS actifs)
+- 🏢 **Entreprises** : DINUM Recherche Entreprises + INSEE SIRENE V3.11
+
+**Cross-source** : réconciliation FINESS ↔ RPPS ↔ SIRENE pour détecter SIRET fermés, rebrandings, raisons sociales périmées.
+
+---
+
+## Outils MCP (25 tools)
+
+### 🗺️ Territoire (4)
+`autocomplete_commune` · `get_commune_by_code` · `geocode_adresse` · `reverse_geocode`
+
+### 🏢 Entreprises (3)
+`entreprises_in_radius` · `entreprise_by_siren` (+ fallback INSEE SIRENE V3.11) · `etablissement_by_siret`
+
+### 🏥 Établissements santé FINESS (3)
+`etablissements_finess_in_radius` · `etablissements_finess_by_categorie` · `etablissement_by_finess`
+
+> 24 familles couvrant ~92 % du volume. Source DREES rafraîchie bimestriellement.
+
+### 👨‍⚕️ Professionnels libéraux Ameli (4)
+`professionnels_in_radius` · `professionnels_par_specialite_dept` · `lister_specialites_ameli` · `lister_types_ps_ameli`
+
+> Libéraux **conventionnés uniquement** (~462 K).
+
+### 🩺 Tous les PS — RPPS / Annuaire Santé ANS (5)
+`professionnels_rpps_in_radius` · `professionnels_rpps_par_dept` · `rpps_dans_etablissement` · `rpps_search_by_name` (fuzzy) · `professionnel_by_rpps` (+ fallback FHIR ANS)
+
+> ~2,2 M PS actifs (libéraux + salariés privés + hospitaliers contractuels + agents publics). Par défaut : Civils uniquement.
+
+### 🔀 Croisement multi-source (6)
+Réconciliation FINESS ↔ RPPS ↔ SIRENE — faits bruts sans interprétation métier.
+
+`data_freshness` · `verifier_site_actif` · `compare_raison_sociale_finess_vs_rpps` · `historique_etablissement` · `reconcilier_finess_sirene` · `finess_sirene_coverage_in_radius`
+
+---
+
+## Garde-fous publics
+
+- **Rate limit** : 60 req/min par IP sur `tools/call` (les méthodes meta restent libres). Au-delà : erreur `-32000` avec `data.retryAfterSeconds`.
+- **Logs JSON structurés** par requête : `ts`, `method`, `tool`, `ip_hash` (SHA-256), `duration_ms`, `outcome`. Aucune IP en clair, aucun argument tool persisté (RGPD-friendly).
+- **Sentry error monitoring** sur les 500 internes (tags `mcp.method`, `mcp.tool`, `mcp.outcome`).
+
+Usage intensif : throttler côté client ou self-héberger.
+
+---
+
+## État du projet
+
+✅ **V0.7.2 — en production.** 25 tools, ~95 K FINESS, ~462 K Ameli, ~2,2 M RPPS actifs. **580 tests verts**, TypeScript strict, Biome clean. Crons GitHub Actions actifs (FINESS bimensuel, Ameli hebdo, RPPS mensuel). Sentry monitoring live. Voir [CHANGELOG](CHANGELOG.md) pour l'historique.
+
+### Roadmap
+
+- [ ] **V0.8** — Tools composites santé (`panorama_sante_territoire`, densités), INSEE Melodi (séries macro communales)
+- [ ] **V0.9+** — Support DOM-COM, INSEE IRIS (démographie infra-communale)
+
+---
+
+## Contribuer
+
+Ouvrir une issue pour discuter avant d'envoyer une PR.
+
+---
+
+## Licence
+
+MIT — voir [LICENSE](LICENSE). Les **données** restent sous leurs licences respectives :
+
+| Source | Licence | Mention obligatoire |
+|---|---|---|
+| FINESS | Licence Ouverte (Etalab) | « Source : FINESS, ANS/DREES » |
+| Annuaire Santé Ameli | Art. L.1461-2 CSP | « Source : Annuaire santé Ameli, Assurance Maladie » |
+| DINUM Recherche Entreprises | Licence Ouverte | « Source : Annuaire des Entreprises, DINUM » |
+| INSEE | Licence Ouverte | « Source : Insee » |
+| IGN Géoplateforme | Licence Ouverte | « © IGN/Géoplateforme » |
+| geo.api.gouv.fr | Licence Ouverte | « Source : geo.api.gouv.fr (Etalab) » |
+
+---
+
+## Remerciements
+
+DINUM, Etalab, Atlasanté, ANS, INSEE, IGN pour la qualité de leurs APIs. data.gouv.fr pour l'animation civic-tech. Anthropic pour le protocole MCP.

package/dist/cli.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import { stdin, stdout } from 'process';
+import { createInterface } from 'readline';
+import { pathToFileURL } from 'url';
+
+// src/core/version.ts
+var VERSION = "0.7.2";
+
+// bin/cli.ts
+var DEFAULT_ENDPOINT = "https://france-data-mcp.vercel.app/mcp";
+var ENDPOINT = process.env.FRANCE_DATA_MCP_URL || DEFAULT_ENDPOINT;
+var USER_AGENT = `france-data-mcp-npm/${VERSION}`;
+var JSON_RPC_INTERNAL_ERROR = -32603;
+var rawTimeoutEnv = process.env.FRANCE_DATA_MCP_TIMEOUT_MS;
+var parsedTimeout = Number(rawTimeoutEnv);
+var isValidTimeout = Number.isFinite(parsedTimeout) && parsedTimeout > 0;
+var REQUEST_TIMEOUT_MS = isValidTimeout ? parsedTimeout : 6e4;
+if (rawTimeoutEnv !== void 0 && !isValidTimeout) {
+  console.error(
+    `[france-data-mcp-npm] FRANCE_DATA_MCP_TIMEOUT_MS="${rawTimeoutEnv}" invalide, fallback ${REQUEST_TIMEOUT_MS}ms`
+  );
+}
+function parseId(line) {
+  try {
+    const msg = JSON.parse(line);
+    if (msg && typeof msg === "object" && "id" in msg) {
+      const id = msg.id;
+      if (typeof id === "string" || typeof id === "number" || id === null) return id;
+    }
+  } catch {
+  }
+  return null;
+}
+var defaultWriteOut = (s) => {
+  stdout.write(s);
+};
+function emitJsonRpcError(id, code, message, writeOut) {
+  const payload = { jsonrpc: "2.0", id, error: { code, message } };
+  writeOut(`${JSON.stringify(payload)}
+`);
+}
+async function forwardLine(line, fetchFn = fetch, writeOut = defaultWriteOut) {
+  const trimmed = line.trim();
+  if (!trimmed) return;
+  const id = parseId(trimmed);
+  let response;
+  try {
+    response = await fetchFn(ENDPOINT, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        "user-agent": USER_AGENT,
+        accept: "application/json"
+      },
+      body: trimmed,
+      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+    });
+  } catch (err) {
+    const reason = sanitizeReason(err instanceof Error ? err.message : String(err));
+    console.error(`[france-data-mcp-npm] forward failed: ${reason}`);
+    emitJsonRpcError(
+      id,
+      JSON_RPC_INTERNAL_ERROR,
+      `Network error forwarding to ${SAFE_ENDPOINT}: ${reason}`,
+      writeOut
+    );
+    return;
+  }
+  let text;
+  try {
+    text = await response.text();
+  } catch (err) {
+    const reason = sanitizeReason(err instanceof Error ? err.message : String(err));
+    console.error(`[france-data-mcp-npm] body stream interrupted: ${reason}`);
+    emitJsonRpcError(
+      id,
+      JSON_RPC_INTERNAL_ERROR,
+      `Body stream interrupted from ${SAFE_ENDPOINT}: ${reason}`,
+      writeOut
+    );
+    return;
+  }
+  if (!response.ok) {
+    emitJsonRpcError(
+      id,
+      JSON_RPC_INTERNAL_ERROR,
+      `Upstream HTTP ${response.status} from ${SAFE_ENDPOINT}: ${sanitizeReason(text.slice(0, 200))}`,
+      writeOut
+    );
+    return;
+  }
+  if (text.length > 0) writeOut(`${text.replace(/\n+$/u, "")}
+`);
+}
+function safeEndpointForLog(endpoint) {
+  try {
+    const u = new URL(endpoint);
+    u.username = "";
+    u.password = "";
+    return u.toString();
+  } catch {
+    return endpoint;
+  }
+}
+var SAFE_ENDPOINT = safeEndpointForLog(ENDPOINT);
+function sanitizeReason(reason) {
+  return reason.replace(/(https?:\/\/)[^/\s@]+@/giu, "$1[redacted]@");
+}
+async function main() {
+  console.error(`[france-data-mcp-npm] v${VERSION} \u2192 ${SAFE_ENDPOINT}`);
+  const rl = createInterface({ input: stdin, crlfDelay: Number.POSITIVE_INFINITY });
+  for await (const line of rl) {
+    await forwardLine(line);
+  }
+}
+var isMain = typeof process.argv[1] === "string" && import.meta.url === pathToFileURL(process.argv[1]).href;
+if (isMain) {
+  main().catch((err) => {
+    const reason = err instanceof Error ? err.message : String(err);
+    console.error(`[france-data-mcp-npm] fatal: ${reason}`);
+    process.exit(1);
+  });
+}
+
+export { ENDPOINT, USER_AGENT, forwardLine, parseId, safeEndpointForLog };
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/version.ts","../bin/cli.ts"],"names":[],"mappings":"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","file":"cli.js","sourcesContent":["/**\n * Version courante du serveur MCP + wrapper npm. Source de vérité partagée :\n *  - `api/mcp.ts` → expose via `initialize.serverInfo.version` au client MCP\n *  - `bin/cli.ts` → expose dans le User-Agent HTTP + le banner stderr\n *\n * Synchronisée manuellement avec `package.json.version` à chaque release.\n * Une déclaration en TS pur évite la friction des import attributes JSON\n * (instables entre tsup/esbuild/@vercel/node).\n */\nexport const VERSION = \"0.7.2\";\n","#!/usr/bin/env node\n/**\n * france-data-mcp — wrapper npm.\n *\n * Forwarde le protocole MCP stdio (NDJSON sur stdin/stdout) vers l'endpoint\n * HTTP `france-data-mcp.vercel.app/mcp`. Permet aux clients MCP qui ne savent\n * pas appeler un endpoint HTTP distant (Claude Desktop natif, certains IDE)\n * d'utiliser le serveur via `npx france-data-mcp`.\n *\n * Architecture :\n *  - Lit stdin ligne par ligne (NDJSON, spec MCP stdio transport). Trim le\n *    whitespace périphérique avant forward — transformation volontaire et\n *    inoffensive (n'altère pas le JSON-RPC payload).\n *  - Pour chaque ligne non vide, POST vers `ENDPOINT` et écrit la réponse\n *    sur stdout (NDJSON).\n *  - En cas d'erreur réseau, HTTP >= 400, ou body stream interrompu, émet\n *    une réponse JSON-RPC error (-32603) pour ne JAMAIS faire hang le client.\n *\n * stdout doit rester pur JSON-RPC (NDJSON) — tout log interne va sur stderr\n * via `console.error` (jamais `stdout.write` pour autre chose qu'une réponse\n * JSON-RPC). Pas d'état stateful : le serveur HTTP est stateless lui aussi.\n */\n\nimport { stdin, stdout } from \"node:process\";\nimport { createInterface } from \"node:readline\";\nimport { pathToFileURL } from \"node:url\";\n\nimport { VERSION } from \"../src/core/version.js\";\n\nconst DEFAULT_ENDPOINT = \"https://france-data-mcp.vercel.app/mcp\";\nconst ENDPOINT = process.env.FRANCE_DATA_MCP_URL || DEFAULT_ENDPOINT;\nconst USER_AGENT = `france-data-mcp-npm/${VERSION}`;\nconst JSON_RPC_INTERNAL_ERROR = -32603;\n\nconst rawTimeoutEnv = process.env.FRANCE_DATA_MCP_TIMEOUT_MS;\nconst parsedTimeout = Number(rawTimeoutEnv);\nconst isValidTimeout = Number.isFinite(parsedTimeout) && parsedTimeout > 0;\nconst REQUEST_TIMEOUT_MS = isValidTimeout ? parsedTimeout : 60_000;\n// Signaler le fallback côté stderr (jamais stdout — réservé au JSON-RPC) pour\n// éviter un silent failure si l'utilisateur a tapé une valeur invalide.\nif (rawTimeoutEnv !== undefined && !isValidTimeout) {\n  console.error(\n    `[france-data-mcp-npm] FRANCE_DATA_MCP_TIMEOUT_MS=\"${rawTimeoutEnv}\" invalide, fallback ${REQUEST_TIMEOUT_MS}ms`,\n  );\n}\n\ntype JsonRpcId = string | number | null;\ntype JsonRpcMessage = { id?: JsonRpcId; method?: string };\n\n/**\n * Extrait l'id JSON-RPC d'une ligne (best-effort). Utilisé uniquement pour\n * construire une réponse error propre quand le forward réseau échoue.\n */\nfunction parseId(line: string): JsonRpcId {\n  try {\n    const msg = JSON.parse(line) as unknown;\n    if (msg && typeof msg === \"object\" && \"id\" in msg) {\n      const id = (msg as JsonRpcMessage).id;\n      if (typeof id === \"string\" || typeof id === \"number\" || id === null) return id;\n    }\n  } catch {\n    // Best-effort : si la ligne n'est pas du JSON valide, forwardLine émettra\n    // quand même une réponse JSON-RPC error sur stdout avec id=null. Le\n    // diagnostic texte va sur stderr via console.error.\n  }\n  return null;\n}\n\nconst defaultWriteOut = (s: string): void => {\n  stdout.write(s);\n};\n\n/**\n * Émet une réponse JSON-RPC error sur stdout. NDJSON appliqué de façon\n * uniforme (1 message = 1 ligne).\n */\nfunction emitJsonRpcError(\n  id: JsonRpcId,\n  code: number,\n  message: string,\n  writeOut: (s: string) => void,\n): void {\n  const payload = { jsonrpc: \"2.0\", id, error: { code, message } };\n  writeOut(`${JSON.stringify(payload)}\\n`);\n}\n\n/**\n * POST une ligne JSON-RPC vers l'endpoint HTTP et écrit la réponse sur stdout.\n * Catche toutes les erreurs (réseau, timeout, HTTP >=400, stream interrompu)\n * en émettant une réponse JSON-RPC error — le client MCP voit toujours une\n * réponse pour chaque request, jamais de hang.\n */\nexport async function forwardLine(\n  line: string,\n  fetchFn: typeof fetch = fetch,\n  writeOut: (s: string) => void = defaultWriteOut,\n): Promise<void> {\n  const trimmed = line.trim();\n  if (!trimmed) return;\n\n  // Parsing d'id fait UNE seule fois, réutilisé sur tous les chemins d'erreur.\n  const id = parseId(trimmed);\n\n  let response: Response;\n  try {\n    response = await fetchFn(ENDPOINT, {\n      method: \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        \"user-agent\": USER_AGENT,\n        accept: \"application/json\",\n      },\n      body: trimmed,\n      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),\n    });\n  } catch (err) {\n    const reason = sanitizeReason(err instanceof Error ? err.message : String(err));\n    console.error(`[france-data-mcp-npm] forward failed: ${reason}`);\n    emitJsonRpcError(\n      id,\n      JSON_RPC_INTERNAL_ERROR,\n      `Network error forwarding to ${SAFE_ENDPOINT}: ${reason}`,\n      writeOut,\n    );\n    return;\n  }\n\n  let text: string;\n  try {\n    text = await response.text();\n  } catch (err) {\n    // Stream interrompu après les headers (gateway timeout, réseau coupé) :\n    // sans ce catch, la promise rejette → main() crash → client hang sur l'id.\n    // console.error pour le diagnostic local, capture Sentry inapplicable\n    // côté wrapper client (par design : pas de telemetry).\n    const reason = sanitizeReason(err instanceof Error ? err.message : String(err));\n    console.error(`[france-data-mcp-npm] body stream interrupted: ${reason}`);\n    emitJsonRpcError(\n      id,\n      JSON_RPC_INTERNAL_ERROR,\n      `Body stream interrupted from ${SAFE_ENDPOINT}: ${reason}`,\n      writeOut,\n    );\n    return;\n  }\n\n  if (!response.ok) {\n    emitJsonRpcError(\n      id,\n      JSON_RPC_INTERNAL_ERROR,\n      `Upstream HTTP ${response.status} from ${SAFE_ENDPOINT}: ${sanitizeReason(text.slice(0, 200))}`,\n      writeOut,\n    );\n    return;\n  }\n\n  // L'endpoint Vercel renvoie un seul objet JSON-RPC (status 200) ou rien\n  // (204 pour les notifications). Passthrough verbatim — pas de re-sérialisation\n  // pour préserver la précision (ordre des clés, formats numériques).\n  if (text.length > 0) writeOut(`${text.replace(/\\n+$/u, \"\")}\\n`);\n}\n\n/**\n * Masque les credentials userinfo d'une URL connue (notre ENDPOINT) avant\n * inclusion dans un log stderr ou un message error JSON-RPC stdout.\n *\n * Surfaces couvertes :\n *  1. Banner stderr au démarrage (`SAFE_ENDPOINT`)\n *  2. Messages error JSON-RPC qui interpolent `${SAFE_ENDPOINT}`\n *  3. Messages error des exceptions `fetch` Node 22+ — leur `err.message`\n *     embarque l'URL fautive ENTIÈRE incluant userinfo (\"Request cannot be\n *     constructed from a URL that includes credentials: https://user:pass@…\").\n *     Cette surface est couverte par `sanitizeReason()` complémentaire — ne PAS\n *     se reposer sur cette fonction seule.\n */\nfunction safeEndpointForLog(endpoint: string): string {\n  try {\n    const u = new URL(endpoint);\n    u.username = \"\";\n    u.password = \"\";\n    return u.toString();\n  } catch {\n    return endpoint;\n  }\n}\n\n// Calculé une seule fois au module load — réutilisé dans tous les messages\n// (banner stderr + 3 chemins d'erreur stdout JSON-RPC).\nconst SAFE_ENDPOINT = safeEndpointForLog(ENDPOINT);\n\n/**\n * Strip toute URL `scheme://user:pass@host` d'une string libre. Le runtime\n * `fetch` Node 22+ throw un `TypeError` dont le message contient verbatim\n * l'URL fautive, incluant userinfo. Sans sanitization, le `reason` d'une\n * erreur réseau fuiterait les credentials côté stdout (JSON-RPC error) ET\n * stderr (diagnostic). Defense-in-depth obligatoire — la même URL pourrait\n * arriver via un message d'erreur de proxy, DNS, gateway, etc.\n */\nfunction sanitizeReason(reason: string): string {\n  return reason.replace(/(https?:\\/\\/)[^/\\s@]+@/giu, \"$1[redacted]@\");\n}\n\nasync function main(): Promise<void> {\n  console.error(`[france-data-mcp-npm] v${VERSION} → ${SAFE_ENDPOINT}`);\n  const rl = createInterface({ input: stdin, crlfDelay: Number.POSITIVE_INFINITY });\n  for await (const line of rl) {\n    await forwardLine(line);\n  }\n}\n\n// `import.meta.url === pathToFileURL(process.argv[1])` détecte qu'on est lancé\n// directement (vs importé par un test). Évite de boucler stdin pendant les tests.\nconst isMain =\n  typeof process.argv[1] === \"string\" && import.meta.url === pathToFileURL(process.argv[1]).href;\nif (isMain) {\n  main().catch((err: unknown) => {\n    const reason = err instanceof Error ? err.message : String(err);\n    console.error(`[france-data-mcp-npm] fatal: ${reason}`);\n    process.exit(1);\n  });\n}\n\nexport { ENDPOINT, USER_AGENT, parseId, safeEndpointForLog };\n"]}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { Commune, GeocodeOptions, GeocodeResult, SearchCommunesOptions, TERRITOIRE_VERSION, geocode, geocodeMany, getCommuneByCode, reverseGeocode, searchCommunes } from './territoire/index.js';
+export { AnsFhirPractitioner, ByCategorieInput, Dirigeant, Entreprise, Etablissement, EtablissementFiness, FINESS_CATEGORIES, FINESS_EHPAD, FINESS_FAMILY_CODES, FINESS_HOPITAUX, FINESS_LABOS, FINESS_MSP_CPTS, FINESS_PHARMACIES, FilterAnnuaireOptions, Finance, FinessCategorieCode, FinessFamille, FinessFamilleQuery, FinessQueryResult, FinessResult, InRadiusInput, LoadFinessOptions, NAF_EHPAD, NAF_LABOS, NAF_MEDECINE_VILLE, NAF_PHARMACIES, NAF_SANTE, NafCodeSante, ProfessionnelSante, RPPS_CGU_NOTICE, RPPS_MODE_EXERCICE, RppsDansEtablissementInput, RppsInRadiusInput, RppsLookupResult, RppsParSpecialiteDeptInput, RppsQueryResult, RppsResult, SANTE_VERSION, SearchEntreprisesOptions, SearchEntreprisesResult, SearchFinessOptions, StreamAnnuaireOptions, ensureAnnuaireAmeli, finessFamille, getAnsFhirApiKey, getAnsFhirBaseUrl, getEntrepriseBySiren, getFinessByCategorie, getFinessByNumFiness, getFinessInRadius, getInseeApiKey, getRppsById, getRppsDansEtablissement, getRppsInRadius, getRppsParSpecialiteDept, haversineDistance, libelleCategorieFiness, libelleNaf, loadFiness, loadProfessionnels, lookupPractitionerByRpps, lookupSirenViaInsee, searchEntreprises, searchEtablissementsFiness, streamProfessionnels } from './sante/index.js';
+export { C as Coordinates, R as RateLimitOptions } from './types-6cvLQmuz.js';