"""Public surface of ``infrasynth.audit``.

The exports are resolved lazily (PEP 562) so importing this package never
triggers Django model imports before the app registry is ready. Import from
here::

    from infrasynth.audit import ModelChangeLog, OptionalAuditableMixin
"""

from __future__ import annotations

from importlib import import_module
from typing import Any

__all__ = [
    "APIInteractionLog",
    "ModelChangeLog",
    "OptionalAuditableMixin",
    "SecurityEvent",
    "model_changed",
    "security_event_occurred",
]

# public name -> module (relative to the ``infrasynth`` package) that defines it
_EXPORTS: dict[str, str] = {
    "APIInteractionLog": "audit.models",
    "ModelChangeLog": "audit.models",
    "OptionalAuditableMixin": "audit.mixins",
    "SecurityEvent": "audit.models",
    "model_changed": "audit.signals",
    "security_event_occurred": "audit.signals",
}


def __getattr__(name: str) -> Any:
    module_path = _EXPORTS.get(name)
    if module_path is not None:
        return getattr(import_module(f"infrasynth.{module_path}"), name)
    # Let ``infrasynth.<app>.<submodule>`` resolve as usual.
    try:
        return import_module(f"{__name__}.{name}")
    except ModuleNotFoundError as exc:
        raise AttributeError(f"module {__name__!r} has no attribute {name!r}") from exc


def __dir__() -> list[str]:
    return sorted(set(__all__) | set(globals()))