france-data-mcp 0.9.1 → 0.9.2

package/README.en.md

@@ -79,13 +79,13 @@ Brings together the most useful French government data sources under a uniform t
 
 ## Status
 
-✅ **v0.9.0 — in production.** 31 tools, ~95K FINESS, ~462K Ameli, ~2.2M active RPPS. 725 tests passing, TypeScript strict, Biome clean. Listed on the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=france-data-mcp), mcp.so and glama.ai. GitHub Actions crons (FINESS bi-monthly, Ameli weekly, RPPS monthly) and Sentry monitoring active.
+✅ **v0.9.2 — in production.** 31 tools, ~95K FINESS, ~462K Ameli, ~2.2M active RPPS. 781 tests passing, TypeScript strict, Biome clean. Listed on the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=france-data-mcp), mcp.so and glama.ai. GitHub Actions crons (FINESS bi-monthly, Ameli weekly, RPPS monthly) active. Observability: Sentry monitoring + Axiom log drain (30-day retention, fail-soft) + `/healthz` endpoint for external monitors (`ok`/`degraded` status based on critical dependencies).
 
 See [CHANGELOG](CHANGELOG.md) for the full history.
 
 ### Roadmap
 
-- **v0.9.1** — `count_finess_by_commune` RPC (commune-level facility density), multi-source matview auto-refresh
+- **v0.9.3** — `count_finess_by_commune` RPC (commune-level facility density), Axiom 4xx circuit breaker, `requireSiretId` / `requireRppsId` helpers
 - **v1.0+** — DOM-COM support, INSEE IRIS (infra-communal demographics)
 
 ---
@@ -93,8 +93,9 @@ See [CHANGELOG](CHANGELOG.md) for the full history.
 ## 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).
+- **Structured JSON logs** per request: `ts`, `method`, `tool`, `ip_hash` (salted SHA-256), `duration_ms`, `outcome`. No raw IPs, no tool args persisted.
 - **Sentry error monitoring** on internal 500s (tags `mcp.method`, `mcp.tool`, `mcp.outcome`).
+- **GDPR**: 30-day Axiom retention, salted IP hash, access/erasure rights. Full policy in [PRIVACY.md](./PRIVACY.md).
 
 For heavy use, throttle client-side or self-host.
 

package/README.md

@@ -112,13 +112,13 @@ Usage intensif : throttler côté client ou self-héberger.
 
 ## État du projet
 
