<?php
declare(strict_types=1);
namespace App\Repository;

interface SnapshotRepository
{
    public function add(int $eventId, string $fileUuid, string $contentHash): void;
    public function forEvent(int $eventId): array;
    public function pathByUuid(string $uuid): ?string;
    /** The event_id that owns this snapshot uuid, or null. Lets the proxy resolve a
     *  snapshot's site (via the owning event) for access control. */
    public function eventIdByUuid(string $uuid): ?int;

    /** Newest snapshot file_uuid for each of the given event ids, as [event_id => file_uuid].
     *  Batched (one query) so the event list can show a thumbnail per row without an N+1.
     *  Events with no snapshot are simply absent from the map. */
    public function thumbUuidsFor(array $eventIds): array;

    /** Most recent snapshot for a camera, as ['file_uuid' => ..., 'device_id' => ...], or null.
     *  Backs the zone editor's "load the latest frame" button: an operator draws hazard zones
     *  over what the camera actually sees instead of guessing coordinates on a blank canvas.
     *  device_id comes back so the caller can site-scope the result. */
    public function latestForCamera(string $cameraId): ?array;

    /** Delete snapshot files + rows created before $cutoff (unix ts). PIPA retention:
     *  worker images must not be kept forever. Returns the number purged. */
    public function purgeOlderThan(int $cutoff): int;
}