<?php
/**
 * @package     MefisAssetBridge
 * @subpackage  Joomla_System_Plugin
 *
 * @copyright   Copyright (C) 2025 Goran Usljebrka. All rights reserved.
 * @license     Proprietary — No resale or incorporation into other projects without explicit written permission. see LICENSE.txt
 */

namespace Mefi\Plugin\System\MefisAssetBridge\Ajax;

defined('_JEXEC') or die;

use Joomla\CMS\Input\Input;
use MefisAssetBridgeCore\Api\ApiFactory;

/**
 * Interface for AJAX handlers
 *
 * @since  1.0.0
 */
interface HandlerInterface
{
    /**
     * Execute the handler
     *
     * @param   ApiFactory  $apiFactory  The API factory
     * @param   Input       $input       Input object
     *
     * @return  array       Response data
     *
     * @throws  \Exception  On error
     */
    public function execute(ApiFactory $apiFactory, Input $input): array;
}