<?php

declare( strict_types=1 );

namespace AcezSeo\Data;

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

/**
 * Onboarding wizard state (M41): a thin flag over the existing repositories
 * (`GlobalSettingsRepository`, `SettingsRepository`) the wizard's own steps
 * write to — this option holds ONLY wizard progress/state, never a copy of
 * the actual settings, so there is no second source of truth to drift.
 */
final class OnboardingRepository implements OnboardingRepositoryInterface
{
	private const OPTION_NAME = 'acez_seo_onboarding';

	public const STATUSES = array( 'new', 'in_progress', 'completed', 'skipped' );

	public const SITE_TYPES = array( 'personal_blog', 'company', 'local_business', 'shop' );

	/**
	 * @return array{status: string, last_step: int, site_type: string}
	 */
	public function get(): array
	{
		$stored = get_option( self::OPTION_NAME, array() );

		/** @var array{status: string, last_step: int, site_type: string} */
		return wp_parse_args( is_array( $stored ) ? $stored : array(), self::defaults() );
	}

	/**
	 * @param array<string, mixed> $data
	 */
	public function update( array $data ): bool
	{
		$merged = wp_parse_args( $data, $this->get() );

		return update_option(
			self::OPTION_NAME,
			array(
				'status'    => in_array( $merged['status'], self::STATUSES, true ) ? $merged['status'] : 'new',
				'last_step' => absint( $merged['last_step'] ),
				'site_type' => in_array( $merged['site_type'], self::SITE_TYPES, true ) ? $merged['site_type'] : '',
			)
		);
	}

	/**
	 * @return array{status: string, last_step: int, site_type: string}
	 */
	private static function defaults(): array
	{
		return array(
			'status'    => 'new',
			'last_step' => 0,
			'site_type' => '',
		);
	}
}