<?php
namespace Consiva\Consent\Integrations\Forms;

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

/**
 * A form plugin the consent opt-in can be added to (Plugin §10.1).
 *
 * Adapters are discovered at runtime and never assumed present. A new form plugin needs a new
 * adapter class registered through the "consiva_consent_form_adapters" filter, and no change to core.
 */
interface AdapterInterface {

	/**
	 * Stable ID stored in settings and sent as form_plugin, e.g. "contact-form-7".
	 *
	 * @return string
	 */
	public function id();

	/**
	 * Name shown to the admin.
	 *
	 * @return string
	 */
	public function label();

	/**
	 * Whether the form plugin is installed and active.
	 *
	 * @return bool
	 */
	public function is_available();

	/**
	 * The form plugin's version, for diagnostics.
	 *
	 * @return string
	 */
	public function version();

	/**
	 * Forms the admin can add the opt-in to.
	 *
	 * @return array<int,array{id:int,title:string}>
	 */
	public function discover_forms();

	/**
	 * Adds the opt-in to enabled forms and records it on submission (via ServerConsent).
	 *
	 * @return void
	 */
	public function register_hooks();
}