<?php
/**
 * Contact Form 7: forms and submissions.
 *
 * @package ActivityLog404
 */

namespace ActivityLog404\Events\Integrations;

use ActivityLog404\Events\Integrations;

defined( 'ABSPATH' ) || exit;

/**
 * A Contact Form 7 form is a `wpcf7_contact_form` post, saved through
 * `wp_insert_post()`/`wp_update_post()` in `WPCF7_ContactForm::save()`, so
 * the post events see it -- now logged as the form ({@see PostChanges}). The
 * form's template, mail settings and messages are post meta written AFTER
 * that post save, so a change only to them reads as an update with no field
 * diff; what changed inside the template is not compared (a named deferral).
 *
 * A submission is `wpcf7_submit( $contact_form, $result )`, fired after
 * every processed submission; logged only for `mail_sent` and `mail_failed`
 * (the mail outcome in details) -- never `spam`, `validation_failed`,
 * `acceptance_missing` or `aborted`. CF7 keeps no entries. Read in Contact
 * Form 7's source (6.2.2, 15 Oct 2026).
 */
final class ContactForm7 implements Integration {

	public const PLUGIN = 'contact-form-7';

	public static function is_active(): bool {
		return Integrations::enabled( self::PLUGIN, defined( 'WPCF7_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( 'wpcf7_submit', array( __CLASS__, 'log_submission' ), 10, 2 );
	}

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

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

	/**
	 * `wpcf7_submit`.
	 *
	 * @param mixed $contact_form The WPCF7_ContactForm.
	 * @param mixed $result       The submission result.
	 */
	public static function log_submission( $contact_form, $result ): void {
		$status = is_array( $result ) && isset( $result['status'] ) ? (string) $result['status'] : '';
		if ( ! in_array( $status, array( 'mail_sent', 'mail_failed' ), true ) ) {
			return;
		}

		if ( ! is_object( $contact_form ) || ! method_exists( $contact_form, 'id' ) ) {
			return;
		}

		$title = method_exists( $contact_form, 'title' ) ? (string) $contact_form->title() : '';

		Forms::submitted( self::PLUGIN, 'Contact form', (int) $contact_form->id(), $title, 0, array( 'mail' => 'mail_sent' === $status ? 'sent' : 'failed' ) );
	}
}