<?php

namespace WPForms\Admin\Dashboard;

use WPForms\Integrations\Stripe\Helpers as StripeHelpers;
use WPForms\Integrations\Square\Helpers as SquareHelpers;
use WPForms\Integrations\PayPalCommerce\Connection as PayPalCommerceConnection;
use WPFormsAuthorizeNet\Helpers as AuthorizeNetHelpers;
use WPFormsMercadoPago\Helpers as MercadoPagoHelpers;
use WPFormsPaystack\Helpers as PaystackHelpers;

/**
 * Dashboard shared helpers.
 *
 * @since 2.0.2
 */
class Helpers {

	/**
	 * Get the current user's meta value guaranteed to be an array.
	 *
	 * @since 2.0.2
	 *
	 * @param string $key Meta key.
	 *
	 * @return array
	 */
	public static function get_user_meta_array( string $key ): array {

		$value = get_user_meta( get_current_user_id(), $key, true );

		return is_array( $value ) ? $value : [];
	}

	/**
	 * Update the current user's meta with an array value.
	 *
	 * @since 2.0.2
	 *
	 * @param string $key   Meta key.
	 * @param array  $value Meta value.
	 */
	public static function update_user_meta_array( string $key, array $value ): void {

		update_user_meta( get_current_user_id(), $key, $value );
	}

	/**
	 * Whether any supported payment gateway is connected.
	 *
	 * @since 2.0.2
	 *
	 * @return bool
	 */
	public static function is_payment_gateway_connected(): bool {

		$paypal_connection = PayPalCommerceConnection::get();

		return StripeHelpers::has_stripe_keys()
			|| SquareHelpers::is_square_configured()
			|| ( $paypal_connection && $paypal_connection->is_configured() )
			|| ( class_exists( AuthorizeNetHelpers::class ) && AuthorizeNetHelpers::has_authorize_net_keys() )
			|| ( class_exists( MercadoPagoHelpers::class ) && MercadoPagoHelpers::is_configured() )
			|| ( class_exists( PaystackHelpers::class ) && PaystackHelpers::is_configured() );
	}

	/**
	 * Whether the request asks for a forced cache recompute via `force-check=1`.
	 *
	 * Read from GET on a page load and from POST on the date-range AJAX call, so a
	 * force-checked page view keeps recomputing while the flag stays in the URL.
	 *
	 * @since 2.0.2
	 *
	 * @return bool
	 */
	public static function is_force_refresh(): bool {

		// No nonce check by design: the flag only re-derives data the user is already
		// looking at, mirroring WP core's `force-check` on the updates screen. The
		// capability check below is what gates the recompute.
		// phpcs:disable WordPress.Security.NonceVerification.Recommended, WordPress.Security.NonceVerification.Missing
		$force_check = isset( $_GET['force-check'] )
			? absint( $_GET['force-check'] )
			: absint( $_POST['force-check'] ?? 0 );
		// phpcs:enable WordPress.Security.NonceVerification.Recommended, WordPress.Security.NonceVerification.Missing

		return $force_check === 1 && current_user_can( wpforms_get_capability_manage_options() );
	}
}