<?php

declare(strict_types=1);

namespace Bakame\Http\StructuredFields\Validation;

use ArrayAccess;
use Bakame\Http\StructuredFields\ForbiddenOperation;
use Bakame\Http\StructuredFields\InvalidOffset;
use Bakame\Http\StructuredFields\StructuredFieldProvider;
use Countable;
use Iterator;
use IteratorAggregate;

/**
 * @phpstan-import-type SfType from StructuredFieldProvider
 *
 * @implements ArrayAccess<array-key, array{0:string, 1:SfType}|array{}|SfType|null>
 * @implements IteratorAggregate<array-key, array{0:string, 1:SfType}|array{}|SfType|null>
 */
final class ValidatedParameters implements ArrayAccess, Countable, IteratorAggregate
{
    /**
     * @param array<array-key, array{0:string, 1:SfType}|array{}|SfType|null> $values
     */
    public function __construct(
        private readonly array $values = [],
    ) {
    }

    public function count(): int
    {
        return count($this->values);
    }

    public function getIterator(): Iterator
    {
        yield from $this->values;
    }

    public function offsetExists($offset): bool
    {
        return array_key_exists($offset, $this->values);
    }

    public function offsetGet($offset): mixed
    {
        return $this->offsetExists($offset) ? $this->values[$offset] : throw InvalidOffset::dueToMemberNotFound($offset);
    }

    public function offsetUnset(mixed $offset): void
    {
        throw new ForbiddenOperation(self::class.' instance can not be updated using '.ArrayAccess::class.' methods.');
    }

    public function offsetSet(mixed $offset, mixed $value): void
    {
        throw new ForbiddenOperation(self::class.' instance can not be updated using '.ArrayAccess::class.' methods.');
    }

    /**
     * @return array<array-key, array{0:string, 1:SfType}|array{}|SfType|null>
     */
    public function all(): array
    {
        return $this->values;
    }
}