"""Audit logging service foundation.""" from __future__ import annotations import json from dataclasses import dataclass from datetime import UTC, datetime from typing import Any from uuid import uuid4 from core.identity import RequestContext from database.db_helper import Database, DatabaseSettings def new_audit_id() -> str: return f"audit_{uuid4().hex}" @dataclass(frozen=True) class AuditRecord: audit_id: str request_id: str | None actor_type: str actor_id: str | None action: str target_type: str target_id: str | None before_snapshot: str | None after_snapshot: str | None metadata_json: str | None created_at: str class AuditService: def __init__(self, database: Database | None = None): self.database = database or Database() def record( self, *, ctx: RequestContext, action: str, target_type: str, target_id: str | None = None, before_snapshot: Any | None = None, after_snapshot: Any | None = None, metadata: dict[str, Any] | None = None, ) -> AuditRecord: record = AuditRecord( audit_id=new_audit_id(), request_id=ctx.request_id, actor_type=ctx.actor_type, actor_id=ctx.actor_id, action=action, target_type=target_type, target_id=target_id, before_snapshot=_json_or_none(before_snapshot), after_snapshot=_json_or_none(after_snapshot), metadata_json=_json_or_none(metadata or {"request_id": ctx.request_id}), created_at=datetime.now(UTC).isoformat(), ) self._insert(record) return record def _insert(self, record: AuditRecord) -> None: placeholder = self.database._placeholder sql = f""" INSERT INTO audit_logs ( audit_id, request_id, actor_type, actor_id, action, target_type, target_id, before_snapshot, after_snapshot, metadata_json, created_at ) VALUES ( {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder}, {placeholder} ) """ conn = self.database.connect() try: conn.execute( sql, ( record.audit_id, record.request_id, record.actor_type, record.actor_id, record.action, record.target_type, record.target_id, record.before_snapshot, record.after_snapshot, record.metadata_json, record.created_at, ), ) conn.commit() finally: conn.close() def create_audit_service(settings: DatabaseSettings | None = None) -> AuditService: return AuditService(Database(settings)) def _json_or_none(value: Any | None) -> str | None: if value is None: return None return json.dumps(value, ensure_ascii=False, sort_keys=True)