<?php

declare(strict_types=1);

namespace AilysLens\Core;

/**
 * crawlers.json の1エントリ。スキーマの正は core/data/README.md。
 */
final class CrawlerDefinition
{
    public const CATEGORY_TRAINING     = 'training';
    public const CATEGORY_SEARCH_INDEX = 'search_index';
    public const CATEGORY_USER_FETCH   = 'user_fetch';

    public const CATEGORIES = [
        self::CATEGORY_TRAINING,
        self::CATEGORY_SEARCH_INDEX,
        self::CATEGORY_USER_FETCH,
    ];

    public const VERIFY_IP_LIST = 'ip_list';
    public const VERIFY_RDNS    = 'rdns';
    public const VERIFY_NONE    = 'none';

    public const VERIFY_METHODS = [
        self::VERIFY_IP_LIST,
        self::VERIFY_RDNS,
        self::VERIFY_NONE,
    ];

    public string $id;

    public string $vendor;

    public string $uaPattern;

    public string $category;

    /** @var array{method: string, ip_list_url?: string, domains?: array<int, string>} */
    public array $verify;

    public string $docsUrl;

    public ?string $note;

    /**
     * @param array{method: string, ip_list_url?: string, domains?: array<int, string>} $verify
     */
    public function __construct(
        string $id,
        string $vendor,
        string $uaPattern,
        string $category,
        array $verify,
        string $docsUrl,
        ?string $note = null
    ) {
        $this->id        = $id;
        $this->vendor    = $vendor;
        $this->uaPattern = $uaPattern;
        $this->category  = $category;
        $this->verify    = $verify;
        $this->docsUrl   = $docsUrl;
        $this->note      = $note;
    }

    public function verifyMethod(): string
    {
        return $this->verify['method'];
    }

    /**
     * @return array<int, string>
     */
    public function verifyDomains(): array
    {
        return $this->verify['domains'] ?? [];
    }

    public function verifyIpListUrl(): ?string
    {
        return $this->verify['ip_list_url'] ?? null;
    }
}