"""Optional rotating file logs under LOG_DIR (no secrets / no base64)."""

from __future__ import annotations

import logging
from logging.handlers import TimedRotatingFileHandler
from pathlib import Path


def configure_app_logging(*, log_dir: str, retention_days: int) -> None:
    """Attach a daily rotating file handler if not already present."""
    root = logging.getLogger()
    handler_name = "tj_timed_rotating"
    if any(getattr(h, "name", None) == handler_name for h in root.handlers):
        return

    path = Path(log_dir)
    path.mkdir(parents=True, exist_ok=True)
    log_file = path / "gateway.log"
    handler = TimedRotatingFileHandler(
        filename=str(log_file),
        when="midnight",
        interval=1,
        backupCount=max(1, int(retention_days)),
        encoding="utf-8",
    )
    handler.set_name(handler_name)
    handler.setFormatter(
        logging.Formatter("%(asctime)s %(levelname)s [%(name)s] %(message)s")
    )
    handler.setLevel(logging.INFO)
    root.addHandler(handler)
    if root.level > logging.INFO:
        root.setLevel(logging.INFO)
