refactor: Pydantic webhook payload models, lifespan task cancellation, dict/Pydantic compat helpers

guarddog_nexus/schemas.py

@@ -102,6 +102,30 @@ class StatsResponse(BaseModel):
     latest_scan_at: datetime | None = None
 
 
+# Webhook payload models
+class WebhookAsset(BaseModel):
+    id: str | None = None
+    format: str = ""
+    path: str | None = None
+    name: str | None = None
+    downloadUrl: str | None = None
+
+
+class WebhookComponent(BaseModel):
+    id: str | None = None
+    format: str = ""
+    name: str = ""
+    version: str = ""
+
+
+class WebhookPayload(BaseModel):
+    action: str = ""
+    repositoryName: str = ""
+    initiator: str | None = None
+    asset: WebhookAsset | None = None
+    component: WebhookComponent | None = None
+
+
 # Finding data known fields (prevents **f.data from overwriting id/scan_id)
 _FINDING_DATA_FIELDS = ("rule", "severity", "message", "location", "code")