<?php
/**
 * Safe WooCommerce order edit URL resolver.
 *
 * @package Kayvandra\MarginBeacon
 */

declare(strict_types=1);

namespace Kayvandra\MarginBeacon\Admin\Orders;

/**
 * Resolves an admin edit URL only for order objects that expose one.
 *
 * WooCommerce refund objects may be returned by wc_get_order() but do not
 * implement get_edit_order_url(). Callers must therefore fail closed instead
 * of assuming every WC order-like object is directly editable.
 */
final class OrderEditUrlResolver {

	/**
	 * Resolve from an order ID.
	 *
	 * @param int $order_id Order ID.
	 * @return string
	 */
	public static function from_order_id( $order_id ) {
		$order_id = (int) $order_id;
		if ( $order_id <= 0 || ! function_exists( 'wc_get_order' ) ) {
			return '';
		}

		return self::from_order( wc_get_order( $order_id ) );
	}

	/**
	 * Resolve from a WooCommerce order-like object.
	 *
	 * @param mixed $order Order-like object.
	 * @return string
	 */
	public static function from_order( $order ) {
		if ( ! is_object( $order ) || ! is_callable( array( $order, 'get_edit_order_url' ) ) ) {
			return '';
		}

		$url = $order->get_edit_order_url();
		return is_string( $url ) ? $url : '';
	}
}