"""Watchlist matching. Pure matcher (testable) + DB-bound evaluation used during ingest."""

from __future__ import annotations

from dataclasses import dataclass

@dataclass

class WatchEntry:

    id: str

    plate_norm: str | None = None

    partial_plate: str | None = None

    vehicle_desc: dict | None = None

def match_entry(entry: WatchEntry, plate_norm: str, vehicle: dict | None = None) -> str | None:

    """Return the match reason string, or None. Order: exact > partial > vehicle description."""

    if entry.plate_norm and entry.plate_norm == plate_norm:

        return "exact_plate"

    if entry.partial_plate:

        p = entry.partial_plate.upper()

        if plate_norm.startswith(p) or p in plate_norm:

            return "partial_plate"

    if entry.vehicle_desc and vehicle:

        wanted = {k: v for k, v in entry.vehicle_desc.items() if v}

        if wanted and all(str(vehicle.get(k, "")).lower() == str(v).lower() for k, v in wanted.items()):

            return "vehicle_description"

    return None

def match_all(entries: list[WatchEntry], plate_norm: str, vehicle: dict | None = None) -> list[dict]:

    hits = []

    for e in entries:

        reason = match_entry(e, plate_norm, vehicle)

        if reason:

            hits.append({"entry_id": e.id, "matched_on": reason})

    return hits