phase 4

detect/emit.py

@@ -0,0 +1,68 @@
+"""
+Event emission helpers for detection pipeline stages.
+
+Single place that knows how to build event payloads.
+Stages call these instead of constructing dicts or dataclasses directly.
+"""
+
+from __future__ import annotations
+
+import dataclasses
+from datetime import datetime, timezone
+
+from detect.events import push_detect_event
+from detect.models import PipelineStats
+
+
+def log(job_id: str | None, stage: str, level: str, msg: str) -> None:
+    """Emit a log event."""
+    if not job_id:
+        return
+    payload = {
+        "level": level,
+        "stage": stage,
+        "msg": msg,
+        "ts": datetime.now(timezone.utc).isoformat(),
+    }
+    push_detect_event(job_id, "log", payload)
+
+
+def stats(job_id: str | None, **kwargs) -> None:
+    """Emit a stats_update event. Pass only the fields that changed."""
+    if not job_id:
+        return
+    s = PipelineStats(**kwargs)
+    push_detect_event(job_id, "stats_update", dataclasses.asdict(s))
+
+
+def detection(
+    job_id: str | None,
+    brand: str,
+    confidence: float,
+    source: str,
+    timestamp: float,
+    duration: float = 0.0,
+    content_type: str = "",
+    frame_ref: int | None = None,
+) -> None:
+    """Emit a brand detection event."""
+    if not job_id:
+        return
+    payload = {
+        "brand": brand,
+        "confidence": confidence,
+        "source": source,
+        "timestamp": timestamp,
+        "duration": duration,
+        "content_type": content_type,
+        "frame_ref": frame_ref,
+    }
+    push_detect_event(job_id, "detection", payload)
+
+
+def job_complete(job_id: str | None, report: dict) -> None:
+    """Emit a job_complete event with the final report."""
+    if not job_id:
+        return
+    payload = {"job_id": job_id, "report": report}
+    push_detect_event(job_id, "job_complete", payload)