<?php
/**
 * Migration phase: bulk pivot text-only meta groups via INSERT … SELECT.
 *
 * @package TMDO
 * @since 3.0.1
 */

declare(strict_types=1);

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

/**
 * Iterates all registered groups for the entity type and pivots each
 * text-only group in a single INSERT … SELECT … ON DUPLICATE KEY UPDATE.
 */
class TMDO_Phase_Backfill_Bulk extends TMDO_Migration_Phase_Base {

	/**
	 * Returns the phase slug.
	 *
	 * @return string
	 */
	public function name(): string {
		return 'backfill_bulk';
	}

	/**
	 * Executes the phase.
	 *
	 * @param array $job Job array (by reference).
	 * @return array{status: string}
	 * @throws \RuntimeException On DB pivot failure.
	 */
	public function execute( array &$job ): array {
		if ( ! empty( $job['options']['dry_run'] ) ) {
			$this->log( $job, '↪ Backfill bulk skipped (dry_run)' );
			return array( 'status' => 'ok' );
		}

		$total_groups = 0;
		$total_rows   = 0;

		foreach ( TMDO_Entity_Registry::get_groups_for_type( $this->entity_type ) as $group ) {
			if ( $this->group_has_json_field( $group ) ) {
				continue; // Handled in backfill_unserialize.
			}
			$rows        = $this->execute_bulk_pivot( $group );
			$total_rows += $rows;
			++$total_groups;
			$this->log( $job, sprintf( '  • bulk pivot %s: %d row(s)', $group, $rows ) );
		}

		$this->log( $job, sprintf( 'Bulk backfill: %d groups, %d rows total', $total_groups, $total_rows ) );

		$preflight                      = TMDO_Migration_Orchestrator::preflight();
		$job['metrics']['eav_rows_now'] = $preflight['eav_rows'];
		$job['metrics']['ratio_now']    = $preflight['ratio'];

		return array( 'status' => 'ok' );
	}
}