<?php
namespace JVBase\integrations;

use JVBase\managers\Cache;
use JVBase\managers\IconsManager;

if (!defined('ABSPATH')) {
	exit;
}

trait _Base {
	/**
	 * @var string Unique identifier for this service (ex: square, facebook)
	 */
	protected string $service_name;
	/**
	 * @var int|null The user context. If it is an OAuth integration, users may have their own connections, accessible via their user id
	 */
	protected ?int $userID = null;
	/**
	 * @var string Human-readable service name (ex: 'Google My Business', 'Square', etc)
	 */
	public string $title;
	/**
	 * @var string Phosphoricons icon slug
	 */
	public string $icon = '';
	/**
	 * @var string API version string (ex: 'v2', '2024-01-01')
	 */
	protected string $apiVersion;
	protected Cache $cache;
	//Use Trait "Requests" to set this
	protected bool $hasRequests = false;
	protected ?RateLimits $requestLimiter = null;
	//Use Trait "OAuth" to set this
	protected ?RateLimits $oauthLimiter = null;
	protected bool $hasOAuth = false;
	//Use trait "Webhooks" to set this true
	protected bool $hasWebhooks = false;

	/**
	 * @var array Each item in the array becomes a li element in the ordered list of instructions
	 */
	protected array $instructions = [];
	/**
	 * @var array The required fields for the credentials. Typically a site_key/secret_key or equivalent.
	 */
	protected array $credentialFields = [];
	/**
	 * @var array The required fields for OAuth connection
	 */
	protected array $oauthFields = [];
	/**
	 * @var array Optional fields that just tweak functionality
	 */
	protected array $optionalFields = [];
	protected bool $supportsWebp = true;
	/**
	 * @var bool Flag to indicate there are extra options that warrant a dedicated options page for this service
	 * Usually used for default field values for syncable services
	 */
	public bool $hasExtraOptions = false;


	/**
	 * Check if integration is properly configured
	 */
	public function isSetUp(): bool
	{
		return !empty($this->loadCredentials());
	}

	public function loadCredentials():array
	{
		return Auth::getInstance()->getCredentials($this->service_name, $this->userID);
	}

	protected function logError(string $method, string $message, array $context = []):void
	{
		$context['service'] = $this->service_name;
		JVB()->error()->log('['.self::class.']'.$method, $message, $context);
	}

	protected function getReturnURL():string
	{
		//If we are on the main admin page, we want to go back to our Integrations page on admin
		//If we are on the custom dashboard, we want to go back to that dashboard page
		return is_admin() ?
			admin_url('admin.php?page=jvb-integrations') :
			get_home_url(null, '/dash/integrations/');
	}
	protected function determineOptionPage():string
	{
		return is_admin() ?
			admin_url('admin.php?page=jvb-integrations-'.$this->service_name) :
			get_home_url(null, '/dash/integrations/'.$this->service_name.'/');
	}

	protected function outputIcon(string $icon):string
	{
		if (is_admin()) {
			$icons = IconsManager::for('admin');
			return $icons->getRawSvg($icon);
		}
		return jvbDashIcon($icon);
	}
}