<?php
/**
 * Optional Pro add-on notice on the workflow builder (WordPress.org Guideline 5 + 11).
 *
 * Shown only on this plugin’s Create/Edit Workflow screen. Not a site-wide admin
 * notice, not trialware, and hidden when the Pro add-on is active or the user dismisses it.
 *
 * @package AfroIT_Messaging_WorkflowAutomations
 */

namespace AfroIT\Messaging\WorkflowAutomations\Admin;

use AfroIT\Messaging\WorkflowAutomations\Admin\Hub\HubPage;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

final class ProUpgrade {

	public const USER_META = 'afromewo_dismiss_pro_upgrade';

	public const DEFAULT_FEATURES_URL = 'https://messaging-workflows.com/pro/';

	/**
	 * Whether to show Pro information on this plugin’s screens.
	 *
	 * @param bool $respect_dismiss When true, honor per-user dismiss on the builder notice.
	 * @return bool
	 */
	public static function should_show( bool $respect_dismiss = true ): bool {
		if ( ! current_user_can( 'manage_woocommerce' ) ) {
			return false;
		}

		if ( defined( 'AFROMEWO_PRO_VERSION' ) ) {
			return false;
		}

		if ( $respect_dismiss && get_user_meta( get_current_user_id(), self::USER_META, true ) ) {
			return false;
		}

		/**
		 * Whether to show the optional Pro add-on information on this plugin’s screens.
		 *
		 * @param bool $show             Whether to show the notice.
		 * @param bool $respect_dismiss  Whether this call honors the builder dismiss flag.
		 */
		return (bool) apply_filters( 'afromewo_show_pro_upgrade', true, $respect_dismiss );
	}

	/**
	 * Public page describing Pro features (no referral tracking).
	 *
	 * @return string
	 */
	public static function features_url(): string {
		$url = defined( 'AFROMEWO_PLUGIN_PRO_LINK' ) ? AFROMEWO_PLUGIN_PRO_LINK : self::DEFAULT_FEATURES_URL;

		/**
		 * URL of the Pro features page.
		 *
		 * @param string $url Features URL.
		 */
		$filtered = apply_filters( 'afromewo_pro_features_url', $url );

		return esc_url_raw( is_string( $filtered ) && '' !== $filtered ? $filtered : self::DEFAULT_FEATURES_URL );
	}

	/**
	 * Dismiss URL that returns to the current workflow builder screen.
	 *
	 * @param int $workflow_id Workflow id when editing, else 0.
	 * @return string
	 */
	public static function dismiss_url( int $workflow_id = 0 ): string {
		$args = array(
			'action' => 'afromewo_dismiss_pro_upgrade',
		);
		if ( $workflow_id > 0 ) {
			$args['workflow_id'] = $workflow_id;
		}

		return wp_nonce_url( add_query_arg( $args, admin_url( 'admin-post.php' ) ), 'afromewo_dismiss_pro_upgrade' );
	}

	/**
	 * Persist dismissal for the current user.
	 *
	 * @return void
	 */
	public static function dismiss_for_current_user(): void {
		update_user_meta( get_current_user_id(), self::USER_META, '1' );
	}

	/**
	 * Redirect target after dismiss.
	 *
	 * @param int $workflow_id Workflow id when editing.
	 * @return string
	 */
	public static function builder_url( int $workflow_id = 0 ): string {
		$args = array( 'tab' => 'create_automation' );
		if ( $workflow_id > 0 ) {
			$args['workflow_id'] = $workflow_id;
		}

		return HubPage::url( $args );
	}
}