<?php
/**
 * Upgrade links (no remote calls).
 *
 * @package Extrova
 */

declare( strict_types=1 );

namespace Extrova\Admin;

defined( 'ABSPATH' ) || exit;

/**
 * Builds local upgrade URLs and tells whether the Pro add-on is active. Upsells only appear
 * on the plugin's own screen and in its row on the Plugins screen (spec §3.3, architecture §8.2).
 *
 * @since 1.0.0
 */
final class Upsell {

	/**
	 * Pro checkout page (Freemius, product 44774, plan Pro). A plain link: nothing is loaded or
	 * sent until the store owner clicks it.
	 */
	public const BASE_URL = 'https://checkout.freemius.com/plugin/44774/plan/78911/';

	/**
	 * Whether the Pro add-on is active (it returns true through the filter).
	 */
	public function is_pro_active(): bool {
		/**
		 * Filters whether the Pro add-on is active. When true every upsell is hidden.
		 *
		 * @since 1.0.0
		 *
		 * @param bool $active Active.
		 */
		return (bool) apply_filters( 'extrova_is_pro_active', false );
	}

	/**
	 * Upgrade URL for a placement, with local UTM parameters.
	 *
	 * @param string $placement `plugins_row`, `pro_tab`, `rules`, `analytics`, `welcome`.
	 */
	public function url( string $placement ): string {
		$url = add_query_arg(
			array(
				'utm_source'   => 'plugin',
				'utm_medium'   => 'lite',
				'utm_campaign' => 'extrova',
				'utm_content'  => sanitize_key( $placement ),
			),
			self::BASE_URL
		);

		/**
		 * Filters the upgrade URL.
		 *
		 * @since 1.0.0
		 *
		 * @param string $url       URL.
		 * @param string $placement Placement.
		 */
		return esc_url_raw( (string) apply_filters( 'extrova_upgrade_url', $url, $placement ) );
	}
}