<?php
/**
 * Known_Bots — small bundled operator map for the Buyers drawer.
 *
 * R2 keeps this deliberately boring: a local JSON file bundled with the plugin
 * so wp-admin can render useful operator context without a runtime lookup.
 */

declare(strict_types=1);

defined( 'ABSPATH' ) || exit;

final class Prweb_Known_Bots {

    private const SHARED_DATA_FILE = 'shared/data/known-bots.json';
    private const BUNDLED_DATA_FILE = 'data/known-bots.json';

    private static ?array $bots = null;

    public static function lookup( string $buyer_id ): array {
        $needle = self::normalize( $buyer_id );
        if ( $needle === '' ) {
            return self::fallback();
        }

        foreach ( self::bots() as $bot ) {
            $aliases = array_merge(
                [ (string) ( $bot['id'] ?? '' ) ],
                is_array( $bot['aliases'] ?? null ) ? $bot['aliases'] : []
            );

            foreach ( $aliases as $alias ) {
                $candidate = self::normalize( (string) $alias );
                if ( $candidate === '' ) {
                    continue;
                }
                if ( $candidate === $needle || str_contains( $needle, $candidate ) || str_contains( $candidate, $needle ) ) {
                    return self::public_shape( $bot, 'known' );
                }
            }
        }

        return self::fallback();
    }

    private static function bots(): array {
        if ( self::$bots !== null ) {
            return self::$bots;
        }

        $raw = false;
        foreach ( self::candidate_paths() as $path ) {
            if ( is_readable( $path ) ) {
                $raw = file_get_contents( $path );
                break;
            }
        }
        if ( $raw === false ) {
            self::$bots = [];
            return self::$bots;
        }

        $decoded = json_decode( $raw, true );
        self::$bots = is_array( $decoded['bots'] ?? null ) ? $decoded['bots'] : [];
        return self::$bots;
    }

    private static function candidate_paths(): array {
        $plugin_root = defined( 'PRWEB_PATH' ) ? PRWEB_PATH : dirname( __DIR__ ) . '/';
        $repo_root   = dirname( rtrim( $plugin_root, '/' ), 2 );

        return [
            $repo_root . '/' . self::SHARED_DATA_FILE,
            $plugin_root . self::BUNDLED_DATA_FILE,
        ];
    }

    private static function public_shape( array $bot, string $source ): array {
        return [
            'source'                => $source,
            'operator_name'         => (string) ( $bot['operator_name'] ?? '' ),
            'domain'                => (string) ( $bot['domain'] ?? '' ),
            'crawler_ua'            => (string) ( $bot['crawler_ua'] ?? '' ),
            'ip_ranges'             => array_values( array_filter( array_map( 'strval', is_array( $bot['ip_ranges'] ?? null ) ? $bot['ip_ranges'] : [] ) ) ),
            'ip_range_verification' => (string) ( $bot['ip_range_verification'] ?? 'unverified' ),
            'contact_url'           => (string) ( $bot['contact_url'] ?? '' ),
        ];
    }

    private static function fallback(): array {
        return [
            'source'                => 'unknown',
            'operator_name'         => '',
            'domain'                => '',
            'crawler_ua'            => '',
            'ip_ranges'             => [],
            'ip_range_verification' => 'unverified',
            'contact_url'           => '',
        ];
    }

    private static function normalize( string $value ): string {
        return preg_replace( '/[^a-z0-9]+/', '', strtolower( $value ) ) ?? '';
    }
}