france-data-mcp 0.7.8 → 0.8.1

package/README.md

@@ -103,12 +103,16 @@ Usage intensif : throttler côté client ou self-héberger.
 
 ## État du projet
 
-✅ **V0.7.7 — en production.** Référencé sur le [registry MCP Anthropic officiel](https://registry.modelcontextprotocol.io/v0.1/servers?search=france-data-mcp) (`io.github.cturkieh/france-data-mcp`), mcp.so et glama.ai. 25 tools avec annotations MCP + outputSchema (spec 2025-06-18, structuredContent émis), ~95 K FINESS, ~462 K Ameli, ~2,2 M RPPS actifs. **612 tests verts** (19 integration tests Supabase requièrent des creds locaux), TypeScript strict, Biome clean. Crons GitHub Actions actifs (FINESS bimensuel, Ameli hebdo, RPPS mensuel). Sentry monitoring live (filtre bot-noise actif). Voir [CHANGELOG](CHANGELOG.md) pour l'historique.
+✅ **V0.8.1 — en production.** Référencé sur le [registry MCP Anthropic officiel](https://registry.modelcontextprotocol.io/v0.1/servers?search=france-data-mcp) (`io.github.cturkieh/france-data-mcp`), mcp.so et glama.ai. **30 tools** avec annotations MCP + outputSchema (spec 2025-06-18, structuredContent émis), ~95 K FINESS, ~462 K Ameli, ~2,2 M RPPS actifs. **642 tests verts** (19 integration tests Supabase requièrent des creds locaux), TypeScript strict, Biome clean. Crons GitHub Actions actifs (FINESS bimensuel, Ameli hebdo, RPPS mensuel). Sentry monitoring live (filtre bot-noise actif). V0.8.1 hotfix : `MODE_EXERCICE_ACTIVITE_REGULIERE` corrigé en `["L","S","M"]` (les codes ANS sont alphabétiques en base, pas numériques) + index covering pour `lister_specialites_medicales`.
+
+V0.8 ajoute 5 tools croisant **INSEE Melodi** (population de référence) avec RPPS et FINESS : `population_par_commune`, `population_par_departement`, `densite_professionnels_sante` (méthodo DREES, ratio médecins/100k hab. + comparaison nationale), `densite_etablissements_sante` (labos / pharmacies / EHPAD / hôpitaux par famille FINESS), `lister_specialites_medicales` (découverte des codes savoir_faire RPPS pour le LLM).
+
+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)
+- [ ] **V0.8.1** — Densité commune (RPC `count_rpps_by_commune` via code postal), `panorama_sante_territoire` agrégateur, polish docs/installation-claude.md (drift count tools)
+- [ ] **V0.9+** — Support DOM-COM widening (`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.7.8";
+var VERSION = "0.8.1";
 
 // 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.7.8\";\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.8.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"]}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { Commune, GeocodeOptions, GeocodeResult, SearchCommunesOptions, TERRITOIRE_VERSION, geocode, geocodeMany, getCommuneByCode, reverseGeocode, searchCommunes } from './territoire/index.js';
+export { Commune, GeoLevel, GeocodeOptions, GeocodeResult, PopulationData, SearchCommunesOptions, TERRITOIRE_VERSION, geocode, geocodeMany, getCommuneByCode, getPopulationByCommune, getPopulationByDept, 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';

package/dist/index.js

@@ -253,6 +253,147 @@ function toGeocodeResult(feature) {
   };
 }
 
+// src/territoire/dept-codes.ts
+function isValidDept(dept) {
+  if (dept === "2A" || dept === "2B") return true;
+  if (/^\d{2}$/.test(dept)) return dept !== "20";
+  if (/^(97[1-8]|98[4-8])$/.test(dept)) return true;
+  return false;
+}
+function assertValidDept(dept) {
+  if (isValidDept(dept)) return;
+  throw new RangeError(`[france-data-mcp] departement must be a valid INSEE code, got "${dept}"`);
+}
+
+// src/territoire/insee-melodi.ts
+var MELODI_BASE_URL = "https://api.insee.fr/melodi";
+var POPULATION_DATASET = "DS_POPULATIONS_REFERENCE";
+var SOURCE_LABEL = "INSEE Melodi (DS_POPULATIONS_REFERENCE)";
+var COMMUNE_CODE_RE = /^[0-9][0-9AB][0-9]{3}$/u;
+var POPULATION_CACHE = /* @__PURE__ */ new Map();
+var CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
+function cacheGet(key) {
+  const entry = POPULATION_CACHE.get(key);
+  if (!entry) return void 0;
+  if (entry.expiry < Date.now()) {
+    POPULATION_CACHE.delete(key);
+    return void 0;
+  }
+  return entry.value;
+}
+function cacheSet(key, value) {
+  POPULATION_CACHE.set(key, { value, expiry: Date.now() + CACHE_TTL_MS });
+}
+function parseObservations(observations, codeInsee, geoLevel) {
+  if (observations.length === 0) return null;
+  let latestYear = 0;
+  for (const obs of observations) {
+    const year = Number.parseInt(obs.dimensions.TIME_PERIOD, 10);
+    if (Number.isFinite(year) && year > latestYear) latestYear = year;
+  }
+  if (latestYear === 0) {
+    throw new Error(
+      `[france-data-mcp] INSEE Melodi: ${observations.length} observations re\xE7ues pour ${geoLevel}=${codeInsee} mais aucune TIME_PERIOD parsable \u2014 r\xE9gression sch\xE9ma SDMX upstream ?`
+    );
+  }
+  const measures = /* @__PURE__ */ new Map();
+  let millesime = "unknown";
+  for (const obs of observations) {
+    if (Number.parseInt(obs.dimensions.TIME_PERIOD, 10) !== latestYear) continue;
+    measures.set(obs.dimensions.POPREF_MEASURE, obs.measures.OBS_VALUE_NIVEAU.value);
+    const geoMatch = obs.dimensions.GEO.match(/^(\d{4})-/u);
+    if (geoMatch?.[1]) millesime = geoMatch[1];
+  }
+  const pmun = measures.get("PMUN");
+  if (pmun === void 0) {
+    throw new Error(
+      `[france-data-mcp] INSEE Melodi: PMUN absent du payload pour ${geoLevel}=${codeInsee} (mesures re\xE7ues: ${[...measures.keys()].join(",")}) \u2014 payload incomplet`
+    );
+  }
+  return {
+    codeInsee,
+    geoLevel,
+    annee: latestYear,
+    populationMunicipale: pmun,
+    populationComptageApart: measures.get("PCAP") ?? 0,
+    populationTotale: measures.get("PTOT") ?? 0,
+    millesimeGeographique: millesime,
+    source: SOURCE_LABEL
+  };
+}
+async function fetchPopulation(geoFilter, codeInsee, geoLevel, signal) {
+  const cacheKey = `${geoLevel}:${codeInsee}`;
+  const cached = cacheGet(cacheKey);
+  if (cached) return cached;
+  const url = `${MELODI_BASE_URL}/data/${POPULATION_DATASET}?GEO=${encodeURIComponent(geoFilter)}`;
+  const data = await fetchJson(url, { signal });
+  const parsed = parseObservations(data.observations, codeInsee, geoLevel);
+  if (parsed) cacheSet(cacheKey, parsed);
+  return parsed;
+}
+async function getPopulationByCommune(codeInsee, options = {}) {
+  if (typeof codeInsee !== "string" || !COMMUNE_CODE_RE.test(codeInsee)) {
+    throw new RangeError(
+      `Code INSEE de commune invalide: "${codeInsee}" (attendu : 5 caract\xE8res, ex "75056" ou "2A004")`
+    );
+  }
+  try {
+    const data = await fetchPopulation(`COM-${codeInsee}`, codeInsee, "COM", options.signal);
+    if (!data) {
+      return lookupNotFound(
+        codeInsee,
+        `Commune ${codeInsee} introuvable dans INSEE Melodi (DS_POPULATIONS_REFERENCE). V\xE9rifier le code via autocomplete_commune \u2014 la commune a peut-\xEAtre fusionn\xE9 ou chang\xE9 de code.`
+      );
+    }
+    return lookupFound(data);
+  } catch (err) {
+    if (err instanceof HttpError && err.status === 400) {
+      console.warn(
+        `[france-data-mcp] INSEE Melodi 400 on commune ${codeInsee} \u2014 body: ${err.body ?? "<empty>"}`
+      );
+      return lookupNotFound(
+        codeInsee,
+        `Code INSEE ${codeInsee} rejet\xE9 par INSEE Melodi (${err.body ?? "format invalide"}).`
+      );
+    }
+    console.error(
+      `[france-data-mcp] INSEE Melodi failed for commune ${codeInsee}: ${err.message}`
+    );
+    throw err;
+  }
+}
+async function getPopulationByDept(codeDept, options = {}) {
+  if (typeof codeDept !== "string" || !isValidDept(codeDept)) {
+    throw new RangeError(
+      `Code INSEE de d\xE9partement invalide: "${codeDept}" (attendu : 01-95 m\xE9tropole, 2A/2B Corse, 971-978 DROM, 984-988 COM)`
+    );
+  }
+  try {
+    const data = await fetchPopulation(`DEP-${codeDept}`, codeDept, "DEP", options.signal);
+    if (!data) {
+      return lookupNotFound(
+        codeDept,
+        `D\xE9partement ${codeDept} introuvable dans INSEE Melodi (DS_POPULATIONS_REFERENCE).`
+      );
+    }
+    return lookupFound(data);
+  } catch (err) {
+    if (err instanceof HttpError && err.status === 400) {
+      console.warn(
+        `[france-data-mcp] INSEE Melodi 400 on dept ${codeDept} \u2014 body: ${err.body ?? "<empty>"}`
+      );
+      return lookupNotFound(
+        codeDept,
+        `Code INSEE ${codeDept} rejet\xE9 par INSEE Melodi (${err.body ?? "format invalide"}).`
+      );
+    }
+    console.error(
+      `[france-data-mcp] INSEE Melodi failed for dept ${codeDept}: ${err.message}`
+    );
+    throw err;
+  }
+}
+
 // src/territoire/index.ts
 var TERRITOIRE_VERSION = "0.1.0";
 
@@ -1371,18 +1512,6 @@ function toFinessResult(row) {
   };
 }
 
-// src/territoire/dept-codes.ts
-function isValidDept(dept) {
-  if (dept === "2A" || dept === "2B") return true;
-  if (/^\d{2}$/.test(dept)) return dept !== "20";
-  if (/^(97[1-8]|98[4-8])$/.test(dept)) return true;
-  return false;
-}
-function assertValidDept(dept) {
-  if (isValidDept(dept)) return;
-  throw new RangeError(`[france-data-mcp] departement must be a valid INSEE code, got "${dept}"`);
-}
-
 // src/sante/rpps-types.ts
 var RPPS_MODE_EXERCICE = {
   LIBERAL: "L",
@@ -1678,6 +1807,6 @@ function mapPractitioner(resource, expectedRpps) {
 // src/sante/index.ts
 var SANTE_VERSION = "0.5.1";
 
-export { FINESS_CATEGORIES, FINESS_EHPAD, FINESS_FAMILY_CODES, FINESS_HOPITAUX, FINESS_LABOS, FINESS_MSP_CPTS, FINESS_PHARMACIES, NAF_EHPAD, NAF_LABOS, NAF_MEDECINE_VILLE, NAF_PHARMACIES, NAF_SANTE, RPPS_CGU_NOTICE, RPPS_MODE_EXERCICE, SANTE_VERSION, TERRITOIRE_VERSION, ensureAnnuaireAmeli, finessFamille, geocode, geocodeMany, getAnsFhirApiKey, getAnsFhirBaseUrl, getCommuneByCode, getEntrepriseBySiren, getFinessByCategorie, getFinessByNumFiness, getFinessInRadius, getInseeApiKey, getRppsById, getRppsDansEtablissement, getRppsInRadius, getRppsParSpecialiteDept, haversineDistance, libelleCategorieFiness, libelleNaf, loadFiness, loadProfessionnels, lookupPractitionerByRpps, lookupSirenViaInsee, reverseGeocode, searchCommunes, searchEntreprises, searchEtablissementsFiness, streamProfessionnels };
+export { FINESS_CATEGORIES, FINESS_EHPAD, FINESS_FAMILY_CODES, FINESS_HOPITAUX, FINESS_LABOS, FINESS_MSP_CPTS, FINESS_PHARMACIES, NAF_EHPAD, NAF_LABOS, NAF_MEDECINE_VILLE, NAF_PHARMACIES, NAF_SANTE, RPPS_CGU_NOTICE, RPPS_MODE_EXERCICE, SANTE_VERSION, TERRITOIRE_VERSION, ensureAnnuaireAmeli, finessFamille, geocode, geocodeMany, getAnsFhirApiKey, getAnsFhirBaseUrl, getCommuneByCode, getEntrepriseBySiren, getFinessByCategorie, getFinessByNumFiness, getFinessInRadius, getInseeApiKey, getPopulationByCommune, getPopulationByDept, getRppsById, getRppsDansEtablissement, getRppsInRadius, getRppsParSpecialiteDept, haversineDistance, libelleCategorieFiness, libelleNaf, loadFiness, loadProfessionnels, lookupPractitionerByRpps, lookupSirenViaInsee, reverseGeocode, searchCommunes, searchEntreprises, searchEtablissementsFiness, streamProfessionnels };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map