\WP_Stager_Integration\Event::get_main_image_url(array $event): string

Full Code

/**
 * Gets the main image URL from event media.
 *
 * Prefers the mainImage object; falls back to deprecated mainImageUrl.
 *
 * @param array $event Raw Stager event data.
 *
 * @return string
 */
public static function get_main_image_url( $event ) {

    // Type casting
    $event = (array) $event;

    // Get data
    $media      = (array) ( $event[ 'media' ] ?? array());
    $main_image = (array) ( $media[ 'mainImage' ] ?? array() );
    $url        = (string) ($main_image[ 'url' ] ?? $media[ 'mainImageUrl' ] ?? '');

    return $url;
}