'ordered-primary-v4', 'images' => $vasp_image_hashes, ])); } /** Resolve the current ordered image set of one product or variation. */ function vasp_wc_image_sync_owner_records(int $vasp_id) { if (!vasp_wc_catalog_product_id_is_published($vasp_id)) { return []; } $vasp_product = wc_get_product($vasp_id); if (!$vasp_product instanceof WC_Product || !vasp_wc_catalog_product_is_published($vasp_product)) { if (vasp_wc_catalog_product_id_is_published($vasp_id)) { return vasp_wc_catalog_storage_error('image_owner_source_failed'); } return []; } $vasp_records = []; foreach (vasp_wc_image_sync_get_product_image_ids($vasp_product) as $vasp_position => $vasp_image_id) { $vasp_records[] = ['entityType' => 'product', 'entityId' => (string) $vasp_id, 'imageId' => (string) $vasp_image_id, 'position' => $vasp_position]; } return $vasp_records; } /** Resolve pending local owners without reading binary bodies. */ function vasp_wc_image_sync_pending_scope() { $vasp_rows = vasp_wc_catalog_all_pending_rows(true); if (is_wp_error($vasp_rows)) { return $vasp_rows; } $vasp_total = 0; foreach ($vasp_rows as $vasp_row) { $vasp_records = vasp_wc_image_sync_owner_records((int) $vasp_row['product_id']); if (is_wp_error($vasp_records)) { return $vasp_records; } $vasp_total += count($vasp_records); } return ['itemCount' => $vasp_total]; } /** Keep WordPress progress current; Gateway advances on each admitted image. */ function vasp_wc_image_sync_record_progress(int $vasp_received): void { if ($vasp_received > 0) { vasp_wc_catalog_add_image_progress($vasp_received); } } /** Inspect already resolved ordered owner records without sending image binaries. */ function vasp_wc_image_sync_inspect_owner_records(array $vasp_owner, array $vasp_records): array { $vasp_failures = []; $vasp_prepared = vasp_wc_image_sync_prepare_records($vasp_records, $vasp_failures); $vasp_transport_hashes = []; foreach ($vasp_prepared as $vasp_item) { $vasp_image_id = (string) $vasp_item['record']['imageId']; $vasp_transport_hashes[$vasp_image_id] = $vasp_item['hash']; } // Associative insertion order is the WooCommerce featured/gallery order. return [ // Version 4 persists explicit primary/secondary ownership on both the // canonical image row and its owning product reference. // Existing owners refresh exactly once; later unchanged scans remain stable. 'transport_hash' => vasp_wc_image_sync_owner_hash($vasp_transport_hashes), 'source_failures' => $vasp_failures, ]; } /** Resolve and inspect one versioned ordered owner state. */ function vasp_wc_image_sync_inspect_owner_state(array $vasp_owner) { $vasp_records = vasp_wc_image_sync_owner_records((int) $vasp_owner['product_id']); return is_wp_error($vasp_records) ? $vasp_records : vasp_wc_image_sync_inspect_owner_records($vasp_owner, $vasp_records); } /** Calculate one owner's current ordered image-set transport hash without sending it. */ function vasp_wc_image_sync_inspect_owner(array $vasp_owner) { $vasp_inspection = vasp_wc_image_sync_inspect_owner_state($vasp_owner); return is_wp_error($vasp_inspection) ? $vasp_inspection : $vasp_inspection['transport_hash']; } /** Prepare and send one bounded group of product-owned images. */ function vasp_wc_image_sync_process_owners(array $vasp_owners): array { $vasp_records = []; $vasp_hashes = []; $vasp_expected = []; $vasp_rejected = []; $vasp_unresolved = []; $vasp_settled = []; $vasp_processed_count = 0; foreach ($vasp_owners as $vasp_row) { $vasp_id = (int) $vasp_row['product_id']; $vasp_owner_records = vasp_wc_image_sync_owner_records($vasp_id); if (is_wp_error($vasp_owner_records)) { vasp_log('WC Catalog Sync: image owner skipped; remaining owners continue', 'warning', [ 'entity_type' => 'product', 'entity_id' => (string) $vasp_id, ]); $vasp_rejected[$vasp_id] = true; $vasp_settled[$vasp_id] = true; continue; } $vasp_records = array_merge($vasp_records, $vasp_owner_records); $vasp_hashes[$vasp_id] = []; $vasp_expected[$vasp_id] = count($vasp_owner_records); // An empty image set is already represented by the received product DTO. } $vasp_result = ''; foreach (array_chunk($vasp_records, VASP_WC_IMAGE_SYNC_CONCURRENCY) as $vasp_record_wave) { $vasp_source_failures = []; $vasp_prepared = vasp_wc_image_sync_prepare_records($vasp_record_wave, $vasp_source_failures); if ($vasp_source_failures) { vasp_wc_catalog_warn_image_sources($vasp_source_failures); } foreach ($vasp_source_failures as $vasp_failure) { $vasp_id = (int) $vasp_failure['record']['entityId']; $vasp_expected[$vasp_id] = max(0, $vasp_expected[$vasp_id] - 1); } $vasp_acknowledgements = []; $vasp_rejections = []; $vasp_wave_result = $vasp_prepared ? vasp_wc_image_sync_upload_prepared($vasp_prepared, $vasp_acknowledgements, $vasp_rejections) : true; foreach ($vasp_prepared as $vasp_index => $vasp_item) { $vasp_id = (int) $vasp_item['record']['entityId']; $vasp_image_id = (string) $vasp_item['record']['imageId']; if (!isset($vasp_acknowledgements[$vasp_index])) { if (isset($vasp_rejections[$vasp_index])) { $vasp_rejected[$vasp_id] = true; } else { $vasp_unresolved[$vasp_id] = true; } continue; } $vasp_hashes[$vasp_id][$vasp_image_id] = $vasp_item['hash']; } $vasp_processed_count += is_wp_error($vasp_wave_result) ? count($vasp_acknowledgements) + count($vasp_rejections) + count($vasp_source_failures) : count($vasp_record_wave); if (is_wp_error($vasp_wave_result)) { $vasp_result = $vasp_wave_result; break; } } foreach ($vasp_hashes as $vasp_id => $vasp_set) { if (isset($vasp_rejected[$vasp_id]) && !isset($vasp_unresolved[$vasp_id])) { // A terminal response settles this queue attempt, but it is not // canonical reception evidence. Preserve the owner's last complete // baseline instead of replacing it with an accepted subset. $vasp_settled[$vasp_id] = true; unset($vasp_hashes[$vasp_id]); continue; } if (count($vasp_set) !== $vasp_expected[$vasp_id]) { unset($vasp_hashes[$vasp_id]); continue; } // Preserve the acknowledged source order in the owner-level bundle hash. $vasp_hashes[$vasp_id] = vasp_wc_image_sync_owner_hash($vasp_set); } return ['hashes' => $vasp_hashes, 'settled' => array_keys($vasp_settled), 'rejected' => array_keys($vasp_rejected), 'processed_count' => $vasp_processed_count, 'failure' => is_wp_error($vasp_result) ? $vasp_result : null]; } function vasp_wc_image_sync_execute_scheduler_service() { if (!vasp_wc_catalog_push_enabled() || !vasp_wc_catalog_active() || get_option(VASP_OPTION_WC_CATALOG_STEP, '') !== 'images') { return ['pending' => false]; } try { $vasp_result = vasp_wc_image_sync_run_one_bounded_unit_now(); } catch (Throwable $vasp_exception) { $vasp_result = vasp_wc_catalog_storage_error('image_worker_exception'); } if (is_wp_error($vasp_result)) { $vasp_retryable = vasp_wc_catalog_failure_is_retryable_delivery($vasp_result); vasp_wc_catalog_report_worker_error( 'woocommerce_images', $vasp_result, (string) get_option(VASP_OPTION_WC_CATALOG_STEP, '') ); return $vasp_retryable ? vasp_wc_catalog_delivery_waiting(vasp_wc_catalog_retry_after_seconds($vasp_result)) : vasp_wc_catalog_fail($vasp_result); } if (is_array($vasp_result) && ($vasp_result['status'] ?? '') === 'waiting') { return $vasp_result; } return ['pending' => vasp_wc_catalog_active() && get_option(VASP_OPTION_WC_CATALOG_STEP, '') === 'images']; } function vasp_wc_image_sync_run_one_bounded_unit_now() { // A hook's newer source facts precede its dependent images in the same feeds. $vasp_pending_mode = get_option(VASP_OPTION_WC_CATALOG_PENDING_MODE, '') !== '' ? vasp_wc_catalog_take_pending_mode() : ''; if (is_wp_error($vasp_pending_mode)) { return $vasp_pending_mode; } $vasp_products = $vasp_pending_mode === '' ? vasp_wc_catalog_pending_rows(false, 1) : []; if (is_wp_error($vasp_products)) { return $vasp_products; } if ($vasp_pending_mode !== '' || $vasp_products) { $vasp_next = $vasp_pending_mode !== '' ? vasp_wc_catalog_step_for_mode($vasp_pending_mode) : 'prepare_products'; update_option(VASP_OPTION_WC_CATALOG_STEP, $vasp_next, false); $vasp_restart = $vasp_pending_mode !== ''; vasp_wc_catalog_signal_step($vasp_next, $vasp_restart); return vasp_scheduler_request_service('woocommerce_catalog', true) ? true : vasp_wc_catalog_storage_error('catalog_handoff_failed'); } $vasp_rows = vasp_wc_catalog_pending_rows(true, VASP_WC_IMAGE_SYNC_CONCURRENCY); if (is_wp_error($vasp_rows)) { return $vasp_rows; } $vasp_ready = []; foreach ($vasp_rows as $vasp_row) { if ($vasp_row['hash'] === '' || $vasp_row['action'] !== '') { return vasp_wc_catalog_storage_error('image_owner_not_ready'); } $vasp_ready[] = $vasp_row; } if ($vasp_ready) { $vasp_result = vasp_wc_image_sync_process_owners($vasp_ready); foreach ($vasp_ready as $vasp_row) { $vasp_id = (int) $vasp_row['product_id']; if (!isset($vasp_result['hashes'][$vasp_id])) { continue; } // The owner baseline describes the exact ordered image bytes submitted. if (!vasp_wc_catalog_receive_product($vasp_row, $vasp_result['hashes'][$vasp_id], true)) { return vasp_wc_catalog_storage_error('image_acknowledgement_not_saved'); } } $vasp_settled = array_fill_keys($vasp_result['settled'] ?? [], true); foreach ($vasp_ready as $vasp_row) { $vasp_id = (int) $vasp_row['product_id']; if (!isset($vasp_settled[$vasp_id])) { continue; } if (!vasp_wc_catalog_settle_image_attempt($vasp_row)) { return vasp_wc_catalog_storage_error('image_action_not_settled'); } } $vasp_processed_count = max(0, (int) ($vasp_result['processed_count'] ?? 0)); vasp_wc_image_sync_record_progress($vasp_processed_count); if (!empty($vasp_result['rejected'])) { vasp_wc_catalog_warn_image_rejections($vasp_result['rejected']); } if ($vasp_result['failure'] instanceof WP_Error) { return $vasp_result['failure']; } } if ($vasp_rows) { return true; } return vasp_wc_catalog_complete_delivery(); }