<?php
/**
 * Verifies the configured credentials against the collector.
 *
 * @package AdPix\Analytics
 */

declare( strict_types = 1 );

namespace AdPix\Analytics\Service;

use AdPix\Analytics\Contracts\TransportInterface;

defined( 'ABSPATH' ) || exit;

/**
 * Asks the collector whether these credentials work, and reports back what they are for.
 *
 * Worth a dedicated endpoint call rather than "send an event and see": the answer names the
 * property, so a site owner who has pasted the key from the wrong property finds out here instead of
 * a week later when the numbers are in someone else's dashboard.
 */
final class ConnectionTester {

	/**
	 * @var TransportInterface
	 */
	private $transport;

	/**
	 * @param TransportInterface $transport Outbound transport.
	 */
	public function __construct( TransportInterface $transport ) {
		$this->transport = $transport;
	}

	/**
	 * Run the check.
	 *
	 * @return array<string,mixed> Keys: ok, message, property, scopes, hmac_required, attribution_window_days.
	 */
	public function test(): array {
		$response = $this->transport->send( 'verify', array() );

		if ( ! $response->is_ok() ) {
			return array(
				'ok'      => false,
				'message' => $response->error(),
			);
		}

		// The property is a nested object, not a flat property_id. Reading it from the wrong level is a
		// silent failure: the call succeeded, so the screen would report a healthy connection to a
		// property it could not name.
		$property = $response->get( 'property', array() );
		$property = is_array( $property ) ? $property : array();

		$scopes = $response->get( 'scopes', array() );
		$scopes = is_array( $scopes ) ? array_map( 'strval', $scopes ) : array();

		return array(
			'ok'                      => true,
			'message'                 => __( 'Connected.', 'adpix-analytics' ),
			'property'                => array(
				'id'       => isset( $property['id'] ) && is_scalar( $property['id'] ) ? (string) $property['id'] : '',
				'name'     => isset( $property['name'] ) && is_scalar( $property['name'] ) ? (string) $property['name'] : '',
				'timezone' => isset( $property['timezone'] ) && is_scalar( $property['timezone'] ) ? (string) $property['timezone'] : '',
			),
			'scopes'                  => $scopes,
			'hmac_required'           => (bool) $response->get( 'hmac_required', false ),
			'attribution_window_days' => (int) $response->get( 'attribution_window_days', 0 ),
		);
	}
}