"""Shared types reused across multiple Lambda event/response schemas."""

from typing import Literal

from pydantic import BaseModel


class TerraformHit(BaseModel):
    """A Terraform file reference found during a GitHub org search.

    ``confidence`` reflects how reliable the matching search term was:
    ``high`` for precise identifiers (the full email, the email local-part)
    and ``low`` for the derived initial+lastname form, which collides with
    unrelated resource names and produces many false positives.
    """

    path: str
    html_url: str
    repository: str
    confidence: Literal['high', 'low'] = 'high'


class Auth0ActionResult(BaseModel):
    """Per-tenant outcome of an Auth0 write action during Phase 2.

    ``operation`` records which action was performed against the tenant:
    ``deleted`` for the offboarding flow (user removed) and ``blocked`` for
    the suspension flow (user's ``blocked`` flag set, login disabled but the
    account preserved for reinstatement).
    """

    tenant: str
    user_id: str
    operation: Literal['deleted', 'blocked']