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

declare( strict_types=1 );

namespace Extrova\Core;

defined( 'ABSPATH' ) || exit;

/**
 * Validated configuration of one extra (schema v1). Immutable.
 *
 * @since 1.0.0
 */
final readonly class Extra {

	/**
	 * Constructor.
	 *
	 * @param string $id          Stable id (`ext_` + 8 hex chars).
	 * @param string $status      `active` or `inactive`.
	 * @param string $type        Type slug.
	 * @param string $label       Label.
	 * @param string $description Description.
	 * @param bool   $required    Whether the customer must choose a value.
	 * @param int    $position    Order.
	 * @param array  $locations   Location slugs.
	 * @param array  $pricing     Pricing block: { method, amount|percent, ... }.
	 * @param array  $tax         { taxable: bool, tax_class: string }.
	 * @param array  $type_config Type configuration.
	 * @param array  $conditions  Condition list (implicit AND).
	 * @param array  $meta        Free namespaced bag (meta.pro.* belongs to the Pro). Preserved on save.
	 */
	public function __construct(
		public string $id,
		public string $status,
		public string $type,
		public string $label,
		public string $description,
		public bool $required,
		public int $position,
		public array $locations,
		public array $pricing,
		public array $tax,
		public array $type_config,
		public array $conditions,
		public array $meta
	) {}

	/**
	 * Builds an extra from its stored array. Applies structural defaults only (no sanitising).
	 *
	 * @param array $data Stored data.
	 */
	public static function from_array( array $data ): self {
		return new self(
			(string) ( $data['id'] ?? '' ),
			'inactive' === ( $data['status'] ?? 'active' ) ? 'inactive' : 'active',
			(string) ( $data['type'] ?? '' ),
			(string) ( $data['label'] ?? '' ),
			(string) ( $data['description'] ?? '' ),
			(bool) ( $data['required'] ?? false ),
			(int) ( $data['position'] ?? 0 ),
			is_array( $data['locations'] ?? null ) ? array_values( $data['locations'] ) : array( 'checkout' ),
			is_array( $data['pricing'] ?? null ) ? $data['pricing'] : array(),
			is_array( $data['tax'] ?? null ) ? $data['tax'] : array(
				'taxable'   => false,
				'tax_class' => '',
			),
			is_array( $data['type_config'] ?? null ) ? $data['type_config'] : array(),
			is_array( $data['conditions'] ?? null ) ? array_values( $data['conditions'] ) : array(),
			is_array( $data['meta'] ?? null ) ? $data['meta'] : array()
		);
	}

	/**
	 * Array representation (storage and REST).
	 */
	public function to_array(): array {
		return array(
			'id'          => $this->id,
			'status'      => $this->status,
			'type'        => $this->type,
			'label'       => $this->label,
			'description' => $this->description,
			'required'    => $this->required,
			'position'    => $this->position,
			'locations'   => $this->locations,
			'pricing'     => $this->pricing,
			'tax'         => $this->tax,
			'type_config' => $this->type_config,
			'conditions'  => $this->conditions,
			'meta'        => $this->meta,
		);
	}

	/**
	 * Returns a copy with some fields changed (used by A/B variants in the Pro).
	 *
	 * @param array $changes Field => value.
	 */
	public function with( array $changes ): self {
		return self::from_array( array_merge( $this->to_array(), $changes ) );
	}

	/**
	 * Copy with another label.
	 *
	 * @param string $label Label.
	 */
	public function with_label( string $label ): self {
		return $this->with( array( 'label' => $label ) );
	}

	/**
	 * Copy with another pricing block.
	 *
	 * @param array $pricing Pricing block.
	 */
	public function with_pricing( array $pricing ): self {
		return $this->with( array( 'pricing' => $pricing ) );
	}

	/**
	 * Whether the extra is active.
	 */
	public function is_active(): bool {
		return 'active' === $this->status;
	}

	/**
	 * Whether the extra is taxable.
	 */
	public function is_taxable(): bool {
		return ! empty( $this->tax['taxable'] );
	}

	/**
	 * Tax class slug ('' = standard).
	 */
	public function tax_class(): string {
		return (string) ( $this->tax['tax_class'] ?? '' );
	}
}