<?php

namespace App\Services\PressRelease\Images;

use App\Enums\ConfirmationChannel;
use App\Models\User;

/**
 * Wer ein Bild hochlädt und über welchen Weg (Bildkennzeichnung A.6).
 *
 * `channel = null` ist der Admin-Upload: Der Admin bestätigt nichts, das
 * Bild wartet auf die Kundenbestätigung per Magic-Link (Decision-Update E10).
 * `user` ist bei Form und API der Kontoinhaber und damit der
 * Vertragspartner (E1); beim Admin-Upload der handelnde Admin.
 */
final readonly class ImageUploadActor
{
    public function __construct(
        public ?User $user,
        public ?ConfirmationChannel $channel,
        public ?int $tokenId = null,
        public ?string $ip = null,
        public ?string $userAgent = null,
        public bool $isAdmin = false,
    ) {}

    public static function form(User $user, ?string $ip, ?string $userAgent): self
    {
        return new self($user, ConfirmationChannel::Form, null, $ip, $userAgent);
    }

    public static function api(User $user, ?int $tokenId, ?string $ip, ?string $userAgent): self
    {
        return new self($user, ConfirmationChannel::Api, $tokenId, $ip, $userAgent);
    }

    public static function admin(User $admin, ?string $ip, ?string $userAgent): self
    {
        return new self($admin, null, null, $ip, $userAgent, isAdmin: true);
    }

    public function confirmsImmediately(): bool
    {
        return $this->channel !== null;
    }
}