<?php
/**
 * Selection value object.
 *
 * @package Extrova
 */

declare( strict_types=1 );

namespace Extrova\Core;

defined( 'ABSPATH' ) || exit;

/**
 * Value chosen by the customer for one extra (already sanitised by its type).
 *
 * @since 1.0.0
 */
final readonly class Selection {

	/**
	 * Constructor.
	 *
	 * @param string $extra_id   Extra id.
	 * @param mixed  $value      Sanitised value (bool, option id, text, tip array...).
	 * @param int    $updated_at Unix timestamp.
	 */
	public function __construct(
		public string $extra_id,
		public mixed $value,
		public int $updated_at = 0
	) {}

	/**
	 * Builds a selection from its session array.
	 *
	 * @param string $extra_id Extra id.
	 * @param array  $data     { value, updated_at }.
	 */
	public static function from_array( string $extra_id, array $data ): self {
		return new self( $extra_id, $data['value'] ?? null, (int) ( $data['updated_at'] ?? 0 ) );
	}

	/**
	 * Session representation.
	 */
	public function to_array(): array {
		return array(
			'value'      => $this->value,
			'updated_at' => $this->updated_at,
		);
	}
}