<?php
/**
 * @package PlugixaCrm
 */

declare( strict_types = 1 );

namespace PlugixaCrm\Core\Http;

use PlugixaCrm\Core\Examples\Seeder;
use WP_Error;
use WP_REST_Request;
use WP_REST_Response;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * The example content: what is still there, and put back what is not.
 *
 * WHY THERE IS A BUTTON AT ALL. The examples are seeded on activation, and WordPress does not fire
 * an activation hook when a plugin is updated by file copy — which is every real update. So a site
 * that installed before this feature existed would never see the examples, and a user who deleted
 * one would have to deactivate and reactivate the whole CRM to get it back. One click is a better
 * answer than either.
 *
 * `manage_options`, not the CRM's own capability: this writes into four modules' tables at once,
 * which is site configuration rather than record work. It matches the reasoning
 * `DashboardsController` already applies to authoring a dashboard template.
 */
final class ExamplesController extends RestController {

	public function __construct( private readonly Seeder $seeder ) {}

	/**
	 * Not a real entity — nothing registers `example`, and nothing should.
	 *
	 * `RestController` requires the method for its ACL helpers; this controller uses none of them,
	 * because both routes are gated on `manage_options` instead.
	 */
	protected function entity_type(): string {
		return 'example';
	}

	/**
	 * @param WP_REST_Request $request The request.
	 */
	public function can_administer( WP_REST_Request $request ): bool|WP_Error {
		unset( $request );

		return current_user_can( 'manage_options' ) ? true : $this->forbidden();
	}

	public function register_routes(): void {
		register_rest_route(
			$this->namespace,
			'/examples',
			array(
				array(
					'methods'             => 'GET',
					'callback'            => array( $this, 'index' ),
					'permission_callback' => array( $this, 'can_administer' ),
				),
			)
		);

		register_rest_route(
			$this->namespace,
			'/examples/restore',
			array(
				array(
					'methods'             => 'POST',
					'callback'            => array( $this, 'restore' ),
					'permission_callback' => array( $this, 'can_administer' ),
				),
			)
		);
	}

	/**
	 * How many examples of each kind are present, and how many are missing.
	 *
	 * @param WP_REST_Request $request The request.
	 */
	public function index( WP_REST_Request $request ): WP_REST_Response|WP_Error {
		unset( $request );

		return $this->ok( $this->seeder->status() );
	}

	/**
	 * Put back everything that is missing.
	 *
	 * Answers with the fresh status as well as the counts, so the panel never has to make a second
	 * request to redraw itself, and so "restored 0" is visibly the same thing as "nothing missing"
	 * rather than looking like a failure.
	 *
	 * @param WP_REST_Request $request The request.
	 */
	public function restore( WP_REST_Request $request ): WP_REST_Response|WP_Error {
		unset( $request );

		$restored = $this->seeder->restore();

		return $this->ok(
			array(
				'restored' => $restored,
				'total'    => array_sum( $restored ),
				'status'   => $this->seeder->status(),
			)
		);
	}
}