MokoSuiteClient/source/packages/com_mokosuiteclient/api/src/Controller/ResetController.php

<?php
/**
 * @package     MokoSuiteClient
 * @subpackage  com_mokosuiteclient
 * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
 * @license     GNU General Public License version 3 or later; see LICENSE
 */

namespace Moko\Component\MokoSuiteClient\Api\Controller;

defined('_JEXEC') or die;

use Joomla\CMS\Factory;
use Joomla\CMS\MVC\Controller\BaseController;
use Joomla\CMS\Plugin\PluginHelper;
use Joomla\Registry\Registry;

/**
 * Demo site reset API controller.
 *
 * POST /api/index.php/v1/mokosuiteclient/reset
 * Body: {"baseline": "default"}
 *
 * Restores the site to a named baseline snapshot.
 * Requires a Joomla API token with core.manage on com_plugins.
 *
 * @since  02.21.00
 */
class ResetController extends BaseController
{
	/**
	 * Restore site to a baseline snapshot.
	 *
	 * @return  void
	 *
	 * @since   02.21.00
	 */
	public function execute($task = 'reset'): void
	{
		$app = Factory::getApplication();

		if ($app->input->getMethod() !== 'POST')
		{
			$this->sendJson(405, ['error' => 'POST required']);
			return;
		}

		$user = $app->getIdentity();

		if (!$user->authorise('core.manage', 'com_plugins'))
		{
			$this->sendJson(403, ['error' => 'Not authorized']);
			return;
		}

		$plugin = PluginHelper::getPlugin('system', 'mokosuiteclient');

		if (!$plugin)
		{
			$this->sendJson(503, ['error' => 'MokoSuiteClient system plugin not enabled']);
			return;
		}

		$params = new Registry($plugin->params);

		try
		{
			$service = $this->createService($params);
			$result  = $service->restoreSnapshot('default');

			$this->sendJson(200, $result);
		}
		catch (\Throwable $e)
		{
			$this->sendJson(500, [
				'error'   => 'Reset failed',
				'message' => $e->getMessage(),
			]);
		}
	}

	/**
	 * Create DemoResetService from plugin params.
	 *
	 * @param   Registry  $params  Plugin parameters
	 *
	 * @return  \Moko\Plugin\System\MokoSuiteClient\Service\DemoResetService
	 *
	 * @since   02.21.00
	 */
	private function createService(Registry $params)
	{
		$serviceFile = JPATH_PLUGINS . '/task/mokosuiteclientdemo/src/Service/DemoResetService.php';

		if (!file_exists($serviceFile))
		{
			throw new \RuntimeException('DemoResetService not found — is the demo reset plugin installed?');
		}

		require_once $serviceFile;

		$media = (bool) $params->get('demo_snapshot_include_media', 1);

		return new \Moko\Plugin\Task\MokoSuiteClientDemo\Service\DemoResetService($media);
	}

	/**
	 * @param   int    $code     HTTP status code
	 * @param   array  $payload  Response data
	 * @return  void
	 */
	private function sendJson(int $code, array $payload): void
	{
		$app = Factory::getApplication();
		$app->setHeader('Content-Type', 'application/json', true);
		$app->setHeader('Status', (string) $code, true);
		echo json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT);
		$app->close();
	}
}