<?php
/**
 * REST route for the current user's preferences.
 *
 * @package ShiftSnap
 */

declare( strict_types=1 );

namespace ShiftSnap;

use WP_REST_Request;
use WP_REST_Response;
use WP_REST_Server;

defined( 'ABSPATH' ) || exit;

/**
 * `GET|POST /shiftsnap/v1/preferences`: always the logged-in user's own
 * preferences. The standard `wp_rest` nonce (X-WP-Nonce) authenticates
 * cookie requests.
 */
final class RestController {

	/**
	 * Route namespace.
	 */
	public const NAMESPACE = 'shiftsnap/v1';

	/**
	 * Route path.
	 */
	public const ROUTE = '/preferences';

	/**
	 * Hooks the route registration.
	 */
	public static function register(): void {
		add_action( 'rest_api_init', array( self::class, 'register_routes' ) );
	}

	/**
	 * Registers the route.
	 */
	public static function register_routes(): void {
		register_rest_route(
			self::NAMESPACE,
			self::ROUTE,
			array(
				array(
					'methods'             => WP_REST_Server::READABLE,
					'callback'            => array( self::class, 'get_preferences' ),
					'permission_callback' => array( self::class, 'can_edit' ),
				),
				array(
					'methods'             => WP_REST_Server::EDITABLE,
					'callback'            => array( self::class, 'update_preferences' ),
					'permission_callback' => array( self::class, 'can_edit' ),
					'args'                => self::args(),
				),
			)
		);
	}

	/**
	 * Only users who can use the page builder have clipboard preferences.
	 */
	public static function can_edit(): bool {
		return current_user_can( 'edit_posts' );
	}

	/**
	 * Returns the current user's preferences.
	 */
	public static function get_preferences(): WP_REST_Response {
		return new WP_REST_Response( Preferences::get( get_current_user_id() ) );
	}

	/**
	 * Saves the preferences sent in the request (all optional).
	 *
	 * @param WP_REST_Request $request Request; values already validated against the schema.
	 */
	public static function update_preferences( WP_REST_Request $request ): WP_REST_Response {
		$changes = array();

		foreach ( array_keys( Preferences::DEFAULTS ) as $key ) {
			if ( $request->has_param( $key ) ) {
				$changes[ $key ] = $request->get_param( $key );
			}
		}

		return new WP_REST_Response( Preferences::update( get_current_user_id(), $changes ) );
	}

	/**
	 * Route arguments, validated and sanitized by the REST server.
	 *
	 * @return array<string, array<string, mixed>>
	 */
	private static function args(): array {
		$args = array();

		foreach ( Preferences::schema() as $key => $schema ) {
			$args[ $key ] = array_merge(
				$schema,
				array(
					'required'          => false,
					'validate_callback' => 'rest_validate_request_arg',
					'sanitize_callback' => 'rest_sanitize_request_arg',
				)
			);
		}

		return $args;
	}
}