<?php
/**
 * Data migrations.
 *
 * @package Extrova
 */

declare( strict_types=1 );

namespace Extrova\Core;

defined( 'ABSPATH' ) || exit;

/**
 * Idempotent schema migrations for the stored extras and the installed version.
 *
 * @since 1.0.0
 */
final class Migrations {

	public const SCHEMA_VERSION = 1;

	public const VERSION_OPTION = 'extrova_version';

	/**
	 * Brings stored extras data to the current schema. Pure function, safe to run many times.
	 *
	 * @param array $data Stored data (may be empty).
	 */
	public static function migrate_extras_data( array $data ): array {
		$extras = isset( $data['extras'] ) && is_array( $data['extras'] ) ? $data['extras'] : array();

		// Future steps go here: if ( $version < 2 ) { ... }.
		return array(
			'schema_version' => self::SCHEMA_VERSION,
			'revision'       => isset( $data['revision'] ) ? (int) $data['revision'] : 0,
			'extras'         => array_values( array_filter( $extras, 'is_array' ) ),
		);
	}

	/**
	 * Runs on `admin_init`: persists migrations and records the installed version.
	 */
	public function maybe_run(): void {
		$raw = get_option( OptionExtraRepository::OPTION, null );
		if ( null === $raw || false === $raw ) {
			add_option( OptionExtraRepository::OPTION, self::migrate_extras_data( array() ), '', false );
		} elseif ( is_array( $raw ) ) {
			$migrated = self::migrate_extras_data( $raw );
			if ( $migrated !== $raw ) {
				update_option( OptionExtraRepository::OPTION, $migrated, false );
			}
		}

		if ( false === get_option( SettingsRepository::OPTION, false ) ) {
			add_option( SettingsRepository::OPTION, Schema::default_settings(), '', false );
		}

		if ( get_option( self::VERSION_OPTION, '' ) !== EXTROVA_VERSION ) {
			update_option( self::VERSION_OPTION, EXTROVA_VERSION, false );
		}
	}
}