<?php
/**
 * Migration status codes.
 *
 * @package Shiftora\Migration
 */

declare(strict_types=1);

namespace Shiftora\Migration;

// Prevent direct file access.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Lifecycle states of a migration job.
 */
enum MigrationStatus: string {
	case Pending    = 'pending';
	case Running    = 'running';
	case Paused     = 'paused';
	case Cancelling = 'cancelling';
	case Completed  = 'completed';
	case Failed     = 'failed';
	case Recovered  = 'recovered';
	case Cancelled  = 'cancelled';

	/**
	 * Returns a human-readable label.
	 */
	public function label(): string {
		return match ( $this ) {
			self::Pending    => __( 'Pending', 'shiftora' ),
			self::Running    => __( 'Running', 'shiftora' ),
			self::Paused     => __( 'Paused', 'shiftora' ),
			self::Cancelling => __( 'Canceling', 'shiftora' ),
			self::Completed  => __( 'Completed', 'shiftora' ),
			self::Failed     => __( 'Failed', 'shiftora' ),
			self::Recovered  => __( 'Restored', 'shiftora' ),
			self::Cancelled  => __( 'Canceled', 'shiftora' ),
		};
	}

	/**
	 * Returns whether the migration is in a terminal state.
	 */
	public function is_terminal(): bool {
		return in_array( $this, [ self::Completed, self::Failed, self::Recovered, self::Cancelled ], true );
	}

		/**
		 * Every terminal status as a string, for callers holding a database value.
		 *
		 * @return string[]
		 */
	public static function terminal_values(): array {
		return array_map(
			static fn( self $status ): string => $status->value,
			[ self::Completed, self::Failed, self::Recovered, self::Cancelled ]
		);
	}

	/**
	 * Returns the CSS badge variant for this status.
	 */
	public function badge_variant(): string {
		return match ( $this ) {
			self::Pending    => 'neutral',
			self::Running    => 'info',
			self::Paused     => 'warning',
			self::Cancelling => 'warning',
			self::Completed  => 'success',
			self::Failed     => 'danger',
			self::Recovered  => 'warning',
			self::Cancelled  => 'neutral',
		};
	}
}