"""Small in-process event bus for ImageStudio services.""" from __future__ import annotations from collections import defaultdict, deque from dataclasses import dataclass, field from datetime import datetime, timezone from typing import Any, Callable, DefaultDict from uuid import uuid4 EventHandler = Callable[["Event"], None] @dataclass(frozen=True) class Event: event_type: str payload: dict[str, Any] = field(default_factory=dict) event_id: str = field(default_factory=lambda: f"evt_{uuid4().hex}") created_at: str = field(default_factory=lambda: datetime.now(timezone.utc).isoformat()) def to_dict(self) -> dict[str, Any]: return { "event_id": self.event_id, "event_type": self.event_type, "payload": self.payload, "created_at": self.created_at, } class EventBus: def __init__(self, *, history_limit: int = 200): self._handlers: DefaultDict[str, list[EventHandler]] = defaultdict(list) self._history: deque[Event] = deque(maxlen=max(int(history_limit), 1)) def subscribe(self, event_type: str, handler: EventHandler) -> None: normalized = _normalize_event_type(event_type) if handler not in self._handlers[normalized]: self._handlers[normalized].append(handler) def unsubscribe(self, event_type: str, handler: EventHandler) -> None: normalized = _normalize_event_type(event_type) self._handlers[normalized] = [item for item in self._handlers[normalized] if item is not handler] def publish(self, event_type: str, payload: dict[str, Any] | None = None) -> Event: event = Event(event_type=_normalize_event_type(event_type), payload=dict(payload or {})) self._history.append(event) for handler in [*self._handlers.get(event.event_type, []), *self._handlers.get("*", [])]: handler(event) return event def history(self, event_type: str | None = None) -> list[Event]: if event_type is None: return list(self._history) normalized = _normalize_event_type(event_type) return [event for event in self._history if event.event_type == normalized] def _normalize_event_type(event_type: str) -> str: normalized = str(event_type or "").strip() if not normalized: raise ValueError("event_type is required") return normalized