"""Public surface of ``infrasynth.security``.

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.security import AuthorizationService, HybridPermission, CookieJWTAuthentication
"""

from __future__ import annotations

from importlib import import_module
from typing import Any

__all__ = [
    "ALTCHAService",
    "APIKeyAuthentication",
    "AuthorizationService",
    "CookieJWTAuthentication",
    "EmailOrUsernameBackend",
    "HybridPermission",
    "IsAuthenticatedAndPermitted",
    "LoginAttemptGuard",
    "PasswordPolicyValidator",
    "RecoveryCodeService",
    "SystemUser",
    "TOTPService",
    "get_recovery_code_service",
    "get_two_factor_service",
    "is_tenant_owner",
    "require_permission",
]

# public name -> module (relative to the ``infrasynth`` package) that defines it
_EXPORTS: dict[str, str] = {
    "ALTCHAService": "security.altcha.services",
    "APIKeyAuthentication": "security.auth.api_keys",
    "AuthorizationService": "security.services",
    "CookieJWTAuthentication": "security.auth.cookies",
    "EmailOrUsernameBackend": "security.auth.backends",
    "HybridPermission": "security.permissions",
    "IsAuthenticatedAndPermitted": "security.permissions",
    "LoginAttemptGuard": "security.throttling",
    "PasswordPolicyValidator": "security.password_validation",
    "RecoveryCodeService": "security.two_factor.services",
    "SystemUser": "security.auth.api_keys",
    "TOTPService": "security.two_factor.services",
    "get_recovery_code_service": "security.two_factor.services",
    "get_two_factor_service": "security.two_factor.services",
    "is_tenant_owner": "security.permissions",
    "require_permission": "security.permissions",
}


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()))