<?php

/**
 * Utility class for searching Zillow agents by name via the private-zillow RapidAPI provider.
 *
 * @since      1.0.0
 * @package    Listings_For_Zillow_Free
 * @subpackage Listings_For_Zillow_Free/includes/core
 */

class LFZW_Fr_Agent_Search {

    /**
     * RapidAPI host for this provider.
     *
     * @since 1.0.0
     * @var string
     */
    const API_HOST = 'private-zillow.p.rapidapi.com';

    /**
     * Search agents by name.
     *
     * @since 1.0.0
     * @param string $agent_name Agent name to search for.
     * @param int    $page       Page number.
     * @return array Normalized list of matching agents.
     * @throws Exception If the request fails.
     */
    public function search( $agent_name, $page = 1 ) {

        require_once LFZW_Fr_Main::$plugin_dir . 'includes/core/class-lfzw-fr-scrapper.php';

        $api_url = 'https://' . self::API_HOST . '/agent/search?' . http_build_query([
            'agentName'  => $agent_name,
            'page'       => $page,
        ]);

        $scrapper = new LFZW_Fr_Scrapper();
        $response = $scrapper->make_request( $api_url );

        $json = json_decode( $response, true );
        if ( ! isset( $json['agents'] ) || ! is_array( $json['agents'] ) ) {
            return [];
        }

        $agents = [];
        foreach ( $json['agents'] as $agent ) {
            $agents[] = $this->format_agent( $agent );
        }

        return $agents;
    }

    /**
     * Normalize a single agent record from the API response.
     *
     * @since 1.0.0
     * @param array $agent Raw agent record.
     * @return array Normalized agent record.
     */
    private function format_agent( $agent ) {

        return [
            'name'                 => isset( $agent['name'] ) ? sanitize_text_field( $agent['name'] ) : '',
            'username'             => isset( $agent['username'] ) ? wp_strip_all_tags( trim( $agent['username'] ) ) : '',
            'link'                 => isset( $agent['link'] ) ? esc_url_raw( $agent['link'] ) : '',
            'encoded_zuid'         => isset( $agent['encodedZuid'] ) ? sanitize_text_field( $agent['encodedZuid'] ) : '',
            'image_url'            => isset( $agent['imageUrl'] ) ? esc_url_raw( $agent['imageUrl'] ) : '',
            'is_top_agent'         => ! empty( $agent['isTopAgent'] ),
            'rating'               => isset( $agent['reviewInformation']['rating'] ) ? sanitize_text_field( $agent['reviewInformation']['rating'] ) : '',
            'total_reviews'        => isset( $agent['reviewInformation']['totalReviews'] ) ? sanitize_text_field( $agent['reviewInformation']['totalReviews'] ) : '',
        ];
    }
}