<?php

declare(strict_types=1);

namespace App\Models\FormBuilder;

use App\Models\User;
use Illuminate\Database\Eloquent\Concerns\HasUlids;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

/**
 * RFC-WS-6.md §3 Q5 addendum — per-attempt retry history.
 *
 * Each retry of a FormSubmissionActionFailure produces a row here.
 * Outcome is 'succeeded' (parent gets resolved_at + system note) or
 * 'failed' (parent remains open with retry_count incremented; if the
 * exception details differ from the original, they're captured
 * per-attempt). Parent's own `exception_class` / `exception_message`
 * stay audit-immutable — they represent the FIRST failure, not the
 * latest retry.
 */
final class FormSubmissionActionFailureRetryAttempt extends Model
{
    /** @use HasFactory<\Database\Factories\FormBuilder\FormSubmissionActionFailureRetryAttemptFactory> */
    use HasFactory;

    use HasUlids;

    protected $table = 'form_submission_action_failure_retry_attempts';

    protected $fillable = [
        'form_submission_action_failure_id',
        'attempted_at',
        'attempted_by_user_id',
        'outcome',
        'exception_class',
        'exception_message',
    ];

    /** @var array<string, string> */
    protected $casts = [
        'attempted_at' => 'datetime',
    ];

    /** @return BelongsTo<FormSubmissionActionFailure, $this> */
    public function failure(): BelongsTo
    {
        return $this->belongsTo(FormSubmissionActionFailure::class, 'form_submission_action_failure_id');
    }

    /** @return BelongsTo<User, $this> */
    public function attemptedBy(): BelongsTo
    {
        return $this->belongsTo(User::class, 'attempted_by_user_id');
    }
}