<?php
/**
 * Device and location of a visitor.
 *
 * @package Dealroot
 */

namespace Dealroot;

defined( 'ABSPATH' ) || exit;

/**
 * The kind of device, the browser, the country and the city of the visitor of the current
 * request, as stored with visits and leads for the reports.
 */
class Visitor {

	/**
	 * Column values.
	 *
	 * @param string $time_zone Time zone of the visitor's browser.
	 * @return array{device: string, browser: string, country: string, city: string, lat: float, lon: float, geo: string} 0, 0 when the place is not known; geo tells where the place came from.
	 */
	public static function columns( $time_zone = '' ) {
		$device = Devices::from_request();
		$place  = Geo::locate( $time_zone );

		return array(
			'device'  => $device ? $device['type'] : '',
			'browser' => $device ? mb_substr( $device['browser'], 0, 40 ) : '',
			'country' => $place['country'],
			'city'    => $place['city'],
			'lat'     => (float) $place['lat'],
			'lon'     => (float) $place['lon'],
			'geo'     => $place['source'],
		);
	}

	/**
	 * Column values for a lead sent by a visitor that Dealroot tracks. A lead without
	 * attribution, e.g. an order a payment service reports, gets none.
	 *
	 * @param array|null $attribution Output of Attribution::from_request().
	 * @return array
	 */
	public static function for_lead( $attribution ) {
		if ( empty( $attribution['first'] ) ) {
			return array();
		}

		return self::columns( (string) ( $attribution['tz'] ?? '' ) );
	}
}