<?php
/**
 * WooCommerce Plugin Framework
 *
 * This source file is subject to the GNU General Public License v3.0
 * that is bundled with this package in the file license.txt.
 * It is also available through the world-wide-web at this URL:
 * http://www.gnu.org/licenses/gpl-3.0.html
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@skyverge.com so we can send you a copy immediately.
 *
 * DISCLAIMER
 *
 * Do not edit or add to this file if you wish to upgrade the plugin to newer
 * versions in the future. If you wish to customize the plugin for your
 * needs please refer to http://www.skyverge.com
 *
 * @package   SkyVerge/WooCommerce/Plugin/Classes
 * @author    SkyVerge
 * @copyright Copyright (c) 2013-2026, SkyVerge, Inc.
 * @license   http://www.gnu.org/licenses/gpl-3.0.html GNU General Public License v3.0
 */

namespace SkyVerge\WooCommerce\PluginFramework\v6_2_0\Abilities\Contracts;

use WP_REST_Request;

/**
 * Contract for adapting REST request input before passing it to an ability's execute callback.
 *
 * Implement this interface to transform or reshape the incoming {@see \WP_REST_Request}
 * parameters into the format expected by the ability.
 *
 * @since 6.2.0
 */
interface RestInputAdapterContract
{
    /**
     * Transforms REST request parameters into the format expected by the ability's execute callback.
     *
     * @since 6.2.0
     *
     * @param WP_REST_Request $request the incoming REST request
     * @return mixed the adapted input to pass to the ability's execute callback
     */
    public function adapt(WP_REST_Request $request);
}
