<?php

declare(strict_types=1);

namespace App\FormBuilder\Resolvers;

use App\Exceptions\Artist\ArtistDeletedException;
use App\Exceptions\Artist\InvalidPortalTokenException;
use App\Models\Artist;
use App\Models\ArtistEngagement;
use App\Models\Scopes\OrganisationScope;

/**
 * Engagement-scoped subject resolution for the artist_advance portal
 * flow. Per ARCH-FORM-BUILDER §17.3 footnote and RFC-TIMETABLE v0.2
 * D15: the master Artist is the FormSubmission subject (subject_type
 * = 'artist'), but the engagement provides the event_id (denormalised
 * onto form_submissions per WS-4) and any advance_section context.
 *
 * The portal token itself is stored on artist_engagements.portal_token
 * as a SHA-256 hex digest (Session 1 commit eb6d396). Callers pass
 * the plaintext token; we hash and look up.
 *
 * This resolver is the single shared helper for portal-token →
 * engagement resolution. PortalTokenMiddleware delegates to it; the
 * EngagementPortalController calls it directly to produce the value
 * object the FormSubmissionService needs.
 */
final class ArtistResolver
{
    public function fromPortalToken(string $portalToken): ArtistResolverResult
    {
        $digest = hash('sha256', $portalToken);

        $engagement = ArtistEngagement::query()
            ->withoutGlobalScope(OrganisationScope::class)
            ->where('portal_token', $digest)
            ->first();

        if ($engagement === null) {
            throw InvalidPortalTokenException::create();
        }

        $artist = Artist::query()
            ->withoutGlobalScope(OrganisationScope::class)
            ->whereKey($engagement->artist_id)
            ->first();

        if (! $artist instanceof Artist) {
            throw new ArtistDeletedException((string) $engagement->id);
        }

        return new ArtistResolverResult(
            subject: $artist,
            eventId: (string) $engagement->event_id,
            engagement: $engagement,
        );
    }
}