<?php
/**
 * Plugin Name: AI Semantic Handshake
 * Plugin URI:  https://aeosub.com/ai-semantic-handshake/
 * Description: Facilitates a semantic "handshake" between partner websites using JSON-LD Schema to establish E-E-A-T signals for AI search engines.
 * Version:     3.2.2
 * Requires at least: 6.0
 * Requires PHP: 7.4
 * Author:      LethaldiranMX
 * Author URI:  https://aeosub.com
 * License:     GPLv2 or later
 * License URI: https://www.gnu.org/licenses/gpl-2.0.html
 * Text Domain: ai-semantic-handshake
 * Domain Path: /languages
 */

// Exit if accessed directly.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

// Define Plugin Constants.
define( 'AISH_VERSION', '3.2.1' );
define( 'AISH_PLUGIN_DIR', plugin_dir_path( __FILE__ ) );
define( 'AISH_PLUGIN_URL', plugin_dir_url( __FILE__ ) );
define( 'AISH_FILE', __FILE__ );
if ( ! defined( 'AISH_ENABLE_HISTORY_TAB' ) ) {
	define( 'AISH_ENABLE_HISTORY_TAB', false );
}

/**
 * Plugin activation handler.
 * Generates and stores the site secret if it doesn't exist.
 */
function aish_activate() {
	if ( ! get_option( 'aish_site_secret' ) ) {
		update_option( 'aish_site_secret', wp_generate_password( 32, true, true ) );
	}

	if ( ! aish_migrate_partner_relation_fields() ) {
		update_option( 'aish_relation_migration_pending', 1, false );
	}
}
register_activation_hook( __FILE__, 'aish_activate' );

/**
 * Sanitize relation type during activation-time migrations.
 *
 * @param string $value Raw value.
 * @return string
 */
function aish_sanitize_relation_type_value( $value ) {
	$allowed = array(
		'collaboration',
		'client',
		'vendor',
		'sister_site',
		'media_mention',
		'friendly_recommendation',
		'strategic_partner',
		'community_peer',
	);
	$value = sanitize_key( (string) $value );
	return in_array( $value, $allowed, true ) ? $value : 'collaboration';
}

/**
 * Ensure all partners contain v3 relation fields with defaults.
 *
 * @return bool True if migration executed, false if dependencies are not ready.
 */
function aish_migrate_partner_relation_fields() {
	$can_use_store = class_exists( 'AISH_Partner_Store' );
	if (
		! $can_use_store &&
		(
			! function_exists( 'carbon_get_theme_option' ) ||
			! function_exists( 'carbon_set_theme_option' ) ||
			0 === did_action( 'carbon_fields_fields_registered' )
		)
	) {
		return false;
	}

	$partners = $can_use_store
		? AISH_Partner_Store::get_all()
		: carbon_get_theme_option( 'aish_partners' );
	if ( ! is_array( $partners ) ) {
		update_option( 'aish_data_version', AISH_VERSION, false );
		delete_option( 'aish_relation_migration_pending' );
		return true;
	}

	$changed = false;

	foreach ( $partners as &$partner ) {
		if ( ! is_array( $partner ) ) {
			continue;
		}

		$legacy_relation_note = isset( $partner['my_relation_note'] ) ? sanitize_textarea_field( (string) $partner['my_relation_note'] ) : '';
		$legacy_partner_claim = isset( $partner['partner_claim_note'] ) ? sanitize_textarea_field( (string) $partner['partner_claim_note'] ) : '';

		$my_relation = isset( $partner['my_relation_to_partner'] ) ? $partner['my_relation_to_partner'] : 'collaboration';
		$partner_relation = isset( $partner['partner_relation_to_me'] ) ? $partner['partner_relation_to_me'] : 'collaboration';

		$normalized_my_relation      = aish_sanitize_relation_type_value( $my_relation );
		$normalized_partner_relation = aish_sanitize_relation_type_value( $partner_relation );
		$relation_note               = isset( $partner['relation_note'] ) ? sanitize_textarea_field( (string) $partner['relation_note'] ) : $legacy_relation_note;
		$partner_claim              = isset( $partner['partner_claim'] ) ? sanitize_textarea_field( (string) $partner['partner_claim'] ) : $legacy_partner_claim;

		if ( ! isset( $partner['my_relation_to_partner'] ) || $partner['my_relation_to_partner'] !== $normalized_my_relation ) {
			$partner['my_relation_to_partner'] = $normalized_my_relation;
			$changed = true;
		}
		if ( ! isset( $partner['partner_relation_to_me'] ) || $partner['partner_relation_to_me'] !== $normalized_partner_relation ) {
			$partner['partner_relation_to_me'] = $normalized_partner_relation;
			$changed = true;
		}
		if ( ! isset( $partner['relation_note'] ) || $partner['relation_note'] !== $relation_note ) {
			$partner['relation_note'] = substr( $relation_note, 0, 240 );
			$changed = true;
		}
		if ( ! isset( $partner['partner_claim'] ) || $partner['partner_claim'] !== $partner_claim ) {
			$partner['partner_claim'] = substr( $partner_claim, 0, 240 );
			$changed = true;
		}
	}
	unset( $partner );

	if ( $changed ) {
		if ( $can_use_store ) {
			AISH_Partner_Store::set_all( $partners );
		} else {
			carbon_set_theme_option( 'aish_partners', $partners );
		}
	} elseif ( $can_use_store ) {
		// Ensure canonical store is initialized even when no relation-field rewrite is needed.
		AISH_Partner_Store::set_all( $partners );
	}

	update_option( 'aish_data_version', AISH_VERSION, false );
	delete_option( 'aish_relation_migration_pending' );
	return true;
}

