$payload Catalog payload. * @return array */ function vasp_wc_catalog_normalize_payload_for_hash(array $payload): array { if (array_key_exists('sku', $payload)) { unset( $payload['createdAt'], $payload['updatedAt'], $payload['status'], $payload['skuSource'], $payload['parentExternalId'] ); unset($payload['relatedIds']); $payload['upsellIds'] = vasp_wc_catalog_sort_hash_id_list($payload['upsellIds'] ?? []); $payload['crossSellIds'] = vasp_wc_catalog_sort_hash_id_list($payload['crossSellIds'] ?? []); $payload['variations'] = vasp_wc_catalog_sort_hash_id_list($payload['variations'] ?? []); $payload['categories'] = vasp_wc_catalog_sort_hash_payload_list($payload['categories'] ?? [], ['externalId', 'slug', 'name']); $payload['tags'] = vasp_wc_catalog_sort_hash_payload_list($payload['tags'] ?? [], ['externalId', 'slug', 'name']); $payload['brands'] = vasp_wc_catalog_sort_hash_payload_list($payload['brands'] ?? [], ['externalId', 'slug', 'name']); $payload['attributes'] = vasp_wc_catalog_sort_hash_attribute_list($payload['attributes'] ?? []); // Image order is catalog state: featured first, followed by gallery order. $payload['images'] = array_values($payload['images'] ?? []); $payload = vasp_wc_catalog_normalize_product_price_hash_fields($payload); } if (isset($payload['terms'])) { $payload['terms'] = vasp_wc_catalog_sort_hash_payload_list($payload['terms'], ['externalId', 'slug', 'name']); } unset($payload['taxonomy']); return vasp_wc_catalog_strip_processing_hash_fields($payload); } /** * Canonicalize product price fields before catalog hashing. * * WooCommerce and currency plugins can expose equivalent empty/numeric values * with different PHP types. Hashing the canonical price representation prevents * false product updates for values such as empty string versus null, or "60" * versus 60.0. * * @param array $payload Product payload. * @return array */ function vasp_wc_catalog_normalize_product_price_hash_fields(array $payload): array { $price = vasp_wc_catalog_normalize_hash_decimal_string($payload['price'] ?? null); $regular_price = vasp_wc_catalog_normalize_hash_decimal_string($payload['regularPrice'] ?? null); $sale_price = vasp_wc_catalog_normalize_hash_decimal_string($payload['salePrice'] ?? null); $payload['price'] = $price; $payload['regularPrice'] = $regular_price; $payload['salePrice'] = $sale_price; $payload['priceHtml'] = vasp_wc_catalog_hash_price_text($price, $regular_price, $sale_price); return $payload; } /** * Normalize decimal-like values for hash input. * * @param mixed $value Decimal-like value. * @return string|null */ function vasp_wc_catalog_normalize_hash_decimal_string($value): ?string { if ($value === '' || $value === null) { return null; } if (!is_numeric($value)) { return (string) $value; } return rtrim(rtrim(number_format((float) $value, 6, '.', ''), '0'), '.'); } /** * Build canonical price text for hash input from canonical price fields. * * @param string|null $price Price. * @param string|null $regular_price Regular price. * @param string|null $sale_price Sale price. * @return string */ function vasp_wc_catalog_hash_price_text(?string $price, ?string $regular_price, ?string $sale_price): string { if ($sale_price !== null && $regular_price !== null && $sale_price !== $regular_price) { return $regular_price . ' -> ' . $sale_price; } return $price ?? ''; } /** * Recursively remove local/server processing fields from hash input. * * @param mixed $value Payload value. * @return mixed */ function vasp_wc_catalog_strip_processing_hash_fields($value) { if (!is_array($value)) { return $value; } unset( $value['publicSrc'], $value['embeddingText'], $value['embedding'], $value['embeddingGeneratedAt'], $value['descriptionChecksum'], $value['syncChecksum'], $value['hasChanged'], $value['imageUploadedAt'], $value['taxonomy'] ); foreach ($value as $key => $child) { $value[$key] = vasp_wc_catalog_strip_processing_hash_fields($child); } return $value; } /** * Sort an ID list for order-insensitive hash comparison. * * @param mixed $ids Raw ID list. * @return array */ function vasp_wc_catalog_sort_hash_id_list($ids): array { $ids = is_array($ids) ? array_values(array_filter(array_map('strval', $ids), 'strlen')) : []; usort($ids, static function ($left, $right) { return strnatcmp($left, $right); }); return $ids; } /** * Sort a list of payload arrays by stable identity fields. * * @param mixed $items Raw payload list. * @param array $keys Sort keys in priority order. * @return array */ function vasp_wc_catalog_sort_hash_payload_list($items, array $keys): array { $items = is_array($items) ? array_values($items) : []; usort($items, static function ($left, $right) use ($keys) { $left = is_array($left) ? $left : []; $right = is_array($right) ? $right : []; foreach ($keys as $key) { $comparison = strnatcmp((string) ($left[$key] ?? ''), (string) ($right[$key] ?? '')); if ($comparison !== 0) { return $comparison; } } return 0; }); return $items; } /** * Sort product attributes and nested option lists for order-insensitive hashes. * * @param mixed $items Raw attribute list. * @return array */ function vasp_wc_catalog_sort_hash_attribute_list($items): array { $items = is_array($items) ? array_values($items) : []; foreach ($items as $index => $item) { if (is_array($item) && array_key_exists('options', $item)) { $item['options'] = vasp_wc_catalog_sort_hash_id_list($item['options']); $items[$index] = $item; } } return vasp_wc_catalog_sort_hash_payload_list($items, ['externalId', 'slug', 'name']); } /** * Sort associative arrays recursively so hashes are stable. * * @param mixed $value Value to sort. * @return mixed */ function vasp_wc_catalog_sort_recursive($value) { if (!is_array($value)) { return $value; } $is_list = array_keys($value) === range(0, count($value) - 1); if (!$is_list) { ksort($value); } foreach ($value as $key => $child) { $value[$key] = vasp_wc_catalog_sort_recursive($child); } return $value; }