fix: register campass_access events with HA logbook

Events were being fired via hass.bus.async_fire() but weren't
showing up in the Logbook because they weren't registered with
the logbook component. Added logbook.py descriptor and logbook
dependency to manifest.json.

Author: evandcoleman

custom_components/campass/logbook.py

@@ -0,0 +1,42 @@
+"""Logbook support for CamPass."""
+from __future__ import annotations
+
+from homeassistant.components.logbook import LOGBOOK_ENTRY_MESSAGE, LOGBOOK_ENTRY_NAME
+from homeassistant.core import Event, HomeAssistant, callback
+
+EVENT_CAMPASS_ACCESS = "campass_access"
+
+MESSAGES = {
+    "auth_success": "authenticated to '{share}' share from {ip}",
+    "auth_failure": "failed authentication to '{share}' share from {ip}",
+    "camera_view": "viewed camera {camera_id} on '{share}' share from {ip}",
+}
+
+
+@callback
+def async_describe_events(hass: HomeAssistant, async_describe_event):
+    """Describe CamPass logbook events."""
+
+    @callback
+    def async_describe_campass_event(event: Event):
+        """Describe a CamPass access event."""
+        data = event.data
+        event_type = data.get("type", "unknown")
+        share = data.get("share", "unknown")
+        ip = data.get("ip", "unknown")
+        camera_id = data.get("camera_id", "")
+
+        template = MESSAGES.get(event_type, "performed '{type}' on share '{share}'")
+        message = template.format(
+            share=share,
+            ip=ip,
+            camera_id=camera_id,
+            type=event_type,
+        )
+
+        return {
+            LOGBOOK_ENTRY_NAME: "CamPass",
+            LOGBOOK_ENTRY_MESSAGE: message,
+        }
+
+    async_describe_event(EVENT_CAMPASS_ACCESS, async_describe_campass_event)

custom_components/campass/manifest.json

@@ -3,10 +3,10 @@
   "name": "CamPass",
   "codeowners": ["@evandcoleman"],
   "config_flow": true,
-  "dependencies": ["camera", "stream"],
+  "dependencies": ["camera", "logbook", "stream"],
   "documentation": "https://github.com/evandcoleman/campass",
   "integration_type": "service",
   "iot_class": "local_push",
   "requirements": ["PyJWT>=2.0.0"],
-  "version": "0.4.0"
+  "version": "0.4.1"
 }