/**
 * Plugin deactivation handler.
 * Clears scheduled cron events.
 */
function aish_deactivate() {
	wp_clear_scheduled_hook( 'aish_daily_verification' );
	wp_clear_scheduled_hook( 'aish_retry_pending_sync' );
}
register_deactivation_hook( __FILE__, 'aish_deactivate' );

/**
 * Boot the plugin.
 */
function aish_boot_plugin() {
	// Check for Composer autoloader.
	if ( file_exists( AISH_PLUGIN_DIR . 'vendor/autoload.php' ) ) {
		require_once AISH_PLUGIN_DIR . 'vendor/autoload.php';
	} else {
		add_action( 'admin_notices', function() {
			?>
			<div class="notice notice-error">
				<p>
					<?php
					$message = __( 'AI Semantic Handshake requires Composer dependencies. Please run <code>composer install</code> in the plugin directory.', 'ai-semantic-handshake' );
					echo wp_kses( $message, array( 'code' => array() ) );
					?>
				</p>
			</div>
			<?php
		} );
		return;
	}

	// Boot Carbon Fields.
	\Carbon_Fields\Carbon_Fields::boot();

	// Initialize the main plugin class.
	require_once AISH_PLUGIN_DIR . 'includes/class-ai-semantic-handshake.php';
	AISH_AI_Semantic_Handshake::instance();
}

add_action( 'plugins_loaded', 'aish_boot_plugin', 20 );

/**
 * Suggest privacy policy content for the site privacy policy page.
 */
function aish_add_privacy_policy_content() {
	if ( ! function_exists( 'wp_add_privacy_policy_content' ) ) {
		return;
	}

	$content = __( 'This plugin exchanges site identity data (site URL, site name, and a public identifier) with partner websites that the site administrator explicitly configures. No visitor personal data is collected, stored, or transmitted by this plugin. Email invitations, when used, are sent only to addresses manually entered by the administrator.', 'ai-semantic-handshake' );

	wp_add_privacy_policy_content( 'AI Semantic Handshake', wp_kses_post( $content ) );
}
add_action( 'admin_init', 'aish_add_privacy_policy_content' );

/**
 * Run deferred migrations once Carbon Fields is fully registered.
 */
function aish_run_deferred_migrations() {
	$current_data_version = get_option( 'aish_data_version', '0.0.0' );
	$pending              = get_option( 'aish_relation_migration_pending', false );

	if ( $pending || version_compare( $current_data_version, AISH_VERSION, '<' ) ) {
		aish_migrate_partner_relation_fields();
	}
}
add_action( 'carbon_fields_fields_registered', 'aish_run_deferred_migrations', 20 );