<?php
/**
 * Elementor: a document saved in the editor, as one row.
 *
 * @package ActivityLog404
 */

namespace ActivityLog404\Events\Integrations;

use ActivityLog404\EventLogger;
use ActivityLog404\Events\Integrations;

defined( 'ABSPATH' ) || exit;

/**
 * Read in Elementor's source (4.4.0, 15 Oct 2026, `Core\Base\Document::save()`):
 * `elementor/document/before_save( $document, $data )`, then up to three
 * `wp_update_post()` calls (the page settings' title/excerpt, its status, and
 * the plain-text copy of the layout in `post_content`), then
 * `elementor/document/after_save( $document, $data )`. Logged as post events
 * that one Publish click was up to three `post_updated` rows.
 *
 * So the save CLAIMS its post ({@see PostChanges::claim()}) on before_save;
 * the post's update rows are absorbed while it is held, and after_save writes
 * ONE `elementor_document_saved` row carrying their merged diff (title,
 * status, content length) and the document type. The site-wide kit (global
 * colours, fonts, layout) is a document too, saved the same way, and its row
 * reads "Elementor site settings saved". The editor's autosave (a revision
 * document) is not logged. Elementor's own settings screens
 * (`elementor_*` options) are a named deferral.
 */
final class Elementor implements Integration {

	public const PLUGIN = 'elementor';

	public const SAVED = 'elementor_document_saved';

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

	public static function event_types(): array {
		return array( self::SAVED => 'Elementor Document Saved' );
	}

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

		add_action( 'elementor/document/before_save', array( __CLASS__, 'before_save' ) );
		add_action( 'elementor/document/after_save', array( __CLASS__, 'after_save' ) );
	}

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

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

	/**
	 * @param mixed $document The Elementor document.
	 */
	public static function before_save( $document ): void {
		$id = self::post_id( $document );
		if ( $id > 0 && ! self::is_autosave( $document, $id ) ) {
			PostChanges::claim( $id );
		}
	}

	/**
	 * @param mixed $document The Elementor document.
	 */
	public static function after_save( $document ): void {
		$id = self::post_id( $document );
		if ( $id <= 0 || self::is_autosave( $document, $id ) ) {
			return;
		}

		$diff = PostChanges::release( $id ) ?? array();
		$type = is_object( $document ) && method_exists( $document, 'get_name' ) ? sanitize_key( (string) $document->get_name() ) : '';
		$post = get_post( $id );

		$summary = 'kit' === $type
			? 'Elementor site settings saved'
			: sprintf( 'Elementor %1$s "%2$s" saved', $post ? (string) $post->post_type : 'document', $post ? EventLogger::bounded( (string) $post->post_title, 200 ) : '#' . $id );

		EventLogger::log(
			self::SAVED,
			$summary,
			$post ? (string) $post->post_type : 'post',
			$id,
			array(
				'plugin'        => self::PLUGIN,
				'document_type' => $type,
			) + $diff
		);
	}

	/**
	 * Whether the save is the editor's autosave: the document's own post is
	 * a revision of the main one, not the main one. Autosaves run every
	 * minute while the editor is open and change nothing published; they are
	 * not logged.
	 *
	 * @param mixed $document The Elementor document.
	 * @param int   $main_id  Its main post id.
	 */
	public static function is_autosave( $document, int $main_id ): bool {
		if ( ! is_object( $document ) || ! method_exists( $document, 'get_post' ) ) {
			return false;
		}

		$post = $document->get_post();

		return is_object( $post ) && isset( $post->ID ) && (int) $post->ID !== $main_id;
	}

	/**
	 * The post a document saves to: its main id (a revision or autosave
	 * resolves to the post it belongs to).
	 *
	 * @param mixed $document The Elementor document.
	 */
	public static function post_id( $document ): int {
		if ( ! is_object( $document ) || ! method_exists( $document, 'get_main_id' ) ) {
			return 0;
		}

		$id = $document->get_main_id();

		return is_numeric( $id ) ? (int) $id : 0;
	}
}