<?php

declare(strict_types=1);

namespace App\Models\FormBuilder;

use App\Enums\FormBuilder\FormFieldConditionalLogicConditionOperator;
use App\Models\Scopes\OrganisationScope;
use Illuminate\Database\Eloquent\Concerns\HasUlids;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

/**
 * A leaf of the relational conditional-logic tree — one comparison
 * of `(field_slug, operator, value)` against the current form values
 * (ARCH-FORM-BUILDER §8).
 *
 * `value` is JSON nullable: scalar for most operators, array for
 * `in`/`not_in`, null for `empty`/`not_empty`. Shape validation is
 * enforced at the service layer (`FormFieldConditionalLogicService
 * ::assertSpecsValid`), not the DB.
 *
 * Multi-tenancy chain is 4 hops (condition → group → field → schema →
 * organisation_id column) — inside the WS-5c raised cap of 5.
 */
final class FormFieldConditionalLogicCondition extends Model
{
    use HasFactory;
    use HasUlids;

    protected $table = 'form_field_conditional_logic_conditions';

    protected static function booted(): void
    {
        static::addGlobalScope(new OrganisationScope());
    }

    /** @return array{via: class-string, fk: string} */
    public static function tenantScopeStrategy(): array
    {
        return ['via' => FormFieldConditionalLogicGroup::class, 'fk' => 'group_id'];
    }

    protected $fillable = [
        'group_id',
        'field_slug',
        'comparison_operator',
        'value',
        'sort_order',
    ];

    /** @var array<string, string> */
    protected $casts = [
        'comparison_operator' => FormFieldConditionalLogicConditionOperator::class,
        'value' => 'array',
        'sort_order' => 'int',
    ];

    public function group(): BelongsTo
    {
        return $this->belongsTo(FormFieldConditionalLogicGroup::class, 'group_id');
    }
}