<?php
/**
 * Read-through upgrade from pre-0.4.30 storage; new writes use courierapp_.
 * Native WooCommerce metadata APIs retain HPOS compatibility. No order is
 * resubmitted, no network request is made and no catalogue batch is started.
 */
defined('ABSPATH') || exit;

function courierapp_compat_legacy_key($key) {
 if (!is_string($key)) return $key;
 if (str_starts_with($key, '_courierapp_')) return '_ca_' . substr($key, 12);
 if (str_starts_with($key, 'courierapp_')) return 'ca_' . substr($key, 11);
 return $key;
}
function courierapp_compat_get_option($key, $default = false) {
 $missing = new stdClass(); $value = get_option($key, $missing);
 if ($value !== $missing) return $value;
 $old = courierapp_compat_legacy_key($key);
 if ($old === $key) return $default;
 $value = get_option($old, $missing);
 if ($value === $missing) return $default;
 // add_option is atomic. A concurrently saved new value always wins.
 if (add_option($key, $value, '', false)) delete_option($old);
 return get_option($key, $value);
}
function courierapp_compat_update_option($key, $value, $autoload = null) {
 $result = update_option($key, $value, $autoload);
 if ($result || get_option($key, new stdClass()) === $value) {
  $old = courierapp_compat_legacy_key($key); if ($old !== $key) delete_option($old);
 }
 return $result;
}
function courierapp_compat_add_option($key, $value = '', $deprecated = '', $autoload = null) {
 $missing = new stdClass();
 if (courierapp_compat_get_option($key, $missing) !== $missing) return false;
 return add_option($key, $value, '', $autoload);
}
function courierapp_compat_delete_option($key) {
 $result = delete_option($key); $old = courierapp_compat_legacy_key($key);
 if ($old !== $key) $result = delete_option($old) || $result;
 return $result;
}
function courierapp_compat_get_transient($key) {
 $value = get_transient($key); $old = courierapp_compat_legacy_key($key);
 return $value === false && $old !== $key ? get_transient($old) : $value;
}
function courierapp_compat_set_transient($key, $value, $expiration = 0) {
 $result = set_transient($key, $value, $expiration);
 if ($result) { $old = courierapp_compat_legacy_key($key); if ($old !== $key) delete_transient($old); }
 return $result;
}
function courierapp_compat_delete_transient($key) {
 $result = delete_transient($key); $old = courierapp_compat_legacy_key($key);
 if ($old !== $key) $result = delete_transient($old) || $result;
 return $result;
}
function courierapp_compat_get_post_meta($id, $key = '', $single = false) {
 $old = courierapp_compat_legacy_key($key);
 return get_post_meta($id, $old !== $key && !metadata_exists('post', $id, $key) ? $old : $key, $single);
}
function courierapp_compat_update_post_meta($id, $key, $value, $previous = '') {
 $result = update_post_meta($id, $key, $value, $previous);
 // An older queue value must not resurface after an accepted correction.
 if ($result || get_post_meta($id, $key, true) === $value) {
  $old = courierapp_compat_legacy_key($key); if ($old !== $key) delete_post_meta($id, $old);
 }
 return $result;
}
function courierapp_compat_delete_post_meta($id, $key, $value = '') {
 $result = delete_post_meta($id, $key, $value); $old = courierapp_compat_legacy_key($key);
 if ($old !== $key) $result = delete_post_meta($id, $old, $value) || $result;
 return $result;
}
function courierapp_compat_get_meta($object, $key, $single = true, $context = 'view') {
 $old = courierapp_compat_legacy_key($key);
 $exists = method_exists($object, 'meta_exists') ? $object->meta_exists($key) : $object->get_meta($key, $single, $context) !== '';
 return $object->get_meta($old !== $key && !$exists ? $old : $key, $single, $context);
}
function courierapp_compat_query_args($args) {
 $key = $args['meta_key'] ?? ''; $old = courierapp_compat_legacy_key($key);
 if ($old === $key) return $args;
 $clause = ['key' => $key, 'compare' => $args['meta_compare'] ?? '='];
 if (isset($args['meta_value'])) $clause['value'] = $args['meta_value'];
 $legacy = $clause; $legacy['key'] = $old;
 $args['meta_query'] = ['relation' => 'OR', $clause, ['relation' => 'AND', ['key' => $key, 'compare' => 'NOT EXISTS'], $legacy]];
 unset($args['meta_key'], $args['meta_value'], $args['meta_compare']);
 return $args;
}
// Compatibility routes for work scheduled before the namespace upgrade only.
// Newly scheduled work uses courierapp_; old jobs must not disappear or repeat.
foreach (['connect_paid_order', 'connect_refresh_order', 'ai_catalog_tick'] as $courierapp_legacy_hook) {
 add_action('ca_' . $courierapp_legacy_hook, static function (...$args) use ($courierapp_legacy_hook) {
  do_action('courierapp_' . $courierapp_legacy_hook, ...$args);
 }, 10, 10);
}