"""Small shared type aliases & tiny helpers.

Put things here when they are used by multiple domain modules but don't
have a home of their own.
"""

from __future__ import annotations

from typing import TypeAlias, Any, Dict, Awaitable, Callable

JSONDict: TypeAlias = Dict[str, Any]
"""Any loosely-typed JSON object (metadata, unstructured payloads, …)."""

AsyncHandler: TypeAlias = Callable[..., Awaitable[Any]]
"""Generic async callable type alias."""