-✅ **V0.9.0 — en production.** 31 tools, ~95 K FINESS, ~462 K Ameli, ~2,2 M RPPS actifs. 725 tests verts, TypeScript strict, Biome clean. Référencé sur le [registry MCP Anthropic officiel](https://registry.modelcontextprotocol.io/v0.1/servers?search=france-data-mcp), mcp.so et glama.ai. Crons GitHub Actions (FINESS bimensuel, Ameli hebdo, RPPS mensuel) et Sentry monitoring actifs.
+✅ **V0.9.2 — en production.** 31 tools, ~95 K FINESS, ~462 K Ameli, ~2,2 M RPPS actifs. 781 tests verts, TypeScript strict, Biome clean. Référencé sur le [registry MCP Anthropic officiel](https://registry.modelcontextprotocol.io/v0.1/servers?search=france-data-mcp), mcp.so et glama.ai. Crons GitHub Actions (FINESS bimensuel, Ameli hebdo, RPPS mensuel) actifs. Observabilité : Sentry monitoring + Axiom log drain (rétention 30 j, fail-soft) + endpoint `/healthz` pour monitors externes (status `ok`/`degraded` selon les dépendances critiques).
 
 Voir [CHANGELOG](CHANGELOG.md) pour l'historique détaillé.
 
 ### Roadmap
 
-- [ ] **V0.9.1** — RPC `count_finess_by_commune` (granularité commune côté établissements), auto-refresh matviews via cron multi-source
+- [ ] **V0.9.3** — RPC `count_finess_by_commune` (granularité commune côté établissements), circuit breaker 4xx Axiom, helpers `requireSiretId` / `requireRppsId`
 - [ ] **V1.0+** — Support DOM-COM (`code_insee CHAR(5)`), INSEE IRIS (démographie infra-communale)
 
 ---

package/dist/cli.js

@@ -5,7 +5,7 @@ import { createInterface } from 'readline';
 import { fileURLToPath } from 'url';
 
 // src/core/version.ts
-var VERSION = "0.9.1";
+var VERSION = "0.9.2";
 
 // bin/cli.ts
 var DEFAULT_ENDPOINT = "https://france-data-mcp.vercel.app/mcp";

package/dist/cli.js.map

@@ -1 +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.9.1\";\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 { realpathSync } from \"node:fs\";\nimport { stdin, stdout } from \"node:process\";\nimport { createInterface } from \"node:readline\";\nimport { fileURLToPath } 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/**\n * Détecte si le module est exécuté directement (vs importé par un test).\n * Évite de démarrer la boucle stdin pendant les tests.\n *\n * V0.7.6 fix : la garde précédente comparait `pathToFileURL(argv1).href` à\n * `import.meta.url`. Quand npm/npx exécutent le bin via un symlink dans\n * `node_modules/.bin/`, `process.argv[1]` reste le chemin du symlink mais\n * Node ESM résout `import.meta.url` vers la cible réelle. Les deux divergent\n * → `main()` jamais appelé → process exit silencieux. Régression silencieuse\n * en prod depuis V0.7.2 (1er wrapper npm). Fix : comparer les `realpath` des\n * deux côtés pour matcher quel que soit le routage symlink.\n */\nexport function isMainModule(importMetaUrl: string, argv1: string | undefined): boolean {\n  if (typeof argv1 !== \"string\") return false;\n  try {\n    return realpathSync(fileURLToPath(importMetaUrl)) === realpathSync(argv1);\n  } catch {\n    // Catch volontairement silencieux (PAS un silent failure métier) :\n    // c'est une décision booléenne sans effet utilisateur — on ne hand off\n    // aucune donnée, on ne masque aucune erreur API. Si realpath ou\n    // fileURLToPath throw (URL malformée, fichier inexistant — typique en\n    // contexte test/import abstrait), la bonne réponse est \"ne PAS démarrer\n    // main()\", pas \"logger une erreur\" qui polluerait stderr de tous les\n    // tests qui importent le module.\n    return false;\n  }\n}\n\nif (isMainModule(import.meta.url, process.argv[1])) {\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"]}
+{"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.9.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 { realpathSync } from \"node:fs\";\nimport { stdin, stdout } from \"node:process\";\nimport { createInterface } from \"node:readline\";\nimport { fileURLToPath } 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/**\n * Détecte si le module est exécuté directement (vs importé par un test).\n * Évite de démarrer la boucle stdin pendant les tests.\n *\n * V0.7.6 fix : la garde précédente comparait `pathToFileURL(argv1).href` à\n * `import.meta.url`. Quand npm/npx exécutent le bin via un symlink dans\n * `node_modules/.bin/`, `process.argv[1]` reste le chemin du symlink mais\n * Node ESM résout `import.meta.url` vers la cible réelle. Les deux divergent\n * → `main()` jamais appelé → process exit silencieux. Régression silencieuse\n * en prod depuis V0.7.2 (1er wrapper npm). Fix : comparer les `realpath` des\n * deux côtés pour matcher quel que soit le routage symlink.\n */\nexport function isMainModule(importMetaUrl: string, argv1: string | undefined): boolean {\n  if (typeof argv1 !== \"string\") return false;\n  try {\n    return realpathSync(fileURLToPath(importMetaUrl)) === realpathSync(argv1);\n  } catch {\n    // Catch volontairement silencieux (PAS un silent failure métier) :\n    // c'est une décision booléenne sans effet utilisateur — on ne hand off\n    // aucune donnée, on ne masque aucune erreur API. Si realpath ou\n    // fileURLToPath throw (URL malformée, fichier inexistant — typique en\n    // contexte test/import abstrait), la bonne réponse est \"ne PAS démarrer\n    // main()\", pas \"logger une erreur\" qui polluerait stderr de tous les\n    // tests qui importent le module.\n    return false;\n  }\n}\n\nif (isMainModule(import.meta.url, process.argv[1])) {\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.js

@@ -410,15 +410,20 @@ function parseLooseNumber(value) {
   return Number.isFinite(num) ? num : void 0;
 }
 
+// src/core/env.ts
+function readApiKeyEnv(name) {
+  const raw = process.env[name];
+  if (!raw) return null;
+  const cleaned = raw.trim().replace(/^["']|["']$/g, "");
+  return cleaned === "" ? null : cleaned;
+}
+
 // src/sante/insee-sirene.ts
 var SIRENE_BASE_URL = "https://api.insee.fr/api-sirene/3.11";
 var INSEE_AUTH_HEADER = "X-INSEE-Api-Key-Integration";
 var FETCH_TIMEOUT_MS = 6e4;
 function getInseeApiKey() {
-  const raw = process.env.INSEE_SIRENE_API_KEY;
-  if (!raw) return null;
-  const cleaned = raw.trim().replace(/^["']|["']$/g, "");
-  return cleaned === "" ? null : cleaned;
+  return readApiKeyEnv("INSEE_SIRENE_API_KEY");
 }
 async function lookupSirenViaInsee(siren) {
   const apiKey = getInseeApiKey();
@@ -1391,9 +1396,10 @@ function trimOrNull(s) {
   const trimmed = s.trim();
   return trimmed === "" ? null : trimmed;
 }
+var NUM_FINESS_PATTERN = /^\d{9}$/;
 function assertValidNumFiness(numFiness) {
   const trimmed = numFiness.trim();
-  if (!/^\d{9}$/.test(trimmed)) {
+  if (!NUM_FINESS_PATTERN.test(trimmed)) {
     throw new RangeError(
       `[france-data-mcp] num_finess invalide "${numFiness}" \u2014 attendu 9 chiffres (FINESS site).`
     );
@@ -1487,7 +1493,9 @@ function buildFinessQueryResult(rpc, data, limit, metadata) {
   };
 }
 function toFinessResult(row) {
-  const coords = row.geom ? { lat: row.geom.coordinates[1] ?? 0, lon: row.geom.coordinates[0] ?? 0 } : null;
+  const lat = row.geom?.coordinates[1];
+  const lon = row.geom?.coordinates[0];
+  const coords = typeof lat === "number" && typeof lon === "number" ? { lat, lon } : null;
   return {
     num_finess: row.num_finess,
     raison_sociale: row.raison_sociale,
@@ -1564,12 +1572,7 @@ async function getRppsParSpecialiteDept(input) {
 }
 async function getRppsDansEtablissement(input) {
   const limit = clampLimit(input.limit);
-  const numFiness = input.numFiness.trim();
-  if (!/^\d{9}$/.test(numFiness)) {
-    throw new RangeError(
-      `[france-data-mcp] num_finess invalide "${input.numFiness}" \u2014 attendu 9 chiffres (FINESS site).`
-    );
-  }
+  const numFiness = assertValidNumFiness(input.numFiness);
   const supabase = getUntypedAnonClient();
   const { data, error } = await supabase.rpc("rpps_dans_etablissement", {
     p_num_finess: numFiness,
@@ -1691,10 +1694,7 @@ var ANS_AUTH_HEADER = "ESANTE-API-KEY";
 var IDNPS_SYSTEM = "urn:oid:1.2.250.1.71.4.2.1";
 var FETCH_TIMEOUT_MS2 = 6e4;
 function getAnsFhirApiKey() {
-  const raw = process.env.ANS_FHIR_API_KEY;
-  if (!raw) return null;
-  const cleaned = raw.trim().replace(/^["']|["']$/g, "");
-  return cleaned === "" ? null : cleaned;
+  return readApiKeyEnv("ANS_FHIR_API_KEY");
 }
 function getAnsFhirBaseUrl() {
   const raw = process.env.ANS_FHIR_BASE_URL?.trim();