<?php
/**
 * REST handlers for reading and writing the settings.
 *
 * @package AcidStudios\AEO
 */

declare(strict_types=1);

namespace AcidStudios\AEO\Rest\Handlers;

use AcidStudios\AEO\Options;
use AcidStudios\AEO\Rest\Controller;
use WP_Error;
use WP_REST_Request;

defined( 'ABSPATH' ) || exit;

/**
 * `GET /settings` and `PUT /settings`.
 *
 * A save names either one section (`section` plus `data`) or several at once
 * (`sections`), because the settings screen saves the tab it is on and the
 * wizard saves whatever the step collected. Both forms end in the same place,
 * `Controller::save_sections()`, so the ordering and the rewrite bookkeeping
 * are written once.
 */
final class Settings {

	/**
	 * Argument schema of `PUT /settings`.
	 *
	 * The payloads are validated as objects and sanitized by `Options`, which
	 * is the only place that knows what each leaf of the schema may hold.
	 *
	 * @return array<string,array<string,mixed>> Argument schemas.
	 */
	public static function update_args(): array {
		return [
			'section'  => [
				'type'              => 'string',
				'required'          => false,
				'default'           => '',
				'maxLength'         => 64,
				'sanitize_callback' => 'sanitize_key',
				'validate_callback' => 'rest_validate_request_arg',
			],
			'data'     => Controller::object_arg(),
			'sections' => Controller::object_arg(),
		];
	}

	/**
	 * Answers with every setting.
	 *
	 * @return array<string,mixed> All settings.
	 */
	public function index(): array {
		return Options::all();
	}

	/**
	 * Saves one or more settings sections.
	 *
	 * @param WP_REST_Request $request The request.
	 * @return array<string,mixed>|WP_Error Keys `settings` and `flush_needed`, or a 400.
	 */
	public function update( WP_REST_Request $request ) {
		$sections = self::sections_from( $request );

		if ( [] === $sections ) {
			return new WP_Error(
				'acid_aeo_no_section',
				__( 'Send either a section and its data, or a sections object.', 'acid-aeo' ),
				[ 'status' => 400 ]
			);
		}

		return Controller::save_sections( $sections );
	}

	/**
	 * The sections a save request is asking for, in either accepted form.
	 *
	 * @param WP_REST_Request $request The request.
	 * @return array<string,mixed> Section name => raw section data.
	 */
	private static function sections_from( WP_REST_Request $request ): array {
		$sections = $request->get_param( 'sections' );
		$sections = is_array( $sections ) ? $sections : [];

		$section = (string) $request->get_param( 'section' );

		if ( '' !== $section ) {
			$data = $request->get_param( 'data' );

			$sections[ $section ] = is_array( $data ) ? $data : [];
		}

		return $sections;
	}
}