<?php
/**
 * Store API update callback (extensionCartUpdate).
 *
 * @package Extrova
 */

declare( strict_types=1 );

namespace Extrova\StoreApi;

use Extrova\Core\ContextFactory;
use Extrova\Core\ExtraService;

defined( 'ABSPATH' ) || exit;

/**
 * Receives `{ action: 'set'|'clear'|'resync', selections: { ext_id: value } }` from the Checkout block.
 * Only ids and values are accepted, never amounts (the custom tip is clamped server side).
 * The Store API recalculates totals and returns the whole cart afterwards.
 *
 * @since 1.0.0
 */
final class UpdateCallback {

	/**
	 * Constructor.
	 *
	 * @param ExtraService   $service  Engine.
	 * @param ContextFactory $contexts Contexts.
	 */
	public function __construct(
		private ExtraService $service,
		private ContextFactory $contexts
	) {}

	/**
	 * Registers the callback.
	 */
	public function register(): void {
		if ( ! function_exists( 'woocommerce_store_api_register_update_callback' ) ) {
			return;
		}
		woocommerce_store_api_register_update_callback(
			array(
				'namespace' => CartExtension::STORE_NAMESPACE,
				'callback'  => array( $this, 'handle' ),
			)
		);
	}

	/**
	 * Handles the update.
	 *
	 * @param mixed $data Request `data`.
	 * @throws \Automattic\WooCommerce\StoreApi\Exceptions\RouteException On an invalid action.
	 */
	public function handle( mixed $data ): void {
		$data    = is_array( $data ) ? $data : array();
		$action  = sanitize_key( is_string( $data['action'] ?? null ) ? $data['action'] : 'set' );
		$context = $this->contexts->current( 'checkout_block' );

		if ( 'clear' === $action ) {
			$this->service->clear_selections( $context, 'store_api' );
			return;
		}

		// `resync`: nothing to store; the Store API recalculates and returns the cart afterwards.
		if ( 'resync' === $action ) {
			return;
		}

		if ( 'set' !== $action ) {
			if ( class_exists( \Automattic\WooCommerce\StoreApi\Exceptions\RouteException::class ) ) {
				throw new \Automattic\WooCommerce\StoreApi\Exceptions\RouteException(
					'extrova_invalid_action',
					esc_html__( 'Invalid checkout extras action.', 'extrova' ),
					400
				);
			}
			return;
		}

		$raw = is_array( $data['selections'] ?? null ) ? $data['selections'] : array();
		$this->service->set_selections( $raw, $context, 'store_api' );
	}
}