"""Admin data-access API: org/user limits, usage overview, export audit. Thin router over `sinetti_services.data_access_meter`. Mounted with `dependencies=[Depends(require_admin)]` in sinetti_api/app.py (same pattern as billing_admin). Validation ValueErrors return a graceful `{ok: false, message}` envelope; unknown orgs 404. """ from __future__ import annotations from dataclasses import asdict from datetime import datetime from fastapi import APIRouter, Depends, HTTPException, Query from pydantic import BaseModel import store_billing from sinetti_api.deps import require_admin from sinetti_services import data_access_meter as meter from sinetti_services.user_directory import User router = APIRouter(prefix="/api/admin/data-access", tags=["data_access_admin"]) class LimitsPayload(BaseModel): requests_per_window: int | None = None daily_export_rows: int | None = None monthly_export_rows: int | None = None periodic_unlimited: bool | None = None def _limits_ok(limits: meter.EffectiveLimits) -> dict: return {"ok": True, "limits": asdict(limits)} def _parse_optional_dt(value: str | None, field: str) -> datetime | None: if value is None or value == "": return None text = value.strip() if text.endswith("Z"): text = text[:-1] + "+00:00" try: parsed = datetime.fromisoformat(text) except ValueError as exc: raise ValueError(f"{field} must be an ISO-8601 datetime") from exc if parsed.tzinfo is None: raise ValueError(f"{field} must be timezone-aware") return parsed @router.get("/orgs/{org_id}") def get_org_data_access(org_id: str) -> dict: org = store_billing.get_org(org_id) if org is None: raise HTTPException(status_code=404, detail=f"Unknown org {org_id!r}") overview = meter.org_usage_overview(org_id) member_ids = [m["user_id"] for m in store_billing.org_members(org_id)] members = meter.usage_overview(member_ids) if member_ids else [] return { "org_id": overview["org_id"], "name": org["name"], "limits": overview["limits"], "requests_in_window": overview["requests_in_window"], "daily_export_rows_used": overview["daily_export_rows_used"], "monthly_export_rows_used": overview["monthly_export_rows_used"], "members": members, } @router.put("/orgs/{org_id}/limits") def put_org_limits(org_id: str, body: LimitsPayload, admin: User = Depends(require_admin)) -> dict: if store_billing.get_org(org_id) is None: raise HTTPException(status_code=404, detail=f"Unknown org {org_id!r}") try: limits = meter.set_org_limits( org_id, requests_per_window=body.requests_per_window, daily_export_rows=body.daily_export_rows, monthly_export_rows=body.monthly_export_rows, periodic_unlimited=body.periodic_unlimited, updated_by=admin.user_id, ) except ValueError as exc: return {"ok": False, "message": str(exc)} return _limits_ok(limits) @router.delete("/orgs/{org_id}/limits") def delete_org_limits(org_id: str, admin: User = Depends(require_admin)) -> dict: if store_billing.get_org(org_id) is None: raise HTTPException(status_code=404, detail=f"Unknown org {org_id!r}") try: limits = meter.reset_org_limits(org_id, updated_by=admin.user_id) except ValueError as exc: return {"ok": False, "message": str(exc)} return _limits_ok(limits) @router.put("/users/{user_id}/limits") def put_user_limits(user_id: str, body: LimitsPayload, admin: User = Depends(require_admin)) -> dict: try: limits = meter.set_limits( user_id, requests_per_window=body.requests_per_window, daily_export_rows=body.daily_export_rows, monthly_export_rows=body.monthly_export_rows, periodic_unlimited=body.periodic_unlimited, updated_by=admin.user_id, ) except ValueError as exc: return {"ok": False, "message": str(exc)} return _limits_ok(limits) @router.delete("/users/{user_id}/limits") def delete_user_limits(user_id: str, admin: User = Depends(require_admin)) -> dict: try: limits = meter.reset_limits(user_id, updated_by=admin.user_id) except ValueError as exc: return {"ok": False, "message": str(exc)} return _limits_ok(limits) @router.get("/export-audit") def get_export_audit( org_id: str | None = None, user_id: str | None = None, outcome: str | None = None, date_from: str | None = None, date_to: str | None = None, limit: int = Query(default=100, ge=1, le=1000), offset: int = Query(default=0, ge=0), ) -> dict: try: parsed_from = _parse_optional_dt(date_from, "date_from") parsed_to = _parse_optional_dt(date_to, "date_to") items, total = meter.list_export_audit( org_id=org_id, user_id=user_id, outcome=outcome, date_from=parsed_from, date_to=parsed_to, limit=limit, offset=offset, ) except ValueError as exc: return {"ok": False, "message": str(exc)} return {"items": items, "total": total}