<?php
/**
 * Core module bootstrap.
 *
 * Owns shared storage, HTTP safety and settings used by every AI-O Optimiser
 * module. Keeping this layer dependency-light makes later product extraction
 * possible without duplicating database or request-safety code.
 */

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

require_once AI_O_Optimiser_PLUGIN_DIR . 'includes/class-ai-o-optimiser-http.php';
require_once AI_O_Optimiser_PLUGIN_DIR . 'includes/class-ai-o-optimiser-settings.php';
require_once AI_O_Optimiser_PLUGIN_DIR . 'includes/class-ai-o-optimiser-persistence.php';

/**
 * Load database/storage code only when the current request actually needs it.
 *
 * Ordinary public page views should not pay the parse/memory cost of storage
 * diagnostics, retention and migration code when no AI-O Optimiser activity is logged.
 *
 * @return void
 */
function ai_o_optimiser_core_load_db() {
	static $loaded = false;
	if ( $loaded ) {
		return;
	}

	require_once AI_O_Optimiser_PLUGIN_DIR . 'includes/class-ai-o-optimiser-db.php';
	$loaded = true;
}

/**
 * Install or upgrade shared core data.
 *
 * @return void
 */
function ai_o_optimiser_core_install() {
	ai_o_optimiser_core_load_db();
	AI_O_Optimiser_DB::create_table();

	if ( false === get_option( 'ai_o_optimiser_settings' ) ) {
		update_option( 'ai_o_optimiser_settings', AI_O_Optimiser_Settings::defaults() );
	} else {
		ai_o_optimiser_merge_default_settings();
	}
}

/**
 * Merge newly introduced defaults without overwriting deliberate choices.
 *
 * @return void
 */
function ai_o_optimiser_merge_default_settings() {
	$settings = get_option( 'ai_o_optimiser_settings', array() );
	$defaults = AI_O_Optimiser_Settings::defaults();
	$settings = wp_parse_args( $settings, $defaults );

	if ( empty( $settings['tracked_bots'] ) || ! is_array( $settings['tracked_bots'] ) ) {
		$settings['tracked_bots'] = $defaults['tracked_bots'];
	} else {
		foreach ( $defaults['tracked_bots'] as $slug => $enabled ) {
			if ( ! array_key_exists( $slug, $settings['tracked_bots'] ) ) {
				$settings['tracked_bots'][ $slug ] = $enabled;
			}
		}
	}

	update_option( 'ai_o_optimiser_settings', $settings );
}

/**
 * Retention/size guardrail wrapper for the daily cron hook.
 *
 * @return void
 */
function ai_o_optimiser_core_daily_cleanup() {
	ai_o_optimiser_core_load_db();
	AI_O_Optimiser_DB::cleanup_old_rows();
}

/**
 * Durable aggregate backfill wrapper for cron/external-cron execution.
 *
 * @return void
 */
function ai_o_optimiser_core_process_aggregate_backfill() {
	ai_o_optimiser_core_load_db();
	AI_O_Optimiser_DB::process_aggregate_backfill();
}

/*
 * The canonical component/compatibility layer is admin-only. Keep the class out
 * of ordinary public requests; the frontend pays only for this cheap branch.
 */
if ( is_admin() ) {
	require_once AI_O_Optimiser_PLUGIN_DIR . 'includes/class-ai-o-optimiser-admin-ui-system.php';
	AI_O_Optimiser_Admin_UI_System::boot();
}