<?php
/**
 * WPForms: forms and submissions.
 *
 * @package ActivityLog404
 */

namespace ActivityLog404\Events\Integrations;

use ActivityLog404\Events\Integrations;

defined( 'ABSPATH' ) || exit;

/**
 * A WPForms form is a `wpforms` post: the builder saves it through
 * `wp_update_post()` (`WPForms_Form_Handler::update()`), creates it through
 * `wp_insert_post()` and deletes it through `wp_delete_post()`, so the post
 * events see every change, now logged as the form ({@see PostChanges}) rather
 * than as a post. A submission is `wpforms_process_complete( $fields, $entry,
 * $form_data, $entry_id )`, fired only for a submission that passed
 * validation and was not stored as spam; `$entry_id` is 0 in WPForms Lite,
 * which keeps no entries. Read in WPForms Lite's source (2.0.2.2, 15 Oct
 * 2026). Entry management (WPForms Pro's entries screen) is a named deferral.
 */
final class WpForms implements Integration {

	public const PLUGIN = 'wpforms';

	public static function is_active(): bool {
		return Integrations::enabled( self::PLUGIN, defined( 'WPFORMS_VERSION' ) );
	}

	public static function event_types(): array {
		$types = Forms::event_types();
		unset( $types[ Forms::ENTRY_DELETED ], $types[ Forms::ENTRY_STATUS ] );

		return $types;
	}

	public static function register( ?bool $active = null ): void {
		if ( ! ( $active ?? self::is_active() ) ) {
			return;
		}

		add_action( 'wpforms_process_complete', array( __CLASS__, 'log_submission' ), 10, 4 );
	}

	public static function post_types(): array {
		return array( 'wpforms' => Forms::mapping( 'WPForms form', self::PLUGIN ) );
	}

	public static function internal_post_types(): array {
		return array();
	}

	/**
	 * `wpforms_process_complete`.
	 *
	 * @param mixed $fields    The submitted fields (never read).
	 * @param mixed $entry     The raw submission (never read).
	 * @param mixed $form_data The form's settings.
	 * @param mixed $entry_id  The stored entry (0 in Lite).
	 */
	public static function log_submission( $fields, $entry, $form_data, $entry_id = 0 ): void { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.FoundBeforeLastUsed -- the hook's signature; the field values are deliberately never read.
		if ( ! is_array( $form_data ) ) {
			return;
		}

		$form_id = isset( $form_data['id'] ) && is_numeric( $form_data['id'] ) ? (int) $form_data['id'] : 0;
		$title   = isset( $form_data['settings']['form_title'] ) && is_string( $form_data['settings']['form_title'] ) ? $form_data['settings']['form_title'] : '';

		Forms::submitted( self::PLUGIN, 'WPForms form', $form_id, $title, is_numeric( $entry_id ) ? (int) $entry_id : 0 );
	}
}