✨ [feat][backend] Add event clearing API

Author: tomy0000000

backend/kayman/routers/event.py

@@ -15,6 +15,7 @@
 from kayman.schemas.event import (
     Event,
     EventBase,
+    EventClear,
     EventCreate,
     EventRead,
     EventUpdate,
@@ -67,6 +68,18 @@ def update(
         raise HTTPException(status_code=404, detail=err.args[0]) from err
 
 
+@event_router.post("/{event_id}/cleared", name="Clear Event", response_model=EventRead)
+def clear(
+    *, session: Session = Depends(get_session), event_id: int, data: EventClear
+) -> EventBase:
+    # TODO: validate event details before clearing
+    update = EventUpdate(**data.model_dump(exclude_unset=True))
+    try:
+        return update_events(session, [event_id], [update])[0]
+    except ValueError as err:
+        raise HTTPException(status_code=404, detail=err.args[0]) from err
+
+
 @event_router.delete("/{id}", name="Delete Event")
 def delete(*, session: Session = Depends(get_session), id: int) -> None:
     event = session.get(Event, id)

backend/kayman/schemas/event.py

@@ -52,6 +52,10 @@ class EventRead(EventBase):
     id: int
 
 
+class EventClear(SQLModel):
+    cleared_at: datetime
+
+
 class EventUpdate(SQLModel):
     type: EventType | None = None
     timestamp: datetime | None = None