max-bot-api-client-php/src/Models/UpdateList.php

<?php

declare(strict_types=1);

namespace BushlanovDev\MaxMessengerBot\Models;

use BushlanovDev\MaxMessengerBot\Models\Updates\AbstractUpdate;

/**
 * List of all updates in chats your bot participated in.
 */
final readonly class UpdateList extends AbstractModel
{
    /**
     * @param AbstractUpdate[] $updates Page of updates.
     * @param int|null $marker Pointer to the next data page.
     */
    public function __construct(
        public array $updates,
        public ?int $marker,
    ) {
    }

    /**
     * Overridden to prevent incorrect usage.
     * UpdateList contains polymorphic objects and must be created via ModelFactory.
     *
     * @param array<string, mixed> $data
     * @throws \LogicException Always.
     */
    public static function fromArray(array $data): static
    {
        throw new \LogicException(
            'Cannot create UpdateList directly from an array. Use ModelFactory::createUpdateList() instead.'
        );
    }
}