from __future__ import annotations

import os
from typing import Any


def status() -> dict[str, Any]:
    return {
        "configured": bool(os.getenv("INSEE_API_KEY") or os.getenv("INSEE_BEARER_TOKEN")),
        "base_url": os.getenv("INSEE_API_BASE_URL", "https://api.insee.fr"),
        "note": "Connector prepared. Map the exact INSEE cube/dataset identifiers before enabling live calls.",
        "planned_indicators": [
            "population municipale",
            "population par age",
            "menages et familles",
            "densite",
            "revenus et fragilites sociales si disponibles",
        ],
    }


def placeholder_for_scope(scope_code: str) -> dict[str, Any]:
    return {
        "scope_code": scope_code,
        "source": "INSEE",
        "status": "not_live_yet",
        "message": "INSEE endpoints are documented in the connector but require dataset identifiers and subscription details.",
